新版 Search Ads 360 的 ID 映射

新版 Search Ads 360 Reporting API 现已发布。这个新 API 让您可以更灵活地生成自定义报告，并将数据整合到您的报告应用和流程中。您可以详细了解如何迁移到和使用新版 Search Ads 360 Reporting API。

新版 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 全球 是