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,
      "sessionAttributesEncoded": bytes
    }
  ]
}
속성 이름 값 설명 참고
conversion[] list 요청된 전환입니다.
conversion[].adGroupId long DS 광고 그룹 ID입니다.
conversion[].adId long DS 광고 ID
conversion[].adUserDataConsent string 설정의 핵심 플랫폼 서비스 (CPS) 환경설정에 대한 동의를 나타냅니다. 기본값은 없습니다. 허용되는 값은 다음과 같습니다. GRANTED: 원하는 동의 상태가 동의하는 것입니다. GTE 설정에서 CPS 환경설정을 읽습니다. 거부됨: 원하는 동의 상태가 거부입니다. CPS 목록이 비어 있습니다.

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

허용되는 값은 다음과 같습니다.
  • "FLOODLIGHT"
conversion[].sessionAttributesEncoded bytes 이벤트의 세션 속성으로, base64로 인코딩된 JSON 문자열로 표시됩니다. 콘텐츠는 Google에서 제공하는 라이브러리로 생성되어야 합니다.
conversion[].state string 전환 상태입니다(ACTIVE 또는 REMOVED). 참고: 삭제된 상태는 지원 중단되었습니다.

허용되는 값은 다음과 같습니다.
  • "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에서 일괄 플러드라이트 활동의 사용 가능 여부를 업데이트합니다.