字段映射

使用下表中的映射，将 Google Ads API 中的 UploadClickConversionRequest映射到 Data Manager API 中对应的 IngestEventsRequest。

身份验证

Data Manager API 需要的凭据的范围与 Google Ads API 不同。请按照 设置 API 访问权限中的步骤生成包含 Data Manager API 范围的新 凭据。

请求字段

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。这可能与您的 Google Ads API 请求中的 customer_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 user_properties.customer_type 设置为 CustomerType 枚举中的值。
无对应报告 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 会异步处理事件。使用诊断信息检查处理结果。
上一页
升级步骤