新版 Search Ads

新版 Search Ads 360 会为用户帐号、广告系列、广告组、关键字(条件)和广告分配新 ID。这些 ID 还有另外两项行为变更:

  • 新版 Search Ads 360 会为经理帐号、子级经理帐号和客户帐号(分别称为代理机构、广告客户和引擎帐号)分配一个全局唯一的客户 ID。

  • 新版 Search Ads 360 不再为关键字和广告分配唯一 ID。

现在,只要接受代理机构 ID、广告客户 ID 和引擎帐号 ID,Conversion API 就会接受新的 Search Ads 360 客户 ID。如果您指定了客户 API,该 API 会要求广告系列 ID、广告组 ID、关键字 ID 和广告 ID 为新的 Search Ads 360 ID。 在使用新的 Search Ads 360 关键字或广告 ID 时,只要您的请求使用关键字或广告 ID,您就必须指定关联的广告系列和广告组 ID。

如果您在请求中使用新的 Search Ads 360 ID,响应也将使用新的 Search Ads 360 ID。

列出转化

使用新 Search Ads 360 ID 的列表请求有了一个新的端点。您需要提供客户帐号的客户 ID。此外,您仍然可以指定要在查询参数中列出的广告系列 ID 和广告组 ID。并且仍需使用 endDaterowCountstartDatestartRow

HTTP 请求

GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion

插入/更新转化

我们支持使用新版 Search Ads 360 ID 提出以下请求:

  • 将转化归因于关键字和广告
  • 仅将转化归因于关键字
  • 使用指定的转化 criterionId(关键字 ID)更新转化

端点仍然相同。您应在每项转化资源中提供新的 Search Ads 360 ID:不应设置 agencyIdadvertiserIdengineAccountId,而应提供 customerId,并在必要时在 campaignIdadGroupIdcriterionIdadId 中使用新的 Search Ads 360 ID。

以下示例请求展示了如何使用新版 Search Ads 360 ID 将转化归因于关键字。

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
{
  "conversion" : [
    {
      "customerId": "123-123-1234"
      "campaignId": "10000001",
      "adGroupId": "20000001",
      "criterionId": "30000001",
      "conversionId": "floodlight conversion ID 1",
      "conversionTimestamp": "1660799917714",
      "type": "ACTION",
      "quantityMillis": "1000",
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test"
    }
  ]
}
    

指定库存状况

您还可以在 Conversion.updateAvailability() 方法中使用新版 Search Ads 360 ID。您必须使用子级经理客户 ID。示例如下:

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
{
  "availabilities": [
    {
      "customerId": "123-123-1234"
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test",
      "availabilityTimestamp": "1389348800000"
    }
  ]
}