새 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 매핑 대상: <ph type="x-smartling-placeholder">를 통해 개인정보처리방침을 정의할 수 있습니다. 관리자 및 대행사에 대한 매핑은 제공되지 않습니다. |
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 매핑 대상: <ph type="x-smartling-placeholder"> |
adGroupTarget and negativeAdGroupTarget: { "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "campaignId": "71700000068948065", "adGroupId": "58700006123995025", "adGroupTargetId": "46700015332504045" } keyword: { "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "campaignId": "71700000068948065", "adGroupId": "58700006123995025", "criterionId": "46700015332504045" } negativeAdGroupKeyword: { "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "campaignId": "71700000068948065", "adGroupId": "58700006123995025", "negativeAdGroupCriterionId": "46700015332504045" } productGroup: { "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "campaignId": "71700000068948065", "adGroupId": "58700006123995025", "productGroupId": "92700000508010025" } |
{ "customerId": "200001235", "campaignId": "14660344555", "adGroupId":"105138634255", "criterionId":"948710340465" } |
AD | 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 매핑 대상: <ph type="x-smartling-placeholder"> |
{ "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는 광고 그룹별이 아닌 광고 그룹별로 고유하게 할당되므로 광고를 식별할 수 있습니다. 새 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 | 피드 | 아니요 |
Feed Mapping ID | 글로벌 수준 | 예 |
라벨 ID | 전역 | 예 |
사용자 목록 ID | 전역 | 예 |