Cada Destination en un IngestAudienceMembersRequest o IngestEventsRequest define lo siguiente:
- Es la cuenta que recibe los datos. Por ejemplo, una cuenta de Google Ads o una propiedad de Google Analytics.
- Es la entidad de destino de los datos dentro de la cuenta, como una acción de conversión de Google Ads o un flujo de Google Analytics.
- Es la ruta de acceso de las credenciales de la solicitud a la cuenta que recibe los datos.
Si eres anunciante o agencia, consulta los casos prácticos para anunciantes y obtén ejemplos de cómo construir un Destination:
Si eres socio de datos, consulta los casos de uso de socios de datos para ver ejemplos de cómo construir un objeto Destination para enviar datos a una cuenta con una vinculación de producto a tu cuenta de socio de datos:
En la sección Requisitos detallados, se explican en profundidad los requisitos y las reglas de validación.
Situaciones de los anunciantes
A continuación, se explica cómo configurar un Destination para situaciones comunes de anunciantes y agencias. En este diagrama, se muestra cómo la API de Data Manager usa las credenciales y los campos de Destination para acceder a la cuenta del anunciante.
Google Ads
A continuación, se muestra un diagrama con un ejemplo de un conjunto de cuentas y usuarios de Google Ads.
- Cuenta de administrador M1
La cuenta M1 tiene dos cuentas secundarias directas:
- Cuenta de administrador M2
- Cuenta de cliente C1
La Cuenta de Google
cloudysanfrancisco@gmail.comes un usuario en M1.- Cuenta de administrador M2
M2 tiene dos cuentas secundarias directas:
- Cuenta de cliente C1
- Cuenta de cliente C2
La Cuenta de Google
baklavainthebalkans@gmail.comes un usuario de A2.- Cuenta de cliente C1
C1 tiene dos cuentas de administrador principal directas:
- Cuenta de administrador M1
- Cuenta de administrador M2
La Cuenta de Google
jeffersonloveshiking@gmail.comes un usuario de C1.- Cuenta de cliente C2
La cuenta de administrador A2 es la única cuenta principal directa de C2.
Ninguna de las Cuentas de Google que se indican es un usuario de C2.
Las situaciones de acceso directo y de acceso de administrador muestran cómo configurarías un destino para enviar datos a estas cuentas.
Situación de acceso directo
Si deseas enviar datos a una cuenta de Google Ads y tus credenciales corresponden a una Cuenta de Google que es un usuario de la cuenta de Google Ads, haz lo siguiente:
| Destino | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
No establezcas login_account o configúralo con los mismos valores que operating_account. |
||||
linked_account |
No configures el campo linked_account. |
||||
product_destination_id |
Es el ID del público o de la acción de conversión. | ||||
A continuación, se muestra un ejemplo de una situación de acceso directo, en la que se usan las cuentas del diagrama y las credenciales de la Cuenta de Google jeffersonloveshiking@gmail.com.
{
"destinations": [
{
"operatingAccount": {
"accountId": "C1_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"loginAccount": {
"accountId": "C1_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"productDestinationId": "USER_LIST_ID"
}
]
}
Situación de acceso de administrador
Si deseas enviar datos a una cuenta de Google Ads y tus credenciales son para una Cuenta de Google que es un usuario en una cuenta de administrador de Google Ads en la que la cuenta de anunciante es una cuenta secundaria, haz lo siguiente:
| Destino | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
No configures el campo linked_account. |
||||
product_destination_id |
Es el ID del público o de la acción de conversión. | ||||
A continuación, se muestra un ejemplo de una situación de acceso de administrador para la cuenta de cliente C2 de Google Ads del diagrama y las credenciales de la Cuenta de Google baklavainthebalkans@gmail.com:
{
"destinations": [
{
"operatingAccount": {
"accountId": "C2_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"loginAccount": {
"accountId": "M2_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"productDestinationId": "USER_LIST_ID"
}
]
}
A continuación, se muestra otro ejemplo de una situación de acceso de administrador para la cuenta de cliente C2 de Google Ads y las credenciales de la Cuenta de Google cloudysanfrancisco@gmail.com, que es un usuario de la cuenta de administrador M1 de Google Ads:
{
"destinations": [
{
"operatingAccount": {
"accountId": "C2_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"loginAccount": {
"accountId": "M1_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"productDestinationId": "USER_LIST_ID"
}
]
}
Display & Video 360
Puedes enviar datos a Display & Video 360 de dos maneras:
- Acceso directo, en el que las credenciales son para una Cuenta de Google que es un usuario en la cuenta de socio o anunciante de Display & Video 360
- Acceso de socio de Display & Video 360, en el que las credenciales son para una Cuenta de Google que es un usuario en la cuenta de socio de Display & Video 360, y la cuenta operativa es una cuenta de anunciante de Display & Video 360 en la cuenta de socio.
Situaciones de acceso directo
Si deseas enviar datos a una cuenta de anunciante de Display & Video 360 y tus credenciales son para una Cuenta de Google que es un usuario en la cuenta de anunciante, haz lo siguiente:
| Destino | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
No establezcas login_account o configúralo con los mismos valores que operating_account. |
||||
linked_account |
No configures el campo linked_account. |
||||
product_destination_id |
Es el ID del público. | ||||
A continuación, se muestra un ejemplo de un objeto Destination para una situación de acceso directo para enviar datos a un anunciante de Display & Video 360:
{
"destinations": [
{
"operatingAccount": {
"accountId": "ADVERTISER_ID",
"accountType": "DISPLAY_VIDEO_ADVERTISER"
},
"loginAccount": {
"accountId": "ADVERTISER_ID",
"accountType": "DISPLAY_VIDEO_ADVERTISER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}
Del mismo modo, si deseas enviar datos a una cuenta de socio de Display & Video 360 y tus credenciales son para una Cuenta de Google que es un usuario en la cuenta de socio, haz lo siguiente:
| Destino | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
No establezcas login_account o configúralo con los mismos valores que operating_account. |
||||
linked_account |
No configures el campo linked_account. |
||||
product_destination_id |
Es el ID del público. | ||||
A continuación, se muestra un ejemplo de un Destination para una situación de acceso directo para enviar datos a un socio de Display & Video 360:
{
"destinations": [
{
"operatingAccount": {
"accountId": "PARTNER_ID",
"accountType": "DISPLAY_VIDEO_PARTNER"
},
"loginAccount": {
"accountId": "PARTNER_ID",
"accountType": "DISPLAY_VIDEO_PARTNER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}
Situación de acceso de socio de Display & Video 360
Si deseas enviar datos a un anunciante de Display & Video 360 y tus credenciales corresponden a una Cuenta de Google que es un usuario de la cuenta principal de socio de Display & Video 360 del anunciante, haz lo siguiente:
| Destino | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
No configures el campo linked_account. |
||||
product_destination_id |
Es el ID del público. | ||||
A continuación, se muestra un ejemplo de un objeto Destination para una situación de acceso de socio en la que se envían datos a un anunciante de Display & Video 360. En este caso, las credenciales deben ser para una Cuenta de Google que sea un usuario en la cuenta de socio de Display & Video 360 PARTNER_ID, y la cuenta de anunciante de Display & Video 360 ADVERTISER_ID debe ser secundaria de la cuenta de socio PARTNER_ID.
{
"destinations": [
{
"operatingAccount": {
"accountId": "ADVERTISER_ID",
"accountType": "DISPLAY_VIDEO_ADVERTISER"
},
"loginAccount": {
"accountId": "PARTNER_ID",
"accountType": "DISPLAY_VIDEO_PARTNER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}
Google Analytics
Nota: operating_account y login_account deben ser idénticos cuando el destino es una cuenta de Google Analytics. De lo contrario, la solicitud fallará con el error OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.
| Destino | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
No establezcas login_account o configúralo con los mismos valores que operating_account. |
||||
linked_account |
No configures el campo linked_account. |
||||
product_destination_id |
Es el ID de medición del flujo de datos. | ||||
Este es un ejemplo de un objeto Destination para enviar eventos a Google Analytics:
{
"destinations": [
{
"operatingAccount": {
"accountId": "PROPERTY_ID",
"accountType": "GOOGLE_ANALYTICS_PROPERTY"
},
"loginAccount": {
"accountId": "PROPERTY_ID",
"accountType": "GOOGLE_ANALYTICS_PROPERTY"
},
"productDestinationId": "MEASUREMENT_ID"
}
]
}
Situaciones de socios de datos
A continuación, se explica cómo configurar un objeto Destination para situaciones comunes de un socio de datos que envía datos a cuentas de anunciantes con una vinculación de productos establecida a la cuenta del socio de datos.
En este diagrama, se muestra cómo la API de Data Manager usa las credenciales y los campos de Destination para acceder a la cuenta del anunciante a través de una vinculación del producto.
Google Ads
Este es un diagrama que muestra un ejemplo de un conjunto de cuentas de Google Ads y de socios de datos. El diagrama también muestra qué Cuenta de Google es un usuario en cada cuenta de Google Ads o de socio de datos, así como los vínculos de productos entre las cuentas.
- Socio de datos D1
Existe una vinculación de productos entre D1 y la cuenta de administrador de Google Ads A2.
La Cuenta de Google
222larabrown@gmail.comes un usuario en D1.- Socio de datos D2
Existe una vinculación de productos entre D2 y la cuenta de cliente C1 de Google Ads.
La Cuenta de Google
jeffersonloveshiking@gmail.comes un usuario en D2.- Cuenta de administrador M1
La cuenta M1 tiene dos cuentas secundarias directas:
- Cuenta de administrador M2
- Cuenta de cliente C1
- Cuenta de administrador M2
M2 tiene dos cuentas secundarias directas:
- Cuenta de cliente C1
- Cuenta de cliente C2
- Cuenta de cliente C1
C1 tiene dos cuentas de administrador principal directas:
- Cuenta de administrador M1
- Cuenta de administrador M2
- Cuenta de cliente C2
La cuenta de administrador A2 es la única cuenta principal directa de C2.
Esto es lo que puedes hacer con este conjunto de cuentas:
- Actúa como socio de datos D1
Para actuar como socio de datos D1, usa las credenciales de la Cuenta de Google
222larabrown@gmail.compara enviar datos a la cuenta de administrador A2, la cuenta de cliente C1 o la cuenta de cliente C2, con un destino que tengalogin_accountestablecido en la cuenta de socio de datos D1 ylinked_accountestablecido en la cuenta de administrador A2.Como socio de datos D1, no puedes enviar datos a la cuenta de administrador A1 porque no hay una vinculación de producto entre D1 y A1.
- Actúa como socio de datos D2
Para actuar como socio de datos D2, usa las credenciales de la Cuenta de Google
jeffersonloveshiking@gmail.compara enviar datos a la cuenta de cliente C1, con un destino que tengalogin_accountestablecido en la cuenta de socio de datos D2 ylinked_accountestablecido en la cuenta de cliente C1.Como socio de datos D2, no puedes enviar datos a la cuenta de administrador A1, a la cuenta de administrador A2 ni a la cuenta de cliente C2 porque no hay una vinculación de productos entre D2 y ninguna de esas cuentas o sus cuentas de administrador principales.
La diferencia clave entre los socios de datos D1 y D2 es la forma en que se vinculan a las cuentas de Google Ads.
- El socio de datos D1 está vinculado a una cuenta de administrador de Google Ads. Este es un ejemplo de la situación de vinculación de productos del administrador.
- El socio de datos D2 está vinculado a una cuenta de cliente de Google Ads. Este es un ejemplo de la situación de vínculo directo al producto.
Situación de vínculo directo del producto
Si deseas enviar datos a una cuenta de Google Ads y la vinculación del producto se realiza entre la cuenta de Google Ads y tu cuenta de socio de datos, haz lo siguiente:
| Destino | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
No configures el campo linked_account. |
||||
product_destination_id |
Es el ID del público o de la acción de conversión. | ||||
A continuación, se muestra un ejemplo de una situación de vínculo directo a un producto con cuentas del diagrama. En esta situación, el socio de datos D2 envía datos de miembros del público al cliente C1 de Google Ads a través de la vinculación del producto entre D2 y C1, y las credenciales de la Cuenta de Google jeffersonloveshiking@gmail.com:
{
"destinations": [
{
"operatingAccount": {
"accountId": "C1_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"loginAccount": {
"accountId": "D2_CUSTOMER_ID",
"accountType": "DATA_PARTNER"
},
"productDestinationId": "USER_LIST_ID"
}
]
}
Situación de vinculación de productos del administrador
Si deseas enviar datos a una cuenta de Google Ads y la vinculación del producto se realiza entre una cuenta de administrador principal de Google Ads y tu cuenta de socio de datos, haz lo siguiente:
| Destino | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
|
||||
product_destination_id |
Es el ID del público o de la acción de conversión. | ||||
A continuación, se muestra un ejemplo de una situación de vinculación de productos de administrador con cuentas del diagrama. En esta situación, el socio de datos D1 envía datos de miembros del público al cliente C2 de Google Ads a través de la vinculación del producto entre D1 y M2, y las credenciales de la Cuenta de Google 222larabrown@gmail.com:
{
"destinations": [
{
"operatingAccount": {
"accountId": "C2_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"loginAccount": {
"accountId": "D1_CUSTOMER_ID",
"accountType": "DATA_PARTNER"
},
"linkedAccount": {
"accountId": "M2_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"productDestinationId": "USER_LIST_ID"
}
]
}
Display & Video 360
Como socio de datos, puedes enviar datos a una cuenta de Display & Video 360 de dos maneras:
- Utiliza una vinculación directa del producto entre una cuenta de socio de datos y la cuenta de socio o de anunciante de Display & Video 360.
- Enviar datos a un anunciante de Display & Video 360 a través de una vinculación del producto entre una cuenta de socio de datos y la cuenta de socio principal de Display & Video 360 del anunciante
Situaciones de vínculos directos a productos
Si deseas enviar datos a un anunciante de Display & Video 360 y la vinculación del producto se realiza entre la cuenta del anunciante de Display & Video 360 y tu cuenta de socio de datos, haz lo siguiente:
| Destino | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
No configures el campo linked_account. |
||||
product_destination_id |
Es el ID del público o de la acción de conversión. | ||||
A continuación, se muestra un ejemplo de un objeto Destination para una situación de vinculación directa de productos para enviar datos a un anunciante de Display & Video 360:
{
"destinations": [
{
"operatingAccount": {
"accountId": "ADVERTISER_ID",
"accountType": "DISPLAY_VIDEO_ADVERTISER"
},
"loginAccount": {
"accountId": "DATA_PARTNER_ID",
"accountType": "DATA_PARTNER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}
Si deseas enviar datos a una cuenta de socio de Display & Video 360, debes tener una vinculación de producto entre la cuenta de socio de Display & Video 360 y tu cuenta de socio de datos.
| Destino | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
No configures el campo linked_account. |
||||
product_destination_id |
Es el ID del público o de la acción de conversión. | ||||
A continuación, se muestra un ejemplo de un objeto Destination para un caso de vinculación directa de productos para enviar datos a un socio de Display & Video 360:
{
"destinations": [
{
"operatingAccount": {
"accountId": "DISPLAY_VIDEO_PARTNER_ID",
"accountType": "DISPLAY_VIDEO_PARTNER"
},
"loginAccount": {
"accountId": "DATA_PARTNER_ID",
"accountType": "DATA_PARTNER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}
Situación de vinculación de productos de socios de Display & Video 360
Si deseas enviar datos a un anunciante de Display & Video 360 y la vinculación del producto a tu cuenta de socio de datos se realiza con una cuenta de socio de Display & Video 360 en la que la cuenta de anunciante es una cuenta secundaria, haz lo siguiente:
| Destino | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
|
||||
product_destination_id |
Es el ID del público o de la acción de conversión. | ||||
A continuación, se muestra un ejemplo de un objeto Destination para una situación de vinculación de productos de socios en la que se envían datos a un anunciante de Display & Video 360 a través de una vinculación de productos entre el socio de datos y el socio principal de Display & Video 360 del anunciante:
{
"destinations": [
{
"operatingAccount": {
"accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
"accountType": "DISPLAY_VIDEO_ADVERTISER"
},
"loginAccount": {
"accountId": "DATA_PARTNER_ID",
"accountType": "DATA_PARTNER"
},
"linkedAccount": {
"accountId": "DISPLAY_VIDEO_PARTNER_ID",
"accountType": "DISPLAY_VIDEO_PARTNER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}
Google Analytics
La API del Administrador de datos no admite el envío de datos a una cuenta de Google Analytics a través de una vinculación del producto. En su lugar, usa el enfoque de los casos prácticos para anunciantes de Google Analytics.
Requisitos detallados
En esta sección, se incluyen requisitos detallados para los campos de la cuenta de un Destination, sugerencias para configurar el product_destination_id y cómo determinar dónde tienen acceso tus credenciales.
Campos de la cuenta
Un Destination puede tener hasta 3 cuentas diferentes:
operating_accountEl campo
operating_accountes obligatorio.El objeto
operating_accountindica qué cuenta recibe los datos en la solicitud.operating_accountpuede ser cualquiera de los siguientes:- Una cuenta de Google Ads
- Una cuenta de anunciante de Display & Video 360
- Una cuenta de socio de Display & Video 360
- Una propiedad de Google Analytics
- Una cuenta de socio de datos si se envían datos a un público que pertenece a la cuenta de socio de datos
login_accountEl
login_accountno siempre es obligatorio y, de forma predeterminada, se establece enoperating_account.La API de Data Manager verifica lo siguiente:
La Cuenta de Google de las credenciales es un usuario en
login_account.El
login_accountes uno de los siguientes:Es igual a
operating_account. Este es el valor predeterminado si no estableceslogin_account.Una cuenta de administrador de Google Ads o de socio de Display & Video 360 que sea principal de la cuenta de
operating_account.Una cuenta de socio de datos con una vinculación de producto a
linked_account.
linked_account-
El objeto
linked_accountindica qué cuenta tiene una vinculación de producto con el objetologin_account.
ID de destino del producto
El product_destination_id de un Destination identifica qué objeto en el operating_account recibe los datos. Por ejemplo, podría ser un ID de público para Google Ads o Display & Video 360, un ID de acción de conversión para Google Ads o un ID de medición para un flujo de Google Analytics.
A continuación, te indicamos cómo encontrar el ID de cada tipo de destino del producto.
Público de Google Ads
El ID de destino del producto para la transferencia de miembros del público es el ID del público.
Para obtener el ID del público desde la IU de Google Ads, sigue estos pasos:
- Ve al Administrador de públicos en la IU de Google Ads.
- Haz clic en el nombre del público para ver los detalles.
- El ID del público se indica junto a ID de la lista.
Para obtener el ID del público desde la API de Google Ads, sigue estos pasos:
Envía una solicitud
SearchoSearchStreamaGoogleAdsServicecon la siguiente consulta:SELECT user_list.id, user_list.name FROM user_list WHERE user_list.name = 'USER_LIST_NAME'Obtén el ID del público del campo
iden el objetouser_listde la respuesta.[ { "results": [ { "userList": { "resourceName": "customers/CUSTOMER_ID/userLists/USER_LIST_ID", "id": "USER_LIST_ID", "name": "USER_LIST_NAME" } } ] } ]
Evento de Google Ads
El ID de destino del producto para la transferencia de eventos es el ID de la acción de conversión.
Para obtener el ID de la acción de conversión en la IU de Google Ads, sigue estos pasos:
- Ve a Conversiones en la IU de Google Ads.
- Haz clic en el nombre de la acción de conversión para ver los detalles.
El ID de la acción de conversión es el valor del parámetro de consulta de URL llamado
ctId.https://ads.google.com/aw/conversions/detail?ocid=...&ctId=CONVERSION_ACTION_ID&...
Para obtener el ID de la acción de conversión de la API de Google Ads, sigue estos pasos:
Envía una solicitud
SearchoSearchStreamaGoogleAdsServicecon la siguiente consulta:SELECT conversion_action.id, conversion_action.name FROM conversion_action WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'Obtén el ID de la acción de conversión del campo
iden el objetoconversion_actionde la respuesta.[ { "results": [ { "conversionAction": { "resourceName": "customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID", "id": "CONVERSION_ACTION_ID", "name": "CONVERSION_ACTION_NAME" } } ] } ]
Público de Display & Video 360
El ID de destino del producto para la transferencia de miembros del público es el ID del público.
Para obtener el ID del público desde la IU de Display & Video 360, sigue estos pasos:
- Accede a la IU de Display & Video 360 en https://displayvideo.google.com.
- Navega al socio o anunciante de Display & Video 360 que usas para
operating_account. - Ve a Públicos en el menú de la izquierda y, luego, selecciona Todos los públicos.
- Busca el público en la lista. El ID del público es el número que aparece junto al nombre en la columna Nombre.
Evento de Google Analytics
El ID de destino del producto para la transferencia de eventos es el ID de medición del flujo de datos.
Determina dónde tienen acceso las credenciales
Las credenciales que usas para autorizar una solicitud a la API de Data Manager están asociadas a una Cuenta de Google específica.
- Si usas credenciales de usuario, las solicitudes se autorizan como la Cuenta de Google del usuario que otorgó permiso para actuar en su nombre cuando generaste las credenciales.
- Si usas credenciales de cuenta de servicio, las solicitudes se autorizan como la Cuenta de Google de la cuenta de servicio.
A continuación, te indicamos cómo verificar que la Cuenta de Google de tus credenciales tenga acceso a una cuenta de Google Ads, Display & Video 360 o Google Analytics.
Google Ads o socio de datos
- Ve a Acceso y seguridad en la IU de Google Ads para
login_account. - Selecciona la pestaña Usuarios.
- Si la cuenta
login_accountes una cuenta de administrador de Google Ads, desactiva el botón de activación Mostrar los usuarios de toda la jerarquía para ocultar los usuarios de las cuentas secundarias. - Verifica que la Cuenta de Google de tus credenciales esté en la lista de cuentas que se muestra en la pestaña Usuarios.
Display & Video 360
- Ve a Administración de usuarios y preferencias de correo electrónico en la IU de Display & Video 360.
- Verifica que la Administración de usuarios muestre que la Cuenta de Google de tus credenciales es un usuario en
login_account.
Google Analytics
- Ve a Administración del acceso a la propiedad en la IU de Google Analytics.
- Confirma que esté seleccionada la propiedad de Google Analytics especificada en
login_account. - Verifica que la Cuenta de Google de tus credenciales tenga el rol de editor o administrador en la propiedad.