新版 Search Ads 360 的 ID 映射

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

新版 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"
}
竞选活动 广告系列的 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 映射： 
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 广告的 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"
}

实体缺失的常见原因

虽然广告客户的映射文件将包含其大多数实体，但在某些情况下，仍会缺少实体。以下是造成此现象的一些常见原因：

  • 每个映射文件每 3 天更新一次。如果在创建新实体后立即下载映射文件，该实体可能不会出现在映射文件中。最多等待 3 天后，系统应该会将其包含在内。
  • 该实体所属的账号会被移除。在这种情况下，我们不支持 ID 映射。

下载报告

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