字段映射

使用字段映射，将目标客户匹配工作流程的每个步骤从 Google Ads API 升级到 Data Manager API：

• 受众群体管理字段映射包含用于创建、更新和检索受众群体的字段映射。

• 提取字段映射包含用于添加或移除受众群体成员的字段映射。

身份验证

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	请参阅客户和受众群体字段。
consent（来自 OfflineUserDataJob 的 customer_match_user_list_metadata ）	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；如果 登录账号是数据合作伙伴账号，请将 设置为 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 的用户定义标识符。如果您在单个请求中为多个受众群体发送受众群体成员，请设置此字段。

操作字段

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	填充与您要为受众群体成员发送的数据类型相对应的字段。如需了解详情，请参阅用户标识符字段。

用户标识符字段

在 Google Ads API 中，无论您要发送的是联系信息、移动 ID 还是用户 ID，都需要使用 UserIdentifier。Data Manager API 采用不同的方法，为每种类型的数据使用不同的字段。

在 Data Manager API 中，填充与您要发送的数据类型对应的字段：