欄位對應

使用表格中的對應項目，將 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 無對應報告 資料管理工具 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。

資料管理工具 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 的使用者定義 ID。如果您在單一要求中傳送多個轉換動作的轉換，請設定這個欄位。

轉換欄位

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 詳情請參閱使用者 ID 欄位。
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_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

使用者 ID 欄位

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 都不支援離線轉換或待開發客戶強化轉換的這些 ID，而且 Data Manager API 在傳送轉換事件做為額外資料來源時，也不支援這些 ID。

回覆欄位

UploadClickConversionResponse (Google Ads API) IngestEventsResponse (Data Manager API) 附註
job_id 無對應報告 使用回應中傳回的 request_id 擷取診斷。
partial_failure_error 無對應報告 資料管理工具 API 不支援部分失敗。如果 IngestEventsRequest 的任何欄位驗證失敗，Data Manager API 就會拒絕整個要求。
request-id 回應標頭 request_id 要求 ID 會以 Data Manager API 中的回應欄位形式傳回，而非回應標頭。
results 無對應報告 Data Manager API 會以非同步方式處理事件。使用診斷功能查看處理結果。
上一頁
升級步驟