새 Search Ads 360의 항목 ID는 이전 Search Ads 360과 다릅니다.
이전 Search Ads 360과 새 Search Ads 360 간에 ID 매핑을 가져오려면
Reports.getIdMappingFile()
요청을 보냅니다. 응답에는 지정된 광고주의 모든 항목에 대한 ID 매핑이 포함됩니다.
다음은 반환된 파일의 예입니다 (UTF-8로 인코딩된 CSV 형식).
Entity Type,Legacy IDs,New IDs CUSTOMER,"{""agencyId"":""20700000000000125"",""advertiserId"":""2170000012345"",""engineAccountId"":""700000000042205""}","{""customerId"":""200001235""}"
CSV 파일에는 3개의 열이 있습니다.
Entity Type
: 이 행의 항목 유형입니다.Legacy IDs
: 이전 Search Ads 360에 있는 전체 항목 경로의 JSON 문자열New IDs
: 새 Search Ads 360 내 전체 항목 경로의 JSON 문자열
아래 표에는 지원되는 항목 및 ID 매핑의 예시가 나와 있습니다.
항목 유형 | 설명 | 기존 ID | 새 ID |
---|---|---|---|
고객 | ID 매핑 대상: |
advertiser: { "agencyId": "20700000000000125", "advertiserId": "2170000012345" } account: { "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205" } |
{ "customerId": "200001235" } |
캠페인 | 캠페인의 ID 매핑입니다. |
{ "agencyId":"20700000000000125", "advertiserId":"2170000012345", "engineAccountId":"700000000042205", "campaignId":"71700000087192405" } |
{ "customerId": "200001235", "campaignId": "14660344555" } |
AD_GROUP | adGroup의 ID 매핑입니다. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "campaignId": "71700000084761225", "adGroupId": "58700007213529045" } |
{ "customerId": "200001235", "campaignId": "13666840065", "adGroupId": "127701366165" } |
기준 | ID 매핑 대상: |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "campaignId": "71700000068948065", "adGroupId": "58700006123995025", "AdGroupCriterionId": "46700015332504045" } |
{ "customerId": "200001235", "campaignId": "14660344555", "adGroupId":"105138634255", "criterionId":"948710340465" } |
AD | 광고의 ID 매핑입니다. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "campaignId": "71700000065395945", "adGroupId": "58700005797210525", "adId": "44700029299414085" } |
{ "customerId": "200001235", "campaignId": "15314179325", "adGroupId": "131599768485", "adId": "562719339005" } |
CAMPAIGN_CRITERION | ID 매핑 대상: |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "campaignId": "71700000084403015", "campaignTargetId": "38700011011700285" } |
{ "customerId": "200001235", "campaignId": "13467100745", "campaignCriterionId": "2125" } |
CAMPAIGN_GROUP | 캠페인 그룹의 ID 매핑입니다. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "budgetGroupId": "87700002234256082" } |
{ "customerId": "200001235", "campaignGroupId": "1000665659" } |
CAMPAIGN_GROUP_PERFORMANCE_TARGET | 캠페인 그룹 실적 타겟의 ID 매핑입니다. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "budgetGroupId": "87700002234256082", "budgetPlanId": "88700007187391026" } |
{ "customerId": "200001235", "campaignGroupId": "1000665659" "campaignGroupPerformanceTargetId": "7624175" } |
FEED_TABLE | 피드 테이블의 ID 매핑입니다. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "feedTableId": "32700008040329135" } |
{ "customerId": "200001235", "feedId": "207040045" } |
FEED_ITEM | feedItem의 ID 매핑입니다. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "feedTableId": "32700014854183375", "feedItemRowId": "33700014854183415" } |
{ "customerId": "200001235", "feedId": "377982485", "feedItemId": "235028589065" } |
보고서 다운로드
JSON
GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/idmapping?alt=media
Python
def download_mapping_file(service, file_name, agency_id, advertiser_id): """Generate and save mapping file to a csv. Args: service: An authorized Doubleclicksearch service. file_name: Filename to write the ID mapping file. agency_id: DS ID of the agency. advertiser_id: DS ID of the advertiser. """ request = service.reports().getIdMappingFile_media(agencyId=agency_id, advertiserId=advertiser_id) f = open(file_name + '.csv', 'w') f.write(request.execute().decode('utf-8')) f.close()
객체 ID 고유성
새 Search Ads 360의 모든 객체는 고유 ID로 식별됩니다. 이러한 ID 중 일부는 새 Search Ads 360의 모든 계정에서 전역 수준에서 고유하지만 다른 ID는 제한된 범위 내에서만 고유합니다. 예를 들어 광고를 고유하게 식별하려면 광고그룹과 광고 ID를 모두 사용해야 합니다. 광고 ID는 광고그룹별로 고유하게 할당되지만 광고그룹 전체는 할당되지 않기 때문입니다. 새 Search Ads 360 내 각 객체 ID의 고유성은 다음과 같습니다. 이러한 ID 규칙은 새 Search Ads 360 객체의 로컬 저장소를 설계할 때 유용할 수 있습니다.
객체 ID | 고유성 식별 범위 | 글로벌 수준에서 식별 가능 |
---|---|---|
예산 ID | 전 세계 | 지원됨 |
캠페인 ID | 전 세계 | 지원됨 |
AdGroup ID | 전 세계 | 지원됨 |
광고 ID | 광고그룹 | 아니요. (AdGroupId , AdId ) 쌍은 전역적으로 고유합니다. |
AdGroup기준 ID | 광고그룹 | 아니요. (AdGroupId , CriterionId ) 쌍은 전역적으로 고유합니다. |
캠페인 기준 ID | 실행 | 아니요. (CampaignId , CriterionId ) 쌍은 전역적으로 고유합니다. |
광고 확장 | 실행 | 아니요. (CampaignId , AdExtensionId ) 쌍은 전역적으로 고유합니다. |
피드 ID | 글로벌 수준 | 지원됨 |
Feed Item ID | 전 세계 | 지원됨 |
Feed Attribute ID | 피드 | No |
Feed Mapping ID | 전 세계 | 지원됨 |
라벨 ID | 전 세계 | 지원됨 |
사용자 목록 ID | 전 세계 | 지원됨 |