전환 리소스에는 사용자가 플러드라이트 전환을 일괄적으로 생성, 수정, 검색할 수 있는 메서드가 있습니다.
이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.
리소스 표현
전환 목록입니다.
{
"kind": "doubleclicksearch#conversionList",
"conversion": [
{
"agencyId": long,
"advertiserId": long,
"engineAccountId": long,
"campaignId": long,
"customerId": string,
"adGroupId": long,
"criterionId": long,
"adId": long,
"clickId": string,
"dsConversionId": long,
"conversionId": string,
"state": string,
"type": string,
"revenueMicros": long,
"currencyCode": string,
"quantityMillis": long,
"segmentationType": string,
"segmentationId": long,
"segmentationName": string,
"conversionTimestamp": unsigned long,
"conversionModifiedTimestamp": unsigned long,
"floodlightOrderId": string,
"customMetric": [
{
"name": string,
"value": double
}
],
"customDimension": [
{
"name": string,
"value": string
}
],
"countMillis": long,
"attributionModel": string,
"productGroupId": long,
"inventoryAccountId": long,
"productId": string,
"productCountry": string,
"productLanguage": string,
"channel": string,
"storeId": string,
"deviceType": string,
"adUserDataConsent": string,
"sessionAttributesEncoded": bytes
}
]
}| 속성 이름 | 값 | 설명 | 참고 |
|---|---|---|---|
conversion[] |
list |
요청된 전환입니다. | |
conversion[].adGroupId |
long |
DS 광고 그룹 ID입니다. | |
conversion[].adId |
long |
DS 광고 ID | |
conversion[].adUserDataConsent |
string |
설정의 핵심 플랫폼 서비스 (CPS) 환경설정에 대한 동의를 나타냅니다. 기본값은 없습니다. 허용되는 값은 다음과 같습니다. GRANTED: 원하는 동의 상태가 동의하는 것입니다. GTE 설정에서 CPS 환경설정을 읽습니다. 거부됨: 원하는 동의 상태가 거부입니다. CPS 목록이 비어 있습니다.
허용되는 값은 다음과 같습니다.
|
|
conversion[].advertiserId |
long |
DS 광고주 ID | |
conversion[].agencyId |
long |
DS 대행사 ID입니다. | |
conversion[].attributionModel |
string |
DoubleClick Search 고객 지원팀에 문의한 후에만 광고주가 사용할 수 있습니다. | |
conversion[].campaignId |
long |
DS 캠페인 ID입니다. | |
conversion[].channel |
string |
제품의 판매 채널입니다. 허용되는 값은 다음과 같습니다.
|
|
conversion[].clickId |
string |
전환의 DS 클릭 ID입니다. | |
conversion[].conversionId |
string |
오프라인 전환의 경우 광고주가 이 ID를 제공합니다. 광고주는 의미 있는 ID를 지정할 수 있습니다. 요청의 각 전환은 고유한 ID를 지정해야 하며 ID와 타임스탬프의 조합은 광고주 내의 모든 전환에서 고유해야 합니다. 온라인 전환의 경우 DS는 광고주의 플러드라이트 지침에 따라 dsConversionId 또는 floodlightOrderId를 이 속성에 복사합니다. |
|
conversion[].conversionModifiedTimestamp |
unsigned long |
전환이 마지막으로 수정된 시간(UTC 에포크 밀리초)입니다. | |
conversion[].conversionTimestamp |
unsigned long |
전환이 발생한 시간(UTC 에포크 밀리초)입니다. | |
conversion[].countMillis |
long |
DoubleClick Search 고객 지원팀에 문의한 후에만 광고주가 사용할 수 있습니다. | |
conversion[].criterionId |
long |
DS 기준 (키워드) ID입니다. | |
conversion[].currencyCode |
string |
전환 수익의 통화 코드입니다. ISO 4217 알파벳 (영문 기준 3자) 형식이어야 합니다. | 쓰기 가능 |
conversion[].customDimension[] |
list |
보고서에서 데이터를 필터링하는 데 사용할 수 있는 전환의 맞춤 측정기준입니다. | |
conversion[].customDimension[].name |
string |
맞춤 측정기준 이름입니다. | |
conversion[].customDimension[].value |
string |
맞춤 측정기준 값입니다. | |
conversion[].customMetric[] |
list |
전환에 대한 맞춤 측정항목입니다. | |
conversion[].customMetric[].name |
string |
맞춤 측정항목 이름입니다. | |
conversion[].customMetric[].value |
double |
맞춤 측정항목 숫자 값입니다. | |
conversion[].customerId |
string |
새 Search Ads 360 고객 ID입니다. 고객 계정이어야 합니다. 이 필드를 설정하면 다른 모든 ID 필드는 새 Search Ads 360 ID로 설정해야 합니다. | |
conversion[].deviceType |
string |
전환이 발생한 기기의 유형입니다.
허용되는 값은 다음과 같습니다.
|
|
conversion[].dsConversionId |
long |
DoubleClick Search에서 각 전환에 대해 생성하는 ID입니다. | |
conversion[].engineAccountId |
long |
DS 엔진 계정 ID입니다. | |
conversion[].floodlightOrderId |
string |
광고주가 전환을 위해 제공한 플러드라이트 주문 ID입니다. | |
conversion[].inventoryAccountId |
long |
DS에서 생성하고 제품이 포함된 인벤토리 계정을 고유하게 식별하는 데 사용하는 ID입니다. | |
conversion[].productCountry |
string |
제품이 포함된 판매자 센터 피드에 등록된 국가입니다. ISO 3166 코드를 사용하여 국가를 지정합니다. | |
conversion[].productGroupId |
long |
DS 제품 그룹 ID입니다. | |
conversion[].productId |
string |
제품 ID (SKU)입니다. | |
conversion[].productLanguage |
string |
제품이 포함된 판매자 센터 피드에 등록된 언어입니다. ISO 639 코드를 사용하여 언어를 지정합니다. | |
conversion[].quantityMillis |
long |
이 전환의 수량(단위: 밀리초)입니다. | 쓰기 가능 |
conversion[].revenueMicros |
long |
이 TRANSACTION 전환의 수익 금액 (마이크로초 단위, 값에 1,000,000을 곱하고 소수점은 생략)입니다. 예를 들어 수익 값을 '10'으로 지정하려면 요청에 '10000000' (1, 000만)을 입력합니다. |
쓰기 가능 |
conversion[].segmentationId |
long |
숫자 세분화 식별자 (예: DoubleClick Search 플러드라이트 활동 ID)입니다. | |
conversion[].segmentationName |
string |
친근한 세분화 식별자 (예: DoubleClick Search 플러드라이트 활동 이름)입니다. | |
conversion[].segmentationType |
string |
이 전환의 세분화 유형입니다 (예: FLOODLIGHT).
허용되는 값은 다음과 같습니다.
|
|
conversion[].sessionAttributesEncoded |
bytes |
이벤트의 세션 속성으로, base64로 인코딩된 JSON 문자열로 표시됩니다. 콘텐츠는 Google에서 제공하는 라이브러리로 생성되어야 합니다. | |
conversion[].state |
string |
전환 상태입니다(ACTIVE 또는 REMOVED). 참고: 삭제된 상태는 지원 중단되었습니다.
허용되는 값은 다음과 같습니다.
|
쓰기 가능 |
conversion[].storeId |
string |
제품이 광고된 오프라인 매장의 ID입니다. 채널이 'local'인 경우에만 적용됩니다. |
|
conversion[].type |
string |
전환 유형입니다(ACTION 또는 TRANSACTION). ACTION 전환은 금전적으로 측정 가능한 가치가 없는 사용자의 액션이고 TRANSACTION 전환은 금전적으로 측정 가능한 가치가 있는 액션입니다. 예를 들어 이메일 목록 가입 (ACTION)과 전자상거래 구매 (TRANSACTION)를 들 수 있습니다.
허용되는 값은 다음과 같습니다.
|
|
kind |
string |
ConversionList 리소스로 식별합니다. 값은 고정 문자열 doubleclicksearch#conversionList입니다. |
메서드
- get
- DoubleClick Search 엔진 계정에서 전환 목록을 가져옵니다.
- getByCustomerId
- 새 Search Ads 360 고객 ID를 사용하여 DoubleClick Search 엔진 계정에서 전환 목록을 가져옵니다.
- insert
- 새 전환을 일괄적으로 DoubleClick Search에 삽입합니다.
- 업데이트
- DoubleClick Search에서 전환을 일괄 업데이트합니다.
- updateAvailability
- DoubleClick Search에서 일괄 플러드라이트 활동의 사용 가능 여부를 업데이트합니다.