欄位對應

請使用欄位對應，將目標顧客比對工作流程的每個步驟，從 Google Ads API 升級至 Data Manager API：

• 目標對象管理工具欄位對應包含用於建立、更新和擷取目標對象的欄位對應。

• 「Ingestion field mappings」(擷取欄位對應) 包含用於新增或移除目標對象成員的欄位對應。

驗證

Data Manager API 需要的憑證範圍與 Google Ads API 不同。請按照「設定 API 存取權」中的步驟操作，產生包含 Data Manager API 範圍的新憑證。

目標對象管理工具欄位對應

請使用表格中的對應關係，將 Google Ads API 中的 UserList 對應至 Data Manager API 中的 UserList。

UserList (Google Ads API)	UserList (Data Manager API)	附註
resource_name	name	詳情請參閱「資源名稱」。
id	id
read_only	read_only
name	display_name	必要
description	description	必要
membership_status	membership_status
integration_code	integration_code
membership_life_span	membership_duration	目標對象成員加入名單後，在名單中保留的時間長度。這個值必須對應至整數天數。如未設定，則預設為最大值。 請使用時間戳記格式設定值。
size_for_display	size_info.display_network_members_count
size_range_for_display	沒有效果相當的功能。	請使用 size_info.display_network_members_count 取得大小資訊。
size_for_search	size_info.search_network_members_count
size_range_for_search	沒有效果相當的功能。	請使用 size_info.search_network_members_count 取得大小資訊。
type	沒有效果相當的功能。
access_reason	access_reason
account_user_list_status	account_access_status
closing_reason	closing_reason
eligible_for_search	target_network_info.eligible_for_search
eligible_for_display	target_network_info.eligible_for_display
match_rate_percentage	ingested_user_list_info.contact_id_info.match_rate_percentage
basic_user_list	ingested_user_list_info.pseudonymous_id_info	不會用於目標顧客比對。
crm_based_user_list	ingested_user_list_info	必填項目。請參閱「目標顧客比對目標對象資訊」。
沒有效果相當的功能。	ingested_user_list_info.pair_id_info	不會用於目標顧客比對。
沒有效果相當的功能。	ingested_user_list_info.partner_audience_info	不會用於目標顧客比對。
logical_user_list	沒有效果相當的功能。	不會用於目標顧客比對。
logical_user_list	沒有效果相當的功能。	不會用於目標顧客比對。
lookalike_user_list	沒有效果相當的功能。	不會用於目標顧客比對。
rule_based_user_list	沒有效果相當的功能。	不會用於目標顧客比對。
similar_user_list	沒有效果相當的功能。	不會用於目標顧客比對。

目標顧客比對目標對象資訊

在 Google Ads API 中，建立目標顧客比對目標對象時，您必須將 crm_based_user_list 欄位設為 CrmBasedUserListInfo。

在 Data Manager API 中，將 ingested_user_list_info 欄位設為 IngestedUserListInfo，然後設定目標顧客比對和使用者資料類型的必要欄位，即可設定對應的屬性。

資源名稱

Data Manager API 使用的資源名稱格式與 Google Ads API 不同。

Google Ads API

在 Google Ads API 中，UserList 資源名稱的格式如下：

customers/{customer_id}/userLists/{user_list_id}

Data Manager API

在 Data Manager API 中，UserList 資源名稱的格式如下：

accountTypes/{accountType}/accounts/{account}/userLists/{userList}

上傳欄位對應

請使用表格中的對應關係，將 Google Ads API 中的 AddOfflineUserDataJobOperationsRequest 對應至 Data Manager API 中的對等 IngestionService 要求。

要求欄位

這些對應關係以 Data Manager API 中的 IngestAudienceMembersRequest 為參考依據，但如果您要將 Google Ads API 要求轉換為 RemoveAudienceMembersRequest 或 RemoveAllAudienceMembersRequest，也可以使用這些對應關係。

AddOfflineUserDataJobOperationsRequest (Google Ads API)	IngestAudienceMembersRequest (Data Manager API)	附註
customer_id 欄位 OfflineUserDataJob 的 customer_match_user_list_metadata 欄位 developer-token 要求標頭 login-customer_id 要求標頭 linked-customer-id 要求標頭	destinations	請參閱「顧客和目標對象欄位」。
OfflineUserDataJob 的 customer_match_user_list_metadata consent	consent	要求中目標對象成員的預設同意聲明設定 (選用)。您可以設定 AudienceMember 的 consent 欄位，覆寫個別目標對象成員的這個值。
無對應報告	encoding	必要：設為用於 UserIdentifier 值的 Encoding。
無對應報告	encryption_info	如果要求包含加密值，請設定此屬性。詳情請參閱「加密」。
job_id	無對應報告	使用回應中傳回的 request_id 擷取診斷。
enable_partial_failure	無對應報告	Data Manager API 採用快速失敗錯誤模型。如果 IngestAudienceMembersRequest 的任何欄位未通過驗證，Data Manager API 會拒絕整個要求。使用診斷功能擷取處理錯誤。
enable_warnings	無對應報告	Data Manager API 不會在回應中回報警告。使用診斷功能擷取處理警告。
validate_only	validate_only
operations	audience_members	要新增或移除的目標對象成員清單。詳情請參閱作業欄位一節。
無對應報告	terms_of_service	必填項目。設定這個參數，表示使用者已接受或拒絕目標顧客比對服務條款。

顧客和目標對象欄位

Google Ads API 僅支援將目標對象成員上傳至一個目標對象。此外，您必須提供 developer-token 要求標頭，並為不同的驗證情境設定 login-customer-id 和 linked-customer-id 要求標頭。

Data Manager API 支援在單一要求中傳送多個目標對象的成員。Data Manager API 不需要開發人員權杖，您可以使用 Destination 的欄位 (而非要求標頭) 指定登入和連結的客戶資訊。如要進一步瞭解目的地，請參閱「設定目的地」。

在 Google Ads API 中，您可以將 OfflineUserDataJobOperation 的 remove_all 欄位設為 true，藉此移除目標對象的所有成員。

在 Data Manager API 中，您可以傳送 RemoveAllAudienceMembersRequest 來達成這項操作。詳情請參閱「移除所有成員」指南。

如要將單一目標對象的 Google Ads API 欄位，對應至 Destination 中的對等欄位，請按照下列步驟操作：

Google Ads API	Destination (Data Manager API)	附註
要求的customer_id	operating_account	將 account_id 設為目標對象的客戶 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 欄位。
OfflineUserDataJob 的 customer_match_user_list_metadata user_list	product_destination_id	必填項目。設為目標對象的數字 ID。請勿使用 UserList 的資源名稱。
無對應報告	reference	Destination 的使用者定義 ID。如果您在單一要求中傳送多個目標對象的目標對象成員，請設定這個欄位。

作業欄位

Data Manager API 包含新增和移除目標對象成員的不同方法。相較之下，Google Ads API 中的 AddOfflineUserDataJobOperationsRequest 包含 operations 清單，每個清單都會根據作業類型新增成員、移除成員或移除所有成員。以下是各作業類型與 Data Manager API 中對應方法的對照表：

OfflineUserDataJobOperation (Google Ads API)	IngestionService 方法 (Data Manager API)	附註
create	IngestAudienceMembers	詳情請參閱「目標對象成員欄位」一節。
remove	RemoveAudienceMembers	詳情請參閱「目標對象成員欄位」一節。
remove_all	RemoveAllAudienceMembers	詳情請參閱「移除所有目標對象成員」。

目標對象成員欄位

UserData (Google Ads API)	AudienceMember (Data Manager API)	附註
consent	consent	設定目標對象成員的同意聲明。 這兩個 API 使用類似的 Consent 物件 (ad_user_data、ad_personalization)。 如果是 Data Manager API，您也可以設定要求層級的 consent 欄位，為要求中的所有目標對象成員設定同意聲明。
transaction_attribute	沒有效果相當的功能。	不適用於目標顧客比對。
user_attribute	沒有效果相當的功能。	不適用於目標顧客比對。
user_identifiers	mobile_data user_id_data composite_data user_data ip_data	根據您要傳送的目標對象成員資料類型，填入對應的欄位。詳情請參閱「使用者 ID 欄位」。

使用者 ID 欄位

在 Google Ads API 中，無論您要傳送聯絡資訊、數位身分證件或使用者 ID，都請使用 UserIdentifier。Data Manager API 則採用不同方法，每種資料類型都有不同的欄位。

在 Data Manager API 中，填入與您要傳送的資料類型相對應的欄位：