Configura destinos y encabezados

Tanto el concepto de Destination como los encabezados de la solicitud aparecen con frecuencia cuando se trabaja con la API de Data Manager. Lee esta guía para comprender cómo configurar destinos y encabezados para diferentes situaciones.

Cuándo usar destinos o encabezados

  • Usa un Destination en las solicitudes de transferencia. Una solicitud de transferencia usa el IngestionService para agregar o quitar miembros de un público o enviar eventos. La lista destinations en un IngestAudienceMembersRequest o IngestEventsRequest define lo siguiente:

    1. Es la cuenta que recibe los datos. Por ejemplo, una cuenta de Google Ads o una propiedad de Google Analytics.
    2. Es la entidad de destino de los datos de la cuenta, como una acción de conversión de Google Ads o un flujo de Google Analytics.
    3. Es la ruta de acceso de las credenciales de la solicitud a la cuenta que recibe los datos.

    Puedes incluir varios destinos en la misma solicitud de transferencia.

  • Usa encabezados de la solicitud en las solicitudes de administración de recursos que crean, actualizan, borran o recuperan recursos. Los encabezados definen la ruta de acceso de las credenciales de la solicitud a la cuenta de destino de la solicitud de administración de recursos. Esta es la lista de recursos con métodos de administración de recursos que admiten encabezados de la solicitud:

Por ejemplo, si deseas crear un público, agregar miembros a él, verificar los diagnósticos y, luego, recuperar el público para verificar su tamaño, aquí tienes cada paso, el tipo de solicitud que debes usar y si debes usar destinos o encabezados de la solicitud:

Paso Tipo de solicitud Encabezados de destino o de solicitud
Cómo crear un público Administración de recursos Encabezados de la solicitud
Cómo agregar miembros a un público Transferencia Destinos
Consultar diagnóstico Transferencia Destinos
Recupera el público Administración de recursos Encabezados de la solicitud

Para alternar entre los detalles de cada tipo de solicitud en esta guía, haz clic en la pestaña Transferencia o Administración de recursos que rodea cada tabla.

Si eres anunciante o agencia, ve a los casos de uso para anunciantes para ver ejemplos de cómo configurar encabezados y crear un Destination:

Si eres un socio de datos, ve a los casos de uso de socios de datos para ver ejemplos de cómo configurar encabezados y construir un Destination para administrar recursos y enviar datos a una cuenta con un vínculo de socio a tu cuenta de socio de datos:

En la sección Requisitos detallados, se abordan los requisitos y las reglas de validación en profundidad.

Situaciones con anunciantes

A continuación, se explica cómo configurar un Destination o encabezados de la solicitud 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 de anunciante.

Ruta de acceso del anunciante

Google Ads

A continuación, se muestra un diagrama con un ejemplo de un conjunto de cuentas y usuarios de Google Ads.

Cuentas y usuarios de Google Ads

Cuenta de administrador M1

M1 tiene dos cuentas secundarias directas:

  1. Cuenta de administrador M2
  2. Cuenta de cliente C1

La Cuenta de Google cloudysanfrancisco@gmail.com es un usuario de M1.

Cuenta de administrador M2

M2 tiene dos cuentas secundarias directas:

  1. Cuenta de cliente C1
  2. Cuenta de cliente C2

La Cuenta de Google baklavainthebalkans@gmail.com es un usuario de A2.

Cuenta de cliente C1

C1 tiene dos cuentas de administrador principales directas:

  1. Cuenta de administrador M1
  2. Cuenta de administrador M2

La Cuenta de Google jeffersonloveshiking@gmail.com es 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 aparecen en la lista es un usuario de C2.

En las situaciones de Acceso directo y Acceso de administrador, se muestra cómo configurar 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:

Transferencia
Destino
operating_account
account_id Es el ID de cliente de la cuenta de Google Ads.
account_type GOOGLE_ADS
login_account No configures 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.
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account No configures el encabezado linked-account.

Este es 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:

Transferencia
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "loginAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID
linked-account No configures el encabezado linked-account.

Situación de acceso de administrador

Si deseas enviar datos a una cuenta de Google Ads y tus credenciales corresponden a una Cuenta de Google que es un usuario de una cuenta de administrador de Google Ads en la que la cuenta del anunciante es una cuenta secundaria, haz lo siguiente:

Transferencia
Destino
operating_account
account_id Es el ID de cliente de la cuenta de cliente de Google Ads.
account_type GOOGLE_ADS
login_account
account_id Es el ID de cliente de la cuenta de administrador de Google Ads.
account_type GOOGLE_ADS
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.
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account No configures el encabezado linked-account.

A continuación, se muestra un ejemplo de una situación de acceso de administrador para la cuenta de cliente de Google Ads C2 del diagrama y las credenciales de la Cuenta de Google baklavainthebalkans@gmail.com:

Transferencia
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account No configures el encabezado linked-account.

Aquí tienes otro ejemplo de una situación de acceso de administrador para la cuenta de cliente de Google Ads C2 y las credenciales de la Cuenta de Google cloudysanfrancisco@gmail.com, que es un usuario de la cuenta de administrador de Google Ads M1:

Transferencia
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID
linked-account No configures el encabezado linked-account.

Display & Video 360

Puedes enviar datos a Display & Video 360 con dos enfoques:

  1. Acceso directo, en el que las credenciales son para una Cuenta de Google que es un usuario en la cuenta de anunciante o socio de Display & Video 360.
  2. 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 del anunciante, haz lo siguiente:

Transferencia
Destino
operating_account
account_id Es el ID de la cuenta del anunciante de Display & Video 360.
account_type DISPLAY_VIDEO_ADVERTISER
login_account No configures 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.
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account No configures el encabezado linked-account.

A continuación, se muestra un ejemplo de un Destination para un caso de acceso directo que envía datos a un anunciante de Display & Video 360:

Transferencia
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account No configures el encabezado linked-account.

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:

Transferencia
Destino
operating_account
account_id Es el ID de la cuenta de socio de Display & Video 360.
account_type DISPLAY_VIDEO_PARTNER
login_account No configures 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.
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account No configures el encabezado linked-account.

Este es un ejemplo de un Destination para un caso de acceso directo que envía datos a un socio de Display & Video 360:

Transferencia
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account No configures el encabezado linked-account.

Situación de acceso de socios de Display & Video 360

Si deseas enviar datos a un anunciante de Display & Video 360 y tus credenciales son para una Cuenta de Google que es un usuario en la cuenta de socio principal de Display & Video 360 del anunciante, haz lo siguiente:

Transferencia
Destino
operating_account
account_id Es el ID de la cuenta del anunciante de Display & Video 360.
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id Es el ID de la cuenta de socio de Display & Video 360.
account_type DISPLAY_VIDEO_PARTNER
linked_account No configures el campo linked_account.
product_destination_id Es el ID del público.
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account No configures el encabezado linked-account.

Este es un ejemplo de un Destination para un caso de acceso de socio para enviar datos a un anunciante de Display & Video 360. En este caso, las credenciales deben ser de una Cuenta de Google que sea un usuario de la cuenta de socio de Display & Video 360 DISPLAY_VIDEO_PARTNER_ID, y la cuenta de anunciante de Display & Video 360 DISPLAY_VIDEO_ADVERTISER_ID debe ser secundaria de la cuenta de socio DISPLAY_VIDEO_PARTNER_ID.

Transferencia
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account No configures el encabezado linked-account.

Google Analytics

Nota: Si el operating_account es una cuenta de Google Analytics, no configures el login_account o configúralo con los mismos valores que el operating_account. De lo contrario, la solicitud fallará con el error OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

Transferencia
Destino
operating_account
account_id Es el ID de la propiedad de Google Analytics.
account_type GOOGLE_ANALYTICS_PROPERTY
login_account No configures login_account o configúralo con los mismos valores que operating_account.
linked_account No configures el campo linked_account.
product_destination_id
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account No configures el encabezado linked-account.

Este es un ejemplo de un Destination para enviar eventos a Google Analytics:

Transferencia
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account No configures el encabezado linked-account.

Floodlight

Transferencia
Destino
operating_account
account_id Es el ID de configuración de Floodlight
Si tu anunciante es secundario de un anunciante superior, usa el ID del anunciante superior en Campaign Manager 360 como tu ID de configuración de Floodlight. De lo contrario, usa el ID de tu anunciante. Consulta cómo encontrar el ID de anunciante en la IU de Campaign Manager 360.
account_type FLOODLIGHT_CONFIG
login_account No configures login_account o configúralo con los mismos valores que operating_account.
linked_account No configures el campo linked_account.
product_destination_id El ID de la actividad de Floodlight

Este es un ejemplo de un Destination para enviar eventos a Floodlight:

Transferencia
        {
          "destinations": [
            {
              "operatingAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "loginAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "productDestinationId": "FLOODLIGHT_ACTIVITY_ID"
            }
          ]
        }

Situaciones de socios de datos

A continuación, se muestra cómo configurar un Destination para situaciones comunes de un socio de datos que envía datos a cuentas de anunciantes con un vínculo de socio establecido 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 un vínculo de socio.

Ruta de acceso para socios de datos

Google Ads

Este es un diagrama que muestra un ejemplo de un conjunto de cuentas de Google Ads y de socios de datos. En el diagrama, también se 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 socios entre las cuentas.

Usuarios y cuentas de Google Ads y de socios de datos

Socio de datos D1

Existe un vínculo de socio entre D1 y la cuenta de administrador de Google Ads M2.

La Cuenta de Google 222larabrown@gmail.com es un usuario en D1.

Socio de datos D2

Existe un vínculo de socio entre D2 y la cuenta de cliente de Google Ads C1.

La Cuenta de Google jeffersonloveshiking@gmail.com es un usuario en D2.

Cuenta de administrador M1

M1 tiene dos cuentas secundarias directas:

  1. Cuenta de administrador M2
  2. Cuenta de cliente C1
Cuenta de administrador M2

M2 tiene dos cuentas secundarias directas:

  1. Cuenta de cliente C1
  2. Cuenta de cliente C2
Cuenta de cliente C1

C1 tiene dos cuentas de administrador principales directas:

  1. Cuenta de administrador M1
  2. 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 el socio de datos D1

Para actuar como socio de datos D1, usa las credenciales de la Cuenta de Google 222larabrown@gmail.com para lo siguiente:

  • Envía datos a la cuenta de cliente C1 o C2 con un destino en el que login_account se establezca en la cuenta de socio de datos D1 y linked_account se establezca en la cuenta de administrador M2.

  • Envía datos directamente a la cuenta de administrador M2 con un destino que tenga login_account establecido en la cuenta de socio de datos D1. No establezcas linked_account.

Como socio de datos D1, no puedes enviar datos a la cuenta de administrador M1 porque no hay una vinculación de socio entre D1 y M1.

Actúa como el socio de datos D2

Para actuar como socio de datos D2, usa las credenciales de la Cuenta de Google jeffersonloveshiking@gmail.com para enviar datos a la cuenta de cliente C1, con un destino con login_account establecido en la cuenta de socio de datos D2. No establezcas linked_account.

Como socio de datos D2, no puedes enviar datos a la cuenta de administrador M1, la cuenta de administrador M2 ni la cuenta de cliente C2 porque no hay una vinculación de socio entre D2 y ninguna de esas cuentas o sus cuentas de administrador principal.

La diferencia clave entre los socios de datos D1 y D2 es cómo se vincula el socio de datos con las cuentas de Google Ads.

Situación de vinculación directa con el socio

Si deseas enviar datos a una cuenta de Google Ads y la vinculación de socios se realiza entre la cuenta de Google Ads y tu cuenta de socio de datos, haz lo siguiente:

Transferencia
Destino
operating_account
account_id Es el ID de cliente de la cuenta de Google Ads.
account_type GOOGLE_ADS
login_account
account_id Es el ID de cliente de la cuenta del socio de datos.
account_type DATA_PARTNER
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.
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account No configures el encabezado linked-account.

Este es un ejemplo de una situación de vínculo de socio directo con cuentas del diagrama y los encabezados de solicitud correspondientes para las solicitudes de administración de recursos. En esta situación, el socio de datos D2 envía datos de miembros del público al cliente final del intermediario de Google Ads C1 con el vínculo de socio entre D2 y C1, y las credenciales de la Cuenta de Google jeffersonloveshiking@gmail.com:

Transferencia
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID
linked-account No configures el encabezado linked-account.

Situación de vinculación de socios administradores

Si deseas enviar datos a una cuenta de Google Ads y la vinculación de socio se realiza entre una cuenta de administrador de Google Ads superior y tu cuenta de socio de datos, haz lo siguiente:

Transferencia
Destino
operating_account
account_id Es el ID de cliente de la cuenta de cliente de Google Ads.
account_type GOOGLE_ADS
login_account
account_id Es el ID de cliente de la cuenta del socio de datos.
account_type DATA_PARTNER
linked_account
account_id Es el ID de cliente de la cuenta de administrador de Google Ads.
account_type GOOGLE_ADS
product_destination_id Es el ID del público o de la acción de conversión.
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID

Este es un ejemplo de una situación de vinculación de socios administradores con cuentas del diagrama. En esta situación, el socio de datos D1 envía datos de miembros del público al cliente final del intermediario de Google Ads C2 con el vínculo de socio entre D1 y M2, y las credenciales de la Cuenta de Google 222larabrown@gmail.com:

Transferencia
{
  "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"
    }
  ]
}
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID
linked-account accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID

Display & Video 360

Como socio de datos, puedes enviar datos a una cuenta de Display & Video 360 de dos maneras:

  1. Usa un vínculo de socio directo entre una cuenta de socio de datos y la cuenta de socio o anunciante de Display & Video 360.
  2. Envía datos a un anunciante de Display & Video 360 con un vínculo de socio entre una cuenta de socio de datos y la cuenta de socio principal de Display & Video 360 del anunciante.

Si quieres enviar datos a un anunciante de Display & Video 360 y la vinculación de socio se realiza entre la cuenta del anunciante de Display & Video 360 y tu cuenta de socio de datos, haz lo siguiente:

Transferencia
Destino
operating_account
account_id Es el ID de la cuenta del anunciante de Display & Video 360.
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id Es el ID de cliente de la cuenta del socio de datos.
account_type DATA_PARTNER
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.
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account No configures el encabezado linked-account.

Este es un ejemplo de un Destination para una situación de vinculación directa de socios con el objetivo de enviar datos a un anunciante de Display & Video 360, y los encabezados de la solicitud correspondientes para las solicitudes de administración de recursos:

Transferencia
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account No configures el encabezado linked-account.

Si quieres enviar datos a una cuenta de socio de Display & Video 360, debes tener una vinculación de socio entre la cuenta de socio de Display & Video 360 y tu cuenta de socio de datos.

Transferencia
Destino
operating_account
account_id Es el ID de la cuenta de socio de Display & Video 360.
account_type DISPLAY_VIDEO_PARTNER
login_account
account_id Es el ID de cliente de la cuenta del socio de datos.
account_type DATA_PARTNER
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.
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account No configures el encabezado linked-account.

A continuación, se muestra un ejemplo de un Destination para un caso de vinculación directa de socios con el objetivo de enviar datos a un socio de Display & Video 360, y los encabezados de la solicitud correspondientes para las solicitudes de administración de recursos:

Transferencia
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account No configures el encabezado linked-account.

Si deseas enviar datos a un anunciante de Display & Video 360 y la vinculación de socio a tu cuenta de socio de datos es con una cuenta de socio de Display & Video 360 en la que la cuenta del anunciante es una cuenta secundaria, sigue estos pasos:

Transferencia
Destino
operating_account
account_id Es el ID de la cuenta del anunciante de Display & Video 360.
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id Es el ID de cliente de la cuenta del socio de datos.
account_type DATA_PARTNER
linked_account
account_id Es el ID de la cuenta de socio de Display & Video 360.
account_type DISPLAY_VIDEO_PARTNER
product_destination_id Es el ID del público o de la acción de conversión.
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

A continuación, se muestra un ejemplo de un Destination para un caso de vinculación de socios en el que se envían datos a un anunciante de Display & Video 360 con un vínculo de socio entre el socio de datos y el socio principal de Display & Video 360 del anunciante:

Transferencia
{
  "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"
    }
  ]
}
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Google Ad Manager

Si deseas enviar datos a una cuenta de Google Ad Manager y tienes un vínculo de socio entre tu cuenta de socio de datos y la cuenta de Google Ad Manager, sigue estos pasos:

Transferencia
Destino
operating_account
account_id El ID de vinculación de público de la cuenta de Google Ad Manager
account_type GOOGLE_AD_MANAGER_AUDIENCE_LINK
login_account
account_id Es el ID de cliente de la cuenta del socio de datos.
account_type DATA_PARTNER
linked_account No configures el campo linked_account.
product_destination_id Es el ID del público.
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account No configures el encabezado linked-account.

A continuación, se muestra un ejemplo de un Destination para enviar datos a una cuenta de Google Ad Manager con un vínculo de socio:

Transferencia
      {
        "destinations": [
          {
            "operatingAccount": {
              "accountId": "GAM_AUDIENCE_LINK_ID",
              "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK"
            },
            "loginAccount": {
              "accountId": "DATA_PARTNER_ID",
              "accountType": "DATA_PARTNER"
            },
            "productDestinationId": "AUDIENCE_ID"
          }
        ]
      }
Administración de recursos
Encabezados de la solicitud
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account No configures el encabezado linked-account.

Google Analytics

La API de Data Manager no admite el envío de datos a una cuenta de Google Analytics con un vínculo de socio. En su lugar, usa el enfoque de situaciones de anunciantes para Google Analytics.

Floodlight

La API de Data Manager no admite el envío de datos a un parámetro de configuración de Floodlight con un vínculo de socio. En su lugar, usa el enfoque de situaciones de anunciantes para Floodlight.

Requisitos detallados

En esta sección, se incluyen los requisitos detallados para los campos de cuenta de un Destination para una solicitud IngestionService, los encabezados de solicitud equivalentes para las solicitudes de administración de recursos, 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_account

El operating_account es obligatorio.

El operating_account indica qué cuenta recibe los datos en la solicitud. El operating_account puede ser cualquiera de los siguientes:

No hay un encabezado de la solicitud que corresponda al campo operating_account de un Destination. Cuando se envía una solicitud de administración de recursos, la cuenta de destino de la solicitud es la cuenta operativa.

Campo login_account y encabezado de la solicitud login-account

El login_account no siempre es obligatorio y, de forma predeterminada, se establece en el operating_account en una solicitud IngestionService y en la cuenta de destino en una solicitud de administración de recursos. En una solicitud de administración de recursos, usa el encabezado de la solicitud login-account para identificar la cuenta de acceso.

La API de Data Manager verifica lo siguiente:

  1. La Cuenta de Google de las credenciales es un usuario de la cuenta de facturación.

  2. La cuenta de acceso es una de las siguientes:

    • Es igual que el operating_account. Este es el valor predeterminado si no estableces el login_account de un Destination en una solicitud IngestionService o no estableces el encabezado login-account en una solicitud de administración de recursos.

    • Una cuenta de administrador de Google Ads o de socio de Display & Video 360 que sea superior de la operating_account en una solicitud IngestionService o superior de la cuenta de destino en una solicitud de administración de recursos.

    • Una cuenta de socio de datos con un vínculo de socio al linked_account en una solicitud IngestionService o el encabezado linked-account en una solicitud de administración de recursos.

Campo linked_account y encabezado de la solicitud linked-account

El linked_account indica qué cuenta tiene un vínculo de socio con el login_account de una solicitud de IngestionService o la cuenta de destino de una solicitud de administración de recursos.

ID de destino del producto

El product_destination_id de un Destination identifica qué objeto de la 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 datos de Google Analytics.

A continuación, te indicamos cómo encontrar el ID de cada tipo de destino de producto.

Público de Google Ads

El ID de destino del producto para transferir miembros del público es el ID del público. Recupera este ID con la IU de Google Ads o la API de Data Manager.

Para obtener el ID de público de la IU de Google Ads, sigue estos pasos:

  1. Ve al Administrador de públicos en la IU de Google Ads.
  2. Haz clic en el nombre del público para ver los detalles.
  3. El ID de público aparece junto a ID de lista.

API de Data Manager

Recupera el UserList con el método List, proporcionando encabezados de la solicitud si es necesario, y usa el id del UserList para el ID de destino del producto.

Evento de Google Ads

El ID de destino del producto para transferir eventos es el ID de acción de conversión. Recupera este ID con la IU o la API de Google Ads.

Para obtener el ID de la acción de conversión desde la IU de Google Ads, sigue estos pasos:

  1. Ve a Conversiones en la IU de Google Ads.
  2. Haz clic en el nombre de la acción de conversión.
  3. Ve a la pestaña Detalles.
  4. El ID de acción de conversión es el número que aparece junto a ID de tipo de conversión.

Para obtener el ID de la acción de conversión de la API de Google Ads, sigue estos pasos:

  1. Envía una solicitud Search o SearchStream a GoogleAdsService con la siguiente consulta:

      SELECT
    conversion_action.id,
    conversion_action.name
  FROM conversion_action
  WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'

  2. Obtén el ID de acción de conversión del campo id en el conversion_action de 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 transferir miembros del público es el ID del público. Recupera este ID con la IU de Display & Video 360 o la API de Data Manager.

IU de Display & Video 360

Para obtener el ID de público de la IU de Display & Video 360, sigue estos pasos:

  1. Accede a la IU de Display & Video 360 en https://displayvideo.google.com.
  2. Navega al socio o anunciante de Display & Video 360 que usas para el operating_account.
  3. Ve a Públicos en el menú de la izquierda y, luego, selecciona Todos los públicos.
  4. Busca el público en la lista. El ID de público es el número que aparece junto al nombre en la columna Nombre.

API de Data Manager

Recupera el UserList con el método List, proporcionando encabezados de la solicitud si es necesario, y usa el id del UserList para el ID de destino del producto.

Evento de Google Analytics

El ID de destino del producto depende del tipo de flujo de datos.

Flujo de datos web
Usa el ID de medición del flujo de datos.
Flujo de datos de aplicación

Usa el ID de la app de Firebase del flujo de datos. Estas son dos opciones para encontrar tu ID de app de Firebase:

Evento de Floodlight

El ID de destino del producto para transferir eventos a Floodlight es el ID de la actividad de Floodlight. Recupera este ID con la IU o la API de Campaign Manager 360.

IU de Campaign Manager 360

Para obtener el ID de la actividad de Floodlight desde la IU de Campaign Manager 360, sigue estos pasos:

  1. Accede a la IU de Campaign Manager 360.
  2. Navega al anunciante de Campaign Manager 360 que usas para el operating_account.
  3. Ve a Floodlight en el menú de la izquierda y, luego, selecciona Actividades.
  4. Busca la actividad de Floodlight en la lista. El ID es el número que aparece junto al nombre en la columna Nombre de la actividad.

API de Campaign Manager 360

Para obtener el ID de la actividad de Floodlight desde la API de Campaign Manager 360, sigue estos pasos:

  1. Envía una solicitud list al recurso floodlightActivities.
  2. Especifica el floodlightConfigurationId de la configuración de Floodlight.
  3. De forma opcional, usa el parámetro searchString para filtrar por nombre de actividad.
  4. Obtén el ID de la actividad de Floodlight del campo id del FloodlightActivity seleccionado en la respuesta.

Determina dónde tienen acceso las credenciales

Las credenciales que usas para autorizar una solicitud a la API de Data Manager están asociadas con 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, se explica cómo verificar que la Cuenta de Google de tus credenciales tenga acceso a una cuenta de Google Ads, Display & Video 360, Google Analytics o Campaign Manager 360.

Google Ads o socio de datos

  1. Ve a Acceso y seguridad en la IU de Google Ads para el login_account.
  2. Selecciona la pestaña Usuarios.
  3. Si el login_account es 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.
  4. 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

  1. Ve a Administración de usuarios y preferencias de correo electrónico en la IU de Display & Video 360.
  2. Verifica que la Administración de usuarios muestre que la Cuenta de Google de tus credenciales es un usuario en login_account.

Google Analytics

  1. Ve a Administración de accesos a la propiedad en la IU de Google Analytics.
  2. Confirma que esté seleccionada la propiedad de Google Analytics especificada en el login_account.
  3. Verifica que la Cuenta de Google de tus credenciales tenga el rol de editor o administrador en la propiedad.

Floodlight (Campaign Manager 360)

  1. Accede a la IU de Campaign Manager 360.
  2. Ve a Administrador > Perfiles de usuario en el menú de la izquierda.
  3. Verifica que la Cuenta de Google de tus credenciales esté en la lista de perfiles que se muestra.
  4. Haz clic en el perfil y verifica que tenga acceso a la cuenta de anunciante que se usa como login_account. Si no estableces un login_account en la solicitud, se usa el valor predeterminado operating_account. Asegúrate de que la cuenta tenga un rol del usuario con el permiso Insertar conversiones sin conexión.
Siguiente
Da formato a los datos del usuario