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

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "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,000만 회) 쓰기 가능
conversion[].segmentationId long 숫자로 된 분류 기준 식별자입니다 (예: DoubleClick Search 플러드라이트 활동 ID).
conversion[].segmentationName string 친숙한 분류 기준 식별자입니다 (예: DoubleClick Search 플러드라이트 활동 이름).
conversion[].segmentationType string 이 전환의 세분화 유형입니다 (예: FLOODLIGHT).

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "FLOODLIGHT"
conversion[].state string 전환 상태로, ACTIVE 또는 REMOVED입니다. 참고: DELETED 상태는 지원 중단되었습니다.

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "ACTIVE"
  • "DELETED":  (지원 중단됨)
  • "REMOVED"
 쓰기 가능
conversion[].storeId string 제품이 광고된 오프라인 매장의 ID입니다. 채널이 'local'인 경우에만 적용됩니다.
conversion[].type string 전환 유형으로, ACTION 또는 TRANSACTION입니다. ACTION 전환은 금전적으로 수량화할 수 있는 가치가 없는 사용자의 액션인 반면, TRANSACTION 전환은 금전적으로 수량화할 수 있는 가치가 있는 액션입니다. 예를 들어 이메일 목록 가입 (ACTION)과 전자상거래 구매 (TRANSACTION)가 있습니다.

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "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에서 플러드라이트 활동 배치의 가용성을 업데이트합니다.