새 Search Ads 360은 사용자 계정, 캠페인, 광고그룹, 키워드 (기준), 광고에 새 ID를 할당합니다. 이러한 ID에는 두 가지 추가 동작 변경사항이 있습니다.
-
새 Search Ads 360에서는 관리자 계정, 하위 관리자 계정, 고객 계정(이전 명칭: 대행사, 광고주, 엔진 계정이라고 함)에 전역적으로 고유한 고객 ID를 할당합니다.
-
새 Search Ads 360은 더 이상 키워드 및 광고에 고유 ID를 할당하지 않습니다.
이제 전환 API에서 대행사 ID, 광고주 ID, 엔진 계정 ID가 허용되는 경우 새 Search Ads 360 고객 ID를 허용합니다. 고객 API를 지정하면 API에서 캠페인 ID, 광고그룹 ID, 키워드 ID, 광고 ID를 새 Search Ads 360 ID로 예상합니다. 새 Search Ads 360 키워드 또는 광고 ID를 사용하는 경우 요청에서 키워드 또는 광고 ID를 사용할 때마다 연결된 캠페인 및 광고그룹 ID를 지정해야 합니다.
요청에 새 Search Ads 360 ID를 사용하면 응답에서도 새 Search Ads 360 ID를 사용합니다.
목록 전환
새 Search Ads 360 ID가 포함된 목록 요청에 대한 새로운 엔드포인트가 있습니다. 고객
계정 고객 ID를 제공해야 합니다. 또한 쿼리 매개변수에 나열할 캠페인 ID 및 광고그룹 ID를
지정할 수도 있습니다. 그리고 endDate, rowCount, startDate, startRow는 여전히 필요합니다.
HTTP 요청
GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion
전환 삽입/업데이트
새 Search Ads 360 ID를 사용하여 다음 요청을 지원합니다.
- 전환 기여도를 키워드 및 광고에 부여
- 키워드에만 전환 기여도 부여
- 전환의
criterionId(키워드 ID)를 지정하여 전환 업데이트
엔드포인트는 여전히 동일합니다. 각 전환 리소스에 새 Search Ads 360 ID를 제공해야 합니다. agencyId, advertiserId, engineAccountId를 설정하는 대신 customerId를 제공하고 필요한 경우 campaignId, adGroupId, criterionId, adId에 새 Search Ads 360 ID를 사용해야 합니다.
다음은 새 Search Ads 360 ID를 사용하여 키워드에 전환 기여도를 부여하는 방법을 보여주는 요청 예입니다.
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
{
"conversion" : [
{
"customerId": "123-123-1234"
"campaignId": "10000001",
"adGroupId": "20000001",
"criterionId": "30000001",
"conversionId": "floodlight conversion ID 1",
"conversionTimestamp": "1660799917714",
"type": "ACTION",
"quantityMillis": "1000",
"segmentationType": "FLOODLIGHT",
"segmentationName": "Test"
}
]
}
이용 가능 여부 지정
Conversion.updateAvailability()
메서드에서 새 Search Ads 360 ID를
사용할 수도 있습니다. 하위 관리자 고객 ID를 사용해야 합니다. 예를 들면 다음과 같습니다.
POST https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
{
"availabilities": [
{
"customerId": "123-123-1234"
"segmentationType": "FLOODLIGHT",
"segmentationName": "Test",
"availabilityTimestamp": "1389348800000"
}
]
}