Conversion

전환 리소스에는 사용자가 플러드라이트 전환을 일괄적으로 생성, 수정, 검색할 수 있는 메서드가 있습니다. 

이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.

리소스 표현

전환 목록입니다.

{
  "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
    }
  ]
}
속성 이름 값 설명 Notes
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 제품의 판매 채널입니다. 사용 가능한 값:
  • "local": 오프라인 상점
  • "online": 온라인 상점
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 전환이 발생한 기기의 유형입니다.

허용되는 값은 다음과 같습니다.
  • "DESKTOP"
  • "HIGH_END_MOBILE"
  • "OTHER_DEVICE"
  • "TABLET"
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 전환의 수익 금액으로, 마이크로 단위 (1000000을 곱한 값, 소수점이 없음)입니다. 예를 들어 수익 값을 '10'으로 지정하려면 요청에 '10000000' (1천만)을 입력합니다. 쓰기 가능
conversion[].segmentationId long 숫자로 된 세분화 식별자 (예: DoubleClick Search 플러드라이트 활동 ID)입니다.
conversion[].segmentationName string 친숙한 세분화 식별자 (예: DoubleClick Search 플러드라이트 활동 이름)
conversion[].segmentationType string 이 전환의 세분화 유형입니다 (예: FLOODLIGHT).

허용되는 값은 다음과 같습니다.
  • "FLOODLIGHT"
conversion[].state string 변환 상태로, ACTIVE 또는 REMOVED입니다. 참고: DELETED 상태는 지원 중단되었습니다.

허용되는 값은 다음과 같습니다.
  • "ACTIVE"
  • "DELETED":  (지원 중단됨)
  • "REMOVED"
 쓰기 가능
conversion[].storeId string 제품을 광고한 오프라인 매장의 ID입니다. 채널이 'local'인 경우에만 적용됩니다.
conversion[].type string 전환의 유형(ACTION 또는 TRANSACTION)입니다. 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에서 일괄 플러드라이트 액티비티의 가용성을 업데이트합니다.