新版 Search Ads 360 的 ID 映射

新版 Search Ads 360 Reporting API 现已发布。这一新 API 提供 可以更灵活地生成自定义报告并将数据整合到您的报告应用程序中 和进程。详细了解如何迁移到和使用新版 Search Ads 360 报告 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 映射： <ph type="x-smartling-placeholder">。 经理和代理机构的映射不可用。 
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 映射： <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 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 是针对每个广告组分配的，而非针对多个广告组分配的。 下面列出了新版 Search Ads 360 中每个对象 ID 的唯一性。这些 ID 规则可以 在为新的 Search Ads 360 对象设计本地存储时很有用。

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