字段映射

使用表格中的映射，将 Google Ads API 中的 UploadClickConversionRequest映射到 Data Manager API 中等效的 IngestEventsRequest。

请求字段

UploadClickConversionRequest (Google Ads API) IngestEventsRequest (Data Manager 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 (Data Manager API) 备注
请求的 customer_id operating_account 将 account_id 设置为 Google Ads 转化账号 的客户 ID。将 operating_account 的 account_type 设置为 GOOGLE_ADS。
developer-token 请求标头 无对应报告 Data Manager API 不需要开发者令牌。
login-customer-id 请求标头 login_account 将 account_id 设置为登录账号的客户 ID。如果登录账号是 Google Ads 账号，请将 account_type 设置为 GOOGLE_ADS；如果登录账号是数据合作伙伴账号，请将 account_type 设置为 DATA_PARTNER。
linked-customer-id 请求标头 linked_account 如果您使用合作伙伴关联访问 operating_account，请将 account_id 设置为关联账号的客户 ID，并将 account_type 设置为 DATA_PARTNER。否则，请勿设置 linked_account 字段。
ClickConversion 的 conversion_action product_destination_id 设置为转化操作的数字 ID。请勿使用 ConversionAction 的资源名称。
无对应报告 reference Destination 的用户定义标识符。如果您要在单个请求中发送多个转化操作的转化，请设置此字段。

转化字段

ClickConversion (Google Ads API) Event (Data Manager 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
如需了解详情，请参阅时间戳格式。
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 (Data Manager 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 (Data Manager API) 备注
product_id merchant_product_id
quantity quantity
unit_price unit_price
无对应报告 item_id
无对应报告 additional_item_parameters

自定义变量字段

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

用户标识符字段

UserIdentifier (Google Ads API) UserIdentifier (Data Manager 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 (Data Manager 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 会异步处理事件。使用诊断信息检查处理结果。
上一页
升级步骤