字段映射

使用表格中的映射关系，将 Google Ads API 中的 UploadClickConversionRequest 映射到数据管理器 API 中对应的 IngestEventsRequest。

请求字段

`UploadClickConversionRequest` (Google Ads API)	`IngestEventsRequest`（数据管理器 API）	备注
`customer_id` `developer-token` 请求标头 `login-customer_id` 请求标头 `linked-customer-id` 请求标头 `conversion_action`	`destinations`	请参阅客户和转化操作字段。
无对应报告	`consent`	请求中事件的可选默认同意情况设置。您可以通过设置 `Event` 的 `consent` 字段来替换单个事件的此值。
无对应报告	`encoding`	必需：设置为用于 `UserIdentifier` 值的 `Encoding`。
无对应报告	`encryption_info`	设置请求是否包含加密值。如需了解详情，请参阅加密。
`job_id`	无对应报告	使用响应中返回的 `request_id` 来检索诊断信息。
`partial_failure`	无对应报告	Data Manager API 不支持部分失败。如果 `IngestEventsRequest` 的任何字段未能通过验证，Data Manager API 将拒绝整个请求。
`validate_only`	`validate_only`
`conversions`	`events`	转化或事件列表。如需了解详情，请参阅“转化”字段部分。

客户和转化操作字段

Google Ads API 需要 developer-token 请求标头，您可以根据不同的身份验证场景设置 login-customer-id 和 linked-customer-id 请求标头。

Data Manager API 不需要开发者令牌，您可以使用 Destination 的字段（而不是请求标头）指定登录信息和关联的客户信息。如需详细了解平台，请参阅配置平台。

下面展示了如何将单个 conversion_action 的 Google Ads API 字段映射到 Destination 中的等效字段：

Google Ads API	`Destination`（数据管理器 API）	备注
请求的 `customer_id`	`operating_account`	将 `account_id` 设置为 Google Ads 转化账号的客户 ID。将 `operating_account` 的 `account_type` 设置为 `GOOGLE_ADS`。数据管理器 API 可能需要使用与 Google Ads API 不同的客户 ID。如需了解详情，请参阅目标账号要求方面的差异。
`developer-token` 请求标头	无对应报告	数据管理器 API 不需要开发者令牌。
`login-customer-id` 请求标头	`login_account`	将 `account_id` 设置为登录账号的客户 ID。如果登录账号是 Google Ads 账号，请将 `account_type` 设置为 `GOOGLE_ADS`；如果登录账号是数据合作伙伴账号，请将 `account_type` 设置为 `DATA_PARTNER`。
`linked-customer-id` 请求标头	`linked_account`	将 `account_id` 设置为关联账号的客户 ID。将 `account_type` 设为 `DATA_PARTNER`。
`conversion_action` 的 `ClickConversion`	`product_destination_id`	设置为转化操作的数字 ID。请勿使用 `ConversionAction` 的资源名称。
无对应报告	`reference`	`Destination` 的用户定义标识符。如果您在单个请求中针对多个转化操作发送转化数据，请设置此字段。

转化字段

`ClickConversion` (Google Ads API)	`Event`（数据管理器 API）	备注
`cart_data`	`cart_data`	如需了解详情，请参阅购物车数据字段。
`consent`	`consent`	这两个 API 都使用类似的 `Consent` 对象（`ad_user_data`、`ad_personalization`）。对于 Data Manager API，您还可以通过设置请求级 `consent` 字段来为请求中的所有事件设置意见征求。
`conversion_action`	`destination_references`	如果在单个请求中针对多个转化操作发送转化数据，请将此字段设置为目标的相应 `reference`。
`conversion_date_time`	`event_timestamp`	如果使用 JSON 格式，请将此字段设置为 RFC 3339 格式的值，该格式与 Google Ads API 日期和时间格式略有不同。如果使用 Protocol Buffers，请使用 `Timestamp` 并设置 `seconds` 和（可选）`nanoseconds` 字段。如需了解详情，请参阅时间戳格式。
`conversion_environment`	无对应报告
`conversion_value`	`conversion_value`	设置为币种值，而不是以微为单位的值。例如，如果转化价值为 5.23 美元，请使用值 `5.23`。
`currency_code`	`currency`
`custom_variables`	`custom_variables`	如需了解详情，请参阅自定义变量字段。
`customer_type`
无对应报告	`event_source`
无对应报告	`event_device_info`
`external_attribution_data`	无对应报告
`gbraid`	`ad_identifiers.gbraid`
`gclid`	`ad_identifiers.gclid`
无对应报告	`last_updated_timestamp`
`order_id`	`transaction_id`
`session_attributes_encoded`	`ad_identifiers.session_attributes`	如需了解详情，请参阅添加会话属性。
`session_attributes_key_value_pairs`	`experimental_fields`	如需了解详情，请参阅添加会话属性。
`user_identifiers`	`user_data.user_identifiers`	如需了解详情，请参阅用户标识符字段。
`user_ip_address`	`landing_page_device_info.ip_address`
`wbraid`	`ad_identifiers.wbraid`

购物车数据字段

`CartData` (Google Ads API)	`CartData`（数据管理器 API）	备注
`feed_country_code`	`merchant_feed_label`	设置为 Feed 标签。
`feed_language_code`	`merchant_feed_language_code`
`items`	`items`
`local_transaction_cost`	`transaction_discount`
`merchant_id`	`merchant_id`

购物车数据的商品字段

`Item` (Google Ads API)	`Item`（数据管理器 API）	备注
`product_id`	`merchant_product_id`
`quantity`	`quantity`
`unit_price`	`unit_price`
无对应报告	`item_id`
无对应报告	`additional_item_parameters`

自定义变量字段

`CustomVariable` (Google Ads API)	`CustomVariable`（数据管理器 API）	备注
无对应报告	`destination_references`	Google Ads API 要求每项转化操作都使用单独的请求。Data Manager API 支持在单个请求中针对多个转化操作发送转化，还支持使用 `destination_references` 字段来指明哪些目标平台应接收特定的自定义变量。
`conversion_custom_variable`	`variable`	设置为变量的名称，而不是资源名称。
`value`	`value`

用户标识符字段

`UserIdentifier` (Google Ads API)	`UserIdentifier`（数据管理器 API）
`address_info`	`address`	遵循格式设置和哈希处理指南。您还可以加密地址的哈希属性。
`hashed_email`	`email_address`	设置为经过格式化和哈希处理的电子邮件地址。您还可以加密哈希处理后的电子邮件地址。
`hashed_phone_number`	`phone_number`	设置为已格式化和哈希处理的电话号码。您还可以对哈希处理后的电话号码进行加密。
其他字段： `mobile_id` `third_party_user_id` `user_identifier_source`	不相关	这两种 API 均不支持将这些标识符用于线下转化或增强型潜在客户转化，并且 Data Manager API 在将转化事件作为额外数据源发送时不支持这些标识符。

响应字段

`UploadClickConversionResponse` (Google Ads API)	`IngestEventsResponse`（数据管理器 API）	备注
`job_id`	无对应报告	使用响应中返回的 `request_id` 来检索诊断信息。
`partial_failure_error`	无对应报告	Data Manager API 不支持部分失败。如果 `IngestEventsRequest` 的任何字段未能通过验证，Data Manager API 将拒绝整个请求。
`request-id` 响应标头	`request_id`	请求 ID 会作为 Data Manager API 中的响应字段返回，而不是作为响应标头返回。
`results`	无对应报告	Data Manager API 会异步处理事件。使用诊断信息检查处理结果。

升级步骤