从 Google Ads API 升级

将转化数据上传方式从 Google Ads API 升级到 Data Manager API，即可获享多项改进和功能。

以下是使用 Data Manager API 和 Google Ads API 管理转化的对比。

Data Manager API Google Ads API
支持发送线下转化数据和增强型潜在客户转化数据 支持。 支持。
支持将 Google Ads 代码转化作为代码转化的额外数据源发送，以最大限度地增加广告互动信号，并强化您的数据和整体效果 支持。 不受支持。
数据模型 适用于所有 Google Ads 转化用例和所有 Google 广告产品的统一数据模型。 数据模型仅适用于 Google Ads 用例，并且因用例而异。
加密 支持加密。 不受支持。
开发者令牌 非必需。 必填。
支持上传事件的会话属性和 IP 地址 面向所有 API 用户开放。 仅适用于特定 API 用户。
转化调整 在统一的 IngestEvents 方法中受支持。 需要单独的 ConversionAdjustmentUploadService。
配额和限制 基于项目的配额和每次请求限制。 基于开发者令牌的配额和每次请求限制。
错误模型 使用快速失败模型。 使用部分失败模型。

目标账号要求方面的差异

在 Data Manager API 中，目标的 operating_account 必须是 Google Ads 转化客户。这与 Google Ads API 不同。

Google Ads API 支持使用以下任一账号的 customer_id 为 Google Ads 账号发送转化数据：

  1. Google Ads 转化客户。

    Data Manager API 支持此方法。

  2. Google Ads 转化客户的任何父级或下级账号。

    Data Manager API 不支持此方法。如果您在 Google Ads API 中使用此行为，请将每个目标的 operating_account 更改为转化操作的所有者。这可能与您在 Google Ads API 请求中使用的 customer_id 不同。

转化调整

Data Manager API 将初始转化上传和后续转化调整统一到单一方法中。

在 Google Ads API 中：

  • 调整转化需要使用 ConversionAdjustmentUploadService 中的单独 UploadConversionAdjustments 方法。
  • 如果您尝试使用标准 UploadClickConversions 方法为具有相同交易 ID (order_id) 的同一转化操作上传多次转化，请求将会失败。
  • 您必须在请求中指定 ConversionAdjustmentType。

在 Data Manager API 中：

  • 转化上传和调整使用统一的 IngestEvents 端点。
  • 如果上传的事件具有与同一转化操作相同的现有 transaction_id，且包含更新后的转化价值或用户数据，则系统会自动将其作为调整项进行处理。API 不会返回重复交易 ID 错误。
  • 请求中无需指定调整类型。Data Manager API 会根据事件中提供的字段推断如何处理调整。
  • 与 Google Ads API 不同，Data Manager API 不支持转化撤消，即通过将转化价值和转化次数设置为 0 来完全移除之前记录的转化。您可以重报转化价值，但转化次数将保持不变。

如需了解详情，请参阅转化调整。

下一页
升级步骤