转化调整

使用 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 相同。
• 与原始事件相同的目标和转化操作。
• 您要调整的字段的更新值。

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

如需详细了解如何发送提取请求，请参阅发送事件。

支持的字段

下表列出了您可以调整的字段以及更新的适用方式：

字段	行为
conversionValue、currency	被覆盖。新值会替换记录的值。
userData	如果原始事件没有用户数据，则为补充；否则为忽略。
所有其他字段，例如 adIdentifiers.gclid	已忽略

转化价值

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

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

用户数据

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

• 缺失时补充：如果捕获的原始事件不包含用户数据，调整会附加用户数据以改进归因。

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

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

其他字段

对于匹配的事件，除了转化价值、币种和用户数据之外的标识符和元数据（例如 adIdentifiers.gclid）无法更新。Google Ads 会忽略这些字段，并保留原始事件中记录的值。

未匹配的活动

如果 transactionId 与现有事件不匹配，则相应请求会被视为新的转化上传，而不是调整。

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

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