이전 Search Ads 360 Reporting API의 지원이 종료되며 2024년 6월 30일에 사용 중단됩니다. Search Ads 360 Conversion API는 영향을 받지 않으며 계속 지원됩니다. 모든 보고 개발에서는 새 Search Ads 360 Reporting API를 사용해야 합니다.

2024년 4월부터 보고서를 요청할 때 지원되지 않는 APIVersion 오류가 반환됩니다. 자세한 내용은 여기를 참조하세요.

또한 기존 Search Ads 360 구현을 새 API로 이전하는 것이 좋습니다. 자세한 내용은 새 Search Ads 360 Reporting API 시작하기 및 이전 가이드를 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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에서 플러드라이트 활동 배치의 가용성을 업데이트합니다.