Configura destinos y encabezados

El concepto de Destination y los encabezados de 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 IngestionService para agregar o quitar miembros de un público, o bien 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 dentro 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.

  Nota: No configures encabezados de solicitud en una solicitud de IngestionService. La API de Data Manager ignora los encabezados en una solicitud de transferencia.

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

  • Insights
  • PartnerLink
  • UserList
  • UserListDirectLicense
  • UserListGlobalLicense
  • UserListGlobalLicenseCustomerInfo

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í se indican los pasos, el tipo de solicitud que debes usar y si debes usar destinos o encabezados de 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

Haz clic en la pestaña Ingestion o Resource management que rodea cada tabla para alternar entre los detalles de esta guía para cada tipo de solicitud.

Si eres anunciante o agencia, consulta los casos prácticos para anunciantes y obtén ejemplos de cómo configurar encabezados y crear un Destination:

• Google Ads
• Display & Video 360
• Google Analytics

Si eres socio de datos, consulta los casos de uso de socios de datos para ver ejemplos de cómo configurar encabezados y construir un objeto Destination para administrar recursos y enviar datos a una cuenta con una vinculación de producto a tu cuenta de socio de datos:

• Google Ads
• Display & Video 360
• Google Analytics

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 encabezado Destination o de 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 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:

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

La Cuenta de Google [e-mail] es un usuario en 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 [e-mail] es un usuario de A2.

Cuenta de cliente C1

C1 tiene dos cuentas de administrador principal directas:

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

La Cuenta de Google [e-mail] 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 se indican es un usuario de C2.

Las situaciones de acceso directo y 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 son para una Cuenta de Google que es un usuario de la cuenta de Google Ads, sigue estos pasos:

Transferencia

Destino
operating_account	account_id Es el ID de cliente de la cuenta de Google Ads. account_type GOOGLE_ADS
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.

Administración de recursos

Encabezados de la solicitud
login-account	accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account	No establezcas el encabezado linked-account.

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 [e-mail]:

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 establezcas el encabezado linked-account.

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:

Transferencia

Destino
operating_account	account_id ID de cliente de la cuenta de cliente de Google Ads account_type GOOGLE_ADS
login_account	account_id 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 establezcas el encabezado linked-account.

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 [e-mail]:

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 establezcas el encabezado linked-account.

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 [e-mail], que es un usuario de la cuenta de administrador M1 de Google Ads:

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 establezcas el encabezado linked-account.

Display & Video 360

Puedes enviar datos a Display & Video 360 de dos maneras:

1. 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
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 de 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 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.

Administración de recursos

Encabezados de la solicitud
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	No establezcas el encabezado linked-account.

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:

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 establezcas 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 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.

Administración de recursos

Encabezados de la solicitud
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	No establezcas el encabezado linked-account.

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:

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 establezcas el encabezado linked-account.

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:

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 establezcas el encabezado linked-account.

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 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 establezcas el encabezado linked-account.

Google Analytics

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

Transferencia

Destino
operating_account	account_id ID de la propiedad de Google Analytics account_type GOOGLE_ANALYTICS_PROPERTY
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.

Administración de recursos

Encabezados de la solicitud
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	No establezcas el encabezado linked-account.

Este es un ejemplo de un objeto 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 establezcas el encabezado linked-account.

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.

Nota: En todos los casos de socios de datos, las credenciales deben ser para una Cuenta de Google que sea un usuario en 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 [e-mail] es 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 [e-mail] es un usuario en D2.

Cuenta de administrador M1

La cuenta 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 principal 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 socio de datos D1

Para actuar como socio de datos D1, usa las credenciales de la Cuenta de Google [e-mail] para enviar datos a la cuenta de administrador A2, la cuenta de cliente C1 o la cuenta de cliente C2, con un destino que tenga login_account establecido en la cuenta de socio de datos D1 y linked_account establecido 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 [e-mail] para enviar datos a la cuenta de cliente C1, con un destino que tenga login_account establecido en la cuenta de socio de datos D2 y linked_account establecido 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 cómo 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:

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 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 establezcas el encabezado linked-account.

A continuación, se muestra un ejemplo de una situación de vínculo directo al producto en la que se usan cuentas del diagrama y los encabezados de solicitud correspondientes para las solicitudes de administración de recursos. En este caso, 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 [e-mail]:

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 establezcas el encabezado linked-account.

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:

Transferencia

Destino
operating_account	account_id ID de cliente de la cuenta de cliente de Google Ads account_type GOOGLE_ADS
login_account	account_id ID de cliente de la cuenta del socio de datos account_type DATA_PARTNER
linked_account	account_id 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

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 [e-mail]:

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. 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.
2. Enviar datos a un anunciante de Display & Video 360 a través de una vinculación de productos 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:

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 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 establezcas el encabezado linked-account.

A continuación, se muestra un ejemplo de un objeto Destination para una situación de vínculo directo al producto para enviar datos a un anunciante de Display & Video 360, y los encabezados de 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 establezcas el encabezado linked-account.

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.

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 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 establezcas el encabezado linked-account.

A continuación, se muestra un ejemplo de un objeto Destination para una situación de vínculo directo al producto para enviar datos a un socio de Display & Video 360, y los encabezados de 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 establezcas el encabezado linked-account.

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:

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

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 Analytics

La API de Data Manager 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 para una solicitud de 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 a qué recursos tienen acceso tus credenciales.

Campos de la cuenta

Un Destination puede tener hasta 3 cuentas diferentes:

operating_account

El campo operating_account es obligatorio.

El objeto operating_account indica qué cuenta recibe los datos en la solicitud. operating_account puede 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

No hay un encabezado de 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 solicitud login-account

El parámetro login_account no siempre es obligatorio y, de forma predeterminada, se establece en el parámetro 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 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 acceso.

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

   • Es igual a operating_account. Este es el valor predeterminado si no configuras el login_account de un Destination en una solicitud de IngestionService o si no configuras 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 principal de operating_account en una solicitud de IngestionService, o bien principal de la cuenta de destino en una solicitud de administración de recursos.

   • Una cuenta de socio de datos con una vinculación de producto a linked_account en una solicitud de IngestionService o el encabezado linked-account en una solicitud de administración de recursos

Campo linked_account y encabezado de solicitud linked-account

Nota: Solo especifica una cuenta vinculada si la cuenta de acceso tiene account_type establecida en DATA_PARTNER y un elemento superior de operating_account está vinculado a la cuenta del socio de datos. Si el objeto operating_account está vinculado directamente a la cuenta del socio de datos, no establezcas linked_account.

El linked_account indica qué cuenta tiene una vinculación de producto 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 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. Recupera este ID con la IU de Google Ads o la API de Data Manager.

IU de Google Ads

Para obtener el ID del público desde 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 del público se indica junto a ID de la lista.

API de Data Manager

Recupera el UserList con el método List, proporciona encabezados de 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 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:

1. Ve a Conversiones en la IU de Google Ads.
2. Haz clic en el nombre de la acción de conversión para ver los detalles.

3. 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:

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 la acción de conversión del campo id en el objeto 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 la transferencia de 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 del público desde 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 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 del 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, proporciona encabezados de 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 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

1. Ve a Acceso y seguridad en la IU de Google Ads para login_account.
2. Selecciona la pestaña Usuarios.
3. Si la cuenta 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 del acceso a la propiedad en la IU de Google Analytics.
2. Confirma que esté seleccionada la propiedad de Google Analytics especificada en login_account.
3. Verifica que la Cuenta de Google de tus credenciales tenga el rol de editor o administrador en la propiedad.