新版 Search Ads 360 中的实体与旧版 Search Ads 360 中的 ID 空间不同。
要获取旧版 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" } |
广告系列 | campaign 的 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 | 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 | Feed 表格的 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 和广告 ID 来唯一标识广告,因为广告 ID 只能分配给每个广告组,而不是在广告组之间分配。 下面列出了新版 Search Ads 360 中每个对象 ID 的唯一性。在为新的 Search Ads 360 对象设计本地存储时,这些 ID 规则会很有用。
对象 ID | 唯一性的范围 | 是否在全局级别具有唯一性? |
---|---|---|
预算 ID | 全局 | 是 |
广告系列 ID | 全球 | 是 |
AdGroup ID | 全球 | 是 |
广告 ID | 广告组 | 否。(AdGroupId , AdId ) 对在全局级别具有唯一性。 |
AdGroupCriterion ID | 广告组 | 否。(AdGroupId , CriterionId ) 对在全局级别具有唯一性。 |
CampaignCriterion ID | 广告系列 | 否。(CampaignId , CriterionId ) 对在全局级别具有唯一性。 |
广告附加信息 | 广告系列 | 否。(CampaignId , AdExtensionId ) 对在全局级别具有唯一性。 |
Feed ID | 全局 | 是 |
Feed Item ID | 全球 | 是 |
Feed Attribute ID | Feed | 否 |
Feed Mapping ID | 全球 | 是 |
标签 ID | 全球 | 是 |
用户名单 ID | 全球 | 是 |