Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

欄位對應

使用表格中的對應項目，將 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`。
`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`	如果使用 JSON 格式，請將值設為 RFC 3339 格式，這與 Google Ads API 日期和時間格式略有不同。如果使用通訊協定緩衝區，請使用 `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`	詳情請參閱使用者 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 會非同步處理事件。使用診斷功能查看處理結果。

升級步驟