从 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 来完全移除该转化。您可以重报转化的价值，但转化次数将保持不变。

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

下一页
升级步骤