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:

Autenticación

La API de Data Manager requiere credenciales con un alcance diferente al de la API de Google Ads. Sigue los pasos que se indican en Configura el acceso a la API para generar credenciales nuevas que incluyan el permiso de la API de Data Manager.

Asociaciones de campos de administración de públicos

Usa las asignaciones de las tablas para asignar un UserList de la API de Google Ads a su equivalente UserList de 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 que un miembro del público permanece en la lista después de agregarse. El valor debe corresponder a días enteros. Si no se establece, el valor predeterminado es el máximo.

Asigna un 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 el atributo 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 el atributo 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 Información del público de 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, debes establecer el campo crm_based_user_list en un valor CrmBasedUserListInfo cuando crees un público de Segmentación por clientes.

En la API de Data Manager, establece los atributos equivalentes configurando el campo ingested_user_list_info en un IngestedUserListInfo y, luego, establece 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_ID. Esto equivale a configurar el parámetro upload_key_type en CONTACT_INFO en la API de Google Ads.
contact_id_info

Se establece en un ContactIdInfo.

Establece data_source_type en DATA_SOURCE_TYPE_FIRST_PARTY. Esto equivale a configurar data_source_type en FIRST_PARTY en la API de Google Ads.

Documentos de identidad digitales

upload_key_types
Se establece en una lista que contiene MOBILE_ID. Esto equivale a configurar el parámetro upload_key_type como MOBILE_ADVERTISING_ID en la API de Google Ads.
mobile_id_info

Se establece en un MobileIdInfo.

  • Establece data_source_type en DATA_SOURCE_TYPE_FIRST_PARTY. Esto equivale a configurar data_source_type en FIRST_PARTY en la API de Google Ads.
  • Establece key_space en IOS o ANDROID. La API de Data Manager requiere este valor. Esto difiere de la API de Google Ads, en la que el espacio de claves se infiere de app_id.
  • Establece app_id en la cadena que identifica de forma única la aplicación para dispositivos móviles de la que se recopilaron los datos. Usa el mismo formato que utilizas para el app_id en la API de Google Ads.

IDs de usuario

upload_key_types
Se establece en una lista que contiene USER_ID. Esto equivale a configurar el parámetro upload_key_type en CRM_ID en la API de Google Ads.
user_id_info

Se establece en un UserIdInfo.

Establece data_source_type en DATA_SOURCE_TYPE_FIRST_PARTY. Esto equivale a configurar data_source_type en FIRST_PARTY en la API de Google Ads.

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}

Sube asignaciones de campos

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

Campos de solicitud

Estas asignaciones usan el IngestAudienceMembersRequest en la API de Data Manager como referencia, pero también puedes usarlas si conviertes tu solicitud a la API de Google Ads en un RemoveAudienceMembersRequest o un RemoveAllAudienceMembersRequest.

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 del customer_match_user_list_metadata de OfflineUserDataJob consent Es la configuración de consentimiento predeterminada opcional para los miembros del público en la solicitud. Puedes anular este valor para un miembro del público individual configurando el campo consent de AudienceMember.
No hay equivalente encoding Obligatorio: Se establece en el Encoding que se usa para los valores de UserIdentifier.
No hay equivalente encryption_info Se establece si la solicitud contiene valores encriptados. Consulta Encriptación para obtener más detalles.
job_id No hay equivalente Usa el request_id que se muestra en la respuesta para recuperar los diagnósticos.
enable_partial_failure No hay equivalente La API de Data Manager usa un modelo de error de falla rápida. 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 los diagnósticos.
enable_warnings No hay equivalente La API de Data Manager no informa advertencias en la respuesta. Recupera las advertencias de procesamiento con diagnósticos.
validate_only validate_only
operations audience_members Es la lista de miembros del público que se agregarán o quitarán. Consulta la sección Campos de operación para obtener más detalles.
No hay equivalente terms_of_service Obligatorio. Se establece para indicar que el usuario aceptó o rechazó las Condiciones del Servicio de la Segmentación por clientes.

Campos de clientes y públicos

La API de Google Ads solo admite subir miembros del público a un público por trabajo.Además, se requiere el encabezado de la solicitud developer-token, y debes establecer los encabezados de la 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 debes especificar la información de acceso y del cliente vinculado con los campos de un Destination en lugar de los encabezados de la solicitud. Consulta Configura destinos para obtener más información sobre los destinos.

En la API de Google Ads, puedes quitar todos los miembros de un público estableciendo el campo remove_all de un OfflineUserDataJobOperation en true.

En la API de Data Manager, esto se logra enviando un RemoveAllAudienceMembersRequest. Consulta la guía Quita todos los miembros para obtener más detalles.

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

API de Google Ads Destination (API de Data Manager) Notas
customer_id de la solicitud operating_account Establece el 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 No hay equivalente No se requiere un token de desarrollador para la API de Data Manager.
Encabezado de la solicitud login-customer-id login_account Establece el 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 Si accedes a operating_account con un vínculo de socio, establece account_id en el ID de cliente de la cuenta vinculada y establece account_type en DATA_PARTNER. De lo contrario, no configures el campo linked_account.
user_list del 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.
No hay 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 operación

La API de Data Manager contiene métodos independientes para agregar y quitar miembros del público. En cambio, el objeto AddOfflineUserDataJobOperationsRequest de la API de Google Ads contiene una lista de objetos operations, cada uno de los cuales agrega un miembro, quita un miembro o quita todos los miembros según el tipo de operación. Aquí se muestra la asignación de cada tipo de operación a su método correspondiente en la API de Data Manager:

OfflineUserDataJobOperation (API de Google Ads) Método IngestionService (API de Data Manager) Notas
create IngestAudienceMembers Consulta la sección Campos de miembros del público para obtener más detalles.
remove RemoveAudienceMembers Consulta la sección Campos de miembros del público para obtener más detalles.
remove_all RemoveAllAudienceMembers Consulta Cómo quitar todos los miembros del público para obtener más detalles.

Campos de miembros del público

UserData (API de Google Ads) AudienceMember (API de Data Manager) Notas
consent consent

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_data
  • user_id_data
  • composite_data
    • user_data
    • ip_data

Completa el campo que corresponda 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 composite_data en un CompositeData con una entrada independiente en user_data.user_identifiers para cada elemento de información de contacto.

Si bien user_data todavía se admite, te recomendamos que uses composite_data para asegurarte de que tu integración esté preparada para futuras mejoras. Consulta Datos compuestos para obtener más detalles.

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 con codificación hash. También puedes encriptar la dirección de correo electrónico con codificación hash.
hashed_phone_number phone_number Se establece en el número de teléfono con formato y con codificación hash. También puedes encriptar el número de teléfono codificado con hash.
user_identifier_source No hay equivalente

Campos de la dirección

Estas son las asignaciones de campos entre OfflineUserAddressInfo en la API de Google Ads y AddressInfo en la API de Data Manager. 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 Obligatorio
hashed_first_name given_name

Obligatorio. Se establece en el nombre con formato y con codificación hash. También puedes encriptar el nombre con codificación hash.
hashed_last_name family_name

Obligatorio. Se establece en el apellido con formato y con codificación hash. También puedes encriptar el apellido con codificación hash.
hashed_street_address No hay equivalente
postal_code postal_code Obligatorio
state No hay equivalente

Dirección IP

La API de Data Manager admite la inclusión de direcciones IP para las cargas de Segmentación por clientes, además de los identificadores de usuario. Se proporcionan en CompositeData, que agrupa UserData y IpData. Proporcionar estos campos juntos puede ayudar a mejorar los porcentajes de coincidencias.

Consulta Transferencia de direcciones IP para la Segmentación por clientes para obtener más detalles.

API de Google Ads CompositeData (API de Data Manager) Notas
No hay equivalente ip_data.ip_address Se establece en la dirección IPv4 o IPv6 sin procesar. Consulta la guía sobre el formato de la dirección IP.
No hay equivalente ip_data.observe_start_time Se establece en la marca de tiempo en formato RFC 3339 cuando se observó la dirección IP por primera vez.
No hay equivalente ip_data.observe_end_time Se establece en la marca de tiempo en formato RFC 3339 cuando se observó la dirección IP por última vez.
user_identifiers user_data Se establece en un objeto UserData.

Documentos de identidad digitales

Si usas documentos de identidad digitales, establece mobile_data en un MobileData con una entrada en mobile_ids para cada documento de identidad digital.

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, agregas un UserIdentifier independiente con mobile_id para cada ID de dispositivo móvil del miembro del público. En la API de Data Manager, agrega un solo MobileData 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 valor 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, agregas un UserIdentifier independiente con third_party_user_id para cada ID de usuario del miembro del público.

En la API de Data Manager, establece el campo user_id_data en un UserIdData y establece 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
Anterior
Pasos para la actualización