Asignaciones de campo

Usa las asignaciones de campos para actualizar cada paso de tu flujo de trabajo de Segmentación por clientes de la API de Google Ads a la API de Data Manager:

• Asignaciones de campos de administración de públicos contiene asignaciones de campos para crear, actualizar y recuperar públicos.

• Asignaciones de campos de transferencia contiene asignaciones de campos para agregar o quitar miembros del público.

Asignaciones de campos de administración de públicos

Usa las asignaciones de las tablas para asignar un objeto UserList en la API de Google Ads a su equivalente UserList en la API de Data Manager.

UserList (API de Google Ads)	UserList (API de Data Manager)	Notas
resource_name	name	Consulta Nombres de recursos para obtener más detalles.
id	id
read_only	read_only
name	display_name	Obligatorio
description	description	Obligatorio
membership_status	membership_status
integration_code	integration_code
membership_life_span	membership_duration	Es la duración durante la que un miembro del público permanece en la lista después de que se lo agrega. El valor debe corresponder a días completos. Si no se establece, el valor predeterminado es el máximo. Da formato al valor con el formato de marca de tiempo.
size_for_display	size_info.display_network_members_count
size_range_for_display	No hay equivalente	Usa size_info.display_network_members_count para obtener información sobre el tamaño.
size_for_search	size_info.search_network_members_count
size_range_for_search	No hay equivalente	Usa size_info.search_network_members_count para obtener información sobre el tamaño.
type	No hay equivalente
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	No se usa para la Segmentación por clientes.
crm_based_user_list	ingested_user_list_info	Obligatorio. Consulta la información del público de la Segmentación por clientes.
No hay equivalente	ingested_user_list_info.pair_id_info	No se usa para la Segmentación por clientes.
No hay equivalente	ingested_user_list_info.partner_audience_info	No se usa para la Segmentación por clientes.
logical_user_list	No hay equivalente	No se usa para la Segmentación por clientes.
logical_user_list	No hay equivalente	No se usa para la Segmentación por clientes.
lookalike_user_list	No hay equivalente	No se usa para la Segmentación por clientes.
rule_based_user_list	No hay equivalente	No se usa para la Segmentación por clientes.
similar_user_list	No hay equivalente	No se usa para la Segmentación por clientes.

Información del público de Segmentación por clientes

En la API de Google Ads, el campo crm_based_user_list es obligatorio cuando se crea un público de Segmentación por clientes.

En la API de Data Manager, configura los atributos equivalentes estableciendo el campo ingested_user_list_info en un IngestedUserListInfo y, luego, configura los campos obligatorios para la Segmentación por clientes y el tipo de datos del usuario.

Información de contacto

upload_key_types

Se establece en una lista que contiene CONTACT_INFO.

contact_id_info

Se establece en un ContactIdInfo.

Establece data_source_type en DATA_SOURCE_TYPE_FIRST_PARTY.

IDs de dispositivos móviles

upload_key_types

Se establece en una lista que contiene MOBILE_ID.

mobile_id_info

Se establece en un MobileIdInfo.

• Establece data_source_type en DATA_SOURCE_TYPE_FIRST_PARTY.
• Establece key_space en IOS o ANDROID.
• Establece app_id en la cadena que identifica de forma única la aplicación para dispositivos móviles desde la que se recopilaron los datos. Usa el mismo formato que usas para el ID de la app en la API de Google Ads.

IDs de usuario

upload_key_types

Se establece en una lista que contiene USER_ID.

user_id_info

Se establece en un UserIdInfo.

Establece data_source_type en DATA_SOURCE_TYPE_FIRST_PARTY.

Nombres de recursos

La API de Data Manager usa un formato de nombre de recurso diferente al de la API de Google Ads.

API de Google Ads

En la API de Google Ads, un nombre de recurso UserList usa el siguiente formato:

customers/{customer_id}/userLists/{user_list_id}

API de Data Manager

En la API de Data Manager, un nombre de recurso UserList usa el siguiente formato:

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

Cómo subir asignaciones de campos

Usa las asignaciones de las tablas para asignar un objeto AddOfflineUserDataJobOperationsRequest en la API de Google Ads a su equivalente IngestAudienceMembersRequest en la API de Data Manager.

Campos de la solicitud

AddOfflineUserDataJobOperationsRequest (API de Google Ads)	IngestAudienceMembersRequest (API de Data Manager)	Notas
Campo customer_id Campo customer_match_user_list_metadata de OfflineUserDataJob Encabezado de la solicitud developer-token Encabezado de la solicitud login-customer_id Encabezado de la solicitud linked-customer-id	destinations	Consulta Campos de clientes y públicos.
consent de la customer_match_user_list_metadata de OfflineUserDataJob	consent	Es la configuración de consentimiento predeterminada opcional para los miembros del público incluidos en la solicitud. Puedes anular este valor para un miembro del público individual si configuras el campo consent de AudienceMember.
Sin equivalente	encoding	Obligatorio: Se establece en el Encoding que se usa para los valores de UserIdentifier.
Sin equivalente	encryption_info	Indica si la solicitud contiene valores encriptados. Consulta Encriptación para obtener más detalles.
job_id	Sin equivalente	Usa el request_id que se muestra en la respuesta para recuperar los diagnósticos.
enable_partial_failure	Sin equivalente	La API del Administrador de datos no admite fallas parciales. Si algún campo de un objeto IngestAudienceMembersRequest no pasa la validación, la API de Data Manager rechaza toda la solicitud. Recupera los errores de procesamiento con diagnóstico.
enable_warnings	Sin equivalente	La API de Data Manager no informa advertencias en la respuesta. Recupera advertencias de procesamiento con diagnósticos.
validate_only	validate_only
operations	audience_members	Es la lista de miembros del público. Consulta la sección sobre los campos de los miembros del público para obtener más detalles.
Sin equivalente	terms_of_service	Obligatorio. Se configura para indicar que el usuario aceptó o rechazó las condiciones del servicio de Segmentación por clientes.

Campos de clientes y públicos

La API de Google Ads solo admite la carga de miembros del público en un público por trabajo.Además, se requiere el encabezado de solicitud developer-token, y debes configurar los encabezados de solicitud login-customer-id y linked-customer-id para diferentes situaciones de autenticación.

La API de Data Manager admite el envío de miembros del público para varios públicos en una sola solicitud. La API de Data Manager no requiere un token de desarrollador, y la información de acceso y del cliente vinculado se especifica con los campos de un objeto Destination en lugar de los encabezados de la solicitud. Consulta Configura destinos para obtener más información sobre los destinos.

La API de Data Manager no admite la eliminación de todos los miembros de un público. En la API de Google Ads, puedes quitar todos los miembros de un público estableciendo el campo remove_all de un objeto OfflineUserDataJobOperation en true.

A continuación, se explica cómo asignar los campos de la API de Google Ads para un solo público a los campos equivalentes en un objeto Destination:

API de Google Ads	Destination (API de Data Manager)	Notas
customer_id de la solicitud	operating_account	Establece account_id en el ID de cliente del público. Establece el account_type del operating_account en GOOGLE_ADS.
Encabezado de la solicitud developer-token	Sin equivalente	No se requiere un token de desarrollador para la API de Data Manager.
Encabezado de la solicitud login-customer-id	login_account	Establece account_id en el ID de cliente de la cuenta de acceso. Establece account_type en GOOGLE_ADS si la cuenta de acceso es una cuenta de Google Ads o en DATA_PARTNER si es una cuenta de socio de datos.
Encabezado de la solicitud linked-customer-id	linked_account	Establece account_id en el ID de cliente de la cuenta vinculada. Establece account_type en DATA_PARTNER.
user_list de la customer_match_user_list_metadata de OfflineUserDataJob	product_destination_id	Obligatorio. Se establece en el ID numérico del público. No uses el nombre del recurso de UserList.
Sin equivalente	reference	Es un identificador definido por el usuario para el Destination. Establece este campo si envías miembros del público para varios públicos en una sola solicitud.

Campos de miembros del público

UserData (API de Google Ads)	AudienceMember (API de Data Manager)	Notas
consent	consent	Es el valor que se establece para especificar el consentimiento del miembro del público. Ambas APIs usan un objeto Consent similar (ad_user_data, ad_personalization). En el caso de la API de Data Manager, también puedes establecer el consentimiento para todos los miembros del público en una solicitud configurando el campo consent a nivel de la solicitud.
transaction_attribute	No hay equivalente	No se aplica a la Segmentación por clientes.
user_attribute	No hay equivalente	No se aplica a la Segmentación por clientes.
user_identifiers	mobile_id_data user_id_data user_identifiers	Completa el campo que corresponde al tipo de datos que envías para los miembros del público. Consulta Campos de identificadores del usuario para obtener más detalles.

Campos de identificadores del usuario

En la API de Google Ads, ya sea que envíes información de contacto, IDs de dispositivos móviles o IDs de usuario, debes usar UserIdentifier. La API de Data Manager usa un enfoque diferente, con campos distintos para cada tipo de datos.

En la API de Data Manager, completa el campo que corresponde al tipo de datos que envías:

Información de contacto

Si usas información de contacto, como la dirección de correo electrónico, el número de teléfono o la dirección, establece user_data en un UserData con una entrada independiente en user_identifiers para cada elemento de información de contacto.

UserIdentifier (API de Google Ads)	UserIdentifier (API de Data Manager)	Notas
address_info	address	Consulta Campos de dirección para obtener más detalles.
hashed_email	email_address	Se establece en la dirección de correo electrónico con formato y hash. También puedes encriptar la dirección de correo electrónico hasheada.
hashed_phone_number	phone_number	Se establece en el número de teléfono con formato y codificado con hash. También puedes encriptar el número de teléfono hasheado.
user_identifier_source	No hay equivalente

Campos de la dirección

A continuación, se muestran las asignaciones de campos entre OfflineUserAddressInfo en la API de Google Ads y AddressInfo en la API del Administrador de datos. Usa estas asignaciones si utilizas información de contacto para completar tu público de Segmentación por clientes.

OfflineUserAddressInfo (API de Google Ads)	AddressInfo (API de Data Manager)	Notas
city	No hay equivalente
country_code	region_code
hashed_first_name	given_name	Se establece en el nombre dado con formato y hash. También puedes encriptar el nombre proporcionado con hash.
hashed_last_name	family_name	Se establece en el nombre de familia con formato y hash. También puedes encriptar el nombre de la familia hasheado.
hashed_street_address	No hay equivalente
postal_code	postal_code
state	No hay equivalente

IDs de dispositivos móviles

Si usas IDs de dispositivos móviles, configura mobile_data como un MobileData con una entrada en mobile_ids para cada ID.

UserIdentifier (API de Google Ads)	MobileData (API de Data Manager)	Notas
mobile_id	mobile_ids	Se establece en la lista de IDs de dispositivos móviles del miembro del público. En la API de Google Ads, debes agregar un objeto aparte UserIdentifier con mobile_id para cada ID de dispositivo móvil del miembro del público. En la API de Data Manager, agrega un objeto MobileData único con mobile_ids establecido en la lista de todos los IDs de dispositivos móviles del miembro del público.
user_identifier_source	No hay equivalente

IDs de usuario

Si usas IDs de usuario, establece user_id_data en un UserIdData y user_id en el ID de usuario del miembro del público.

UserIdentifier (API de Google Ads)	UserIdData (API de Data Manager)	Notas
third_party_user_id	user_id	En la API de Google Ads, debes agregar un objeto aparte UserIdentifier con third_party_user_id para cada ID de usuario del miembro del público. En la API del Administrador de datos, establece el campo user_id_data en un UserIdData y su campo user_id en el ID de usuario del miembro del público. No puedes enviar varios IDs de usuario para el mismo miembro del público.
user_identifier_source	No hay equivalente