字段映射

使用表格中的映射关系，将 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 请求标头 无对应报告 数据管理器 API 不需要开发者令牌。
login-customer-id 请求标头 login_account 将 account_id 设置为登录账号的客户 ID。如果登录账号是 Google Ads 账号，请将 account_type 设置为 GOOGLE_ADS；如果登录账号是数据合作伙伴账号，请将 设置为 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 会异步处理事件。使用诊断信息检查处理结果。
上一页
升级步骤