使用 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。请参阅线下转化或多来源转化的事件和标识符要求。
建议您发送与原始事件中发送或捕获的标识符相同的标识符。如果 transactionId 与现有转化不匹配，Google Ads 会使用这些标识符来归因新转化。
您无需指定调整类型。Data Manager API 会根据 transactionId 和您提供的字段推断出如何处理请求。
如需详细了解如何发送注入请求，请参阅有关为线下转化或多来源转化发送事件的指南。
支持的字段
下表列出了当事件与现有转化匹配时，Google Ads 如何应用每个字段：
| 字段 | 行为 |
|---|---|
conversionValue、currency |
被覆盖。新值会替换记录的值。 |
userData |
如果原始事件没有用户数据，则进行补充；否则，系统会忽略。 |
所有其他字段，例如 adIdentifiers.gclid |
未更新。Google Ads 会保留通过原始事件记录的值。必填字段仍必须存在。 |
转化价值
发送新的 conversionValue 和 currency 以重报已记录的转化的价值。新价值会覆盖报告和出价中之前记录的价值，而不会增加转化次数。
用户数据
Google Ads 会以如下方式处理userData，例如电子邮件地址或电话号码：
缺失时补充：如果捕获的原始事件不包含用户数据，调整会附加用户数据以改进归因。
如果存在，则忽略：如果 Google 代码或之前的上传操作已捕获用户数据，则忽略新的用户数据。现有用户数据不会被覆盖或附加。
其他字段
除转化价值、币种和用户数据之外的标识符和元数据（例如 adIdentifiers.gclid）无法针对匹配的事件进行更新。Google Ads 会保留通过原始事件记录的值。
您仍必须包含任何必需的字段，例如至少一个标识符。Data Manager API 会针对每个事件验证这些参数。
未匹配的活动
如果 transactionId 与现有事件不匹配，则相应请求会被视为新的转化上传，而不是调整。
Google Ads 会尝试使用您提供的标识符（例如 adIdentifiers.gclid 或 userData）将新转化归因于广告点击。