转化调整

使用 IngestEvents 方法对之前记录的 Google Ads 广告转化进行调整。在 Data Manager API 中，调整可以重报转化价值或补充用户数据。

如果您要从 Google Ads API 迁移，请参阅从 Google Ads API 升级，比较每个 API 如何处理调整项。

支持的转化类型

您可以调整以下 Google Ads 转化类型：

• 多来源转化：您网站的 Google 代码针对WEBSITE转化操作记录的转化。
• 线下转化和增强型潜在客户转化：之前为UPLOAD_CLICKS转化操作上传的线下事件。

注意： 不支持对实体店销售转化进行调整。

调整项的运作方式

在同一转化操作中，Google Ads 会使用 transactionId 匹配事件：

• 如果 transactionId 与同一转化操作的现有转化匹配，Data Manager API 会将该请求视为转化调整。
• 如果 transactionId 与现有转化不匹配，Google Ads 会创建新转化。请参阅不匹配的事件。

发送调整项

如需调整现有转化，请发送包含以下内容的 IngestEvents 请求：

• 与原始事件相同的 transactionId。
• 与原始事件相同的目标位置和转化操作。
• 要调整的字段的更新值。
• 事件所需的所有字段，包括至少一个标识符，例如 adIdentifiers 或 userData。查看线下转化或多来源转化的事件和标识符要求。

要点： Data Manager API 会在收到请求时验证每个事件，然后再查找匹配的 transactionId。调整必须满足与新事件相同的字段和标识符要求。否则，请求会失败并显示 NO_IDENTIFIERS_PROVIDED 等错误。

我们建议您发送与原始事件一起发送或捕获的相同标识符。如果 transactionId 与现有转化不匹配，Google Ads 会使用这些标识符来归因新转化。

您无需指定调整类型。Data Manager API 会根据 transactionId 和您提供的字段推断如何处理请求。

如需详细了解如何发送提取请求，请参阅有关发送线下转化或多来源转化事件的指南。

支持的字段

下表列出了当事件与现有转化匹配时，Google Ads 如何应用每个字段：

字段	行为
conversionValue、currency	被覆盖。新值会替换记录的值。
userData	如果原始事件没有用户数据，则补充，否则忽略。
所有其他字段，例如 adIdentifiers.gclid	未更新。Google Ads 会保留原始事件记录的值。必填字段仍必须存在。

转化价值

发送新的 conversionValue 和 currency，以重报已记录转化的价值。新值会覆盖报告和出价中之前记录的值，而不会增加转化次数。

注意： 在多来源转化的初始 14 天试用期内，价值更新功能处于停用状态。在试用期结束之前，Google Ads 报告中不会替换该代码的值。

用户数据

以下是 Google Ads 处理userData（例如邮箱或电话号码）的方式：

• 缺失时补充：如果原始事件在捕获时没有用户数据，则调整会附加用户数据，以改进归因。

  注意： 我们建议您在原始事件发生后的 24 小时内上传补充线下数据，以获得最佳优化效果。

• 如果存在，则忽略：如果 Google 代码或之前的上传已捕获用户数据，则系统会忽略新的用户数据。系统不会覆盖或附加到现有用户数据。

其他字段

对于匹配的事件，无法更新转化价值、币种和用户数据以外的标识符和元数据，例如 adIdentifiers.gclid。Google Ads 会保留通过原始事件记录的值。

您仍必须添加这些字段中必需的任何字段，例如至少一个标识符。Data Manager API 会针对每个事件验证这些值。

不匹配的事件

如果 transactionId 与现有事件不匹配，则系统会将该请求视为新转化上传，而不是调整。

Google Ads 会尝试使用您提供的标识符（例如 adIdentifiers.gclid 或 userData）将新转化归因于广告点击。

注意： 在多来源转化的初始 14 天试用期内，新创建的转化会显示在报告中，但不会用于出价。试用期结束后，这些转化会自动变为可出价的转化。