Conversion: insert
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
새 전환 집합을 DoubleClick Search에 일괄 삽입합니다.
지금 사용해 보기
요청
HTTP 요청
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
승인
다음 범위를 사용하여 이 요청을 인증받아야 합니다.
| 범위 |
|---|
https://www.googleapis.com/auth/doubleclicksearch |
자세한 내용은 인증 및 승인 페이지를 참조하세요.
요청 본문
요청 본문에서 다음과 같은 속성을 사용하여 Conversion 리소스를 제공합니다.
| 속성 이름 |
값 |
설명 |
참고 |
| 필수 속성 |
conversion[].conversionId |
string |
오프라인 전환의 경우 광고주가 이 ID를 제공합니다. 광고주는 자신에게 의미 있는 모든 ID를 지정할 수 있습니다. 요청의 각 전환은 고유 ID를 지정해야 하며, ID와 타임스탬프의 조합은 광고주 내의 모든 전환에서 고유해야 합니다.
온라인 전환의 경우 DS는 광고주의 플러드라이트 안내에 따라 dsConversionId 또는 floodlightOrderId를 이 속성으로 복사합니다. |
|
conversion[].conversionTimestamp |
unsigned long |
전환이 발생한 시간으로, 에포크 밀리초(UTC)로 표시됩니다. |
|
conversion[].segmentationType |
string |
이 전환의 세분화 유형입니다 (예: FLOODLIGHT).
사용 가능한 값은 다음과 같습니다.
<ph type="x-smartling-placeholder">
|
|
사용해 보기
아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.
또는 독립형 탐색기를 사용해 보세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-08-20(UTC)
[null,null,["최종 업데이트: 2024-08-20(UTC)"],[[["\u003cp\u003eInserts a batch of new conversions into DoubleClick Search using the provided Conversion resource and requires authorization with the \u003ccode\u003edoubleclicksearch\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eEach conversion requires a unique ID, timestamp, and segmentation type (e.g., FLOODLIGHT).\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests return a Conversion resource in the response body.\u003c/p\u003e\n"],["\u003cp\u003eThe API allows insertion of both offline and online conversions, with specific ID handling for each.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can test the method using the provided APIs Explorer or the standalone Explorer.\u003c/p\u003e\n"]]],["This outlines how to insert new conversions into DoubleClick Search using a POST request to the specified endpoint. Authorization with the `https://www.googleapis.com/auth/doubleclicksearch` scope is required. The request body should include a Conversion resource containing properties like `conversionId` (unique identifier), `conversionTimestamp` (time of conversion in UTC), and `segmentationType` (e.g., `FLOODLIGHT`). Successful requests return a Conversion resource in the response body.\n"],null,["# Conversion: insert\n\n| **Note:** Requires [authorization](#auth).\n\nInserts a batch of new conversions into DoubleClick Search.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/doubleclicksearch/v2/conversion\n```\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/doubleclicksearch` |\n\nFor more information, see the [authentication and authorization](/search-ads/v2/authorizing) page.\n\n### Request body\n\nIn the request body, supply a [Conversion resource](/search-ads/v2/reference/conversion#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|------------------------------------|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| **Required Properties** ||||\n| conversion[].`conversionId` | `string` | For offline conversions, advertisers provide this ID. Advertisers can specify any ID that is meaningful to them. Each conversion in a request must specify a unique ID, and the combination of ID and timestamp must be unique amongst all conversions within the advertiser. For online conversions, DS copies the `dsConversionId` or `floodlightOrderId` into this property depending on the advertiser's Floodlight instructions. | |\n| conversion[].`conversionTimestamp` | `unsigned long` | The time at which the conversion took place, in epoch millis UTC. | |\n| conversion[].`segmentationType` | `string` | The segmentation type of this conversion (for example, `FLOODLIGHT`). \u003cbr /\u003e Acceptable values are: - \"`FLOODLIGHT`\" | |\n\nResponse\n--------\n\nIf successful, this method returns a [Conversion resource](/search-ads/v2/reference/conversion#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/doubleclicksearch/v2/doubleclicksearch.conversion.insert)."]]
