Configurer les destinations et les en-têtes

Le concept Destination et les en-têtes de requête apparaissent fréquemment lorsque vous utilisez l'API Data Manager. Lisez ce guide pour comprendre comment configurer les destinations et les en-têtes pour différents scénarios.

Quand utiliser des destinations ou des en-têtes ?

• Utilisez un Destination dans les requêtes d'ingestion. Une demande d'ingestion utilise IngestionService pour ajouter ou supprimer des membres d'une audience, ou envoyer des événements. La liste destinations dans un IngestAudienceMembersRequest ou un IngestEventsRequest définit :

  1. Compte qui reçoit les données. Par exemple, un compte Google Ads ou une propriété Google Analytics.
  2. Entité de destination des données dans le compte, telle qu'une action de conversion Google Ads ou un flux Google Analytics.
  3. Chemin d'accès aux identifiants de la requête pour le compte qui reçoit les données.

  Vous pouvez inclure plusieurs destinations dans la même demande d'ingestion.

  Conseil : Ne définissez pas d'en-têtes de requête dans une requête IngestionService. L'API Data Manager ignore les en-têtes d'une requête d'ingestion.

• Utilisez des en-têtes de requête dans les requêtes de gestion des ressources qui créent, mettent à jour, suppriment ou récupèrent des ressources. Les en-têtes définissent le chemin d'accès des identifiants de la requête au compte cible de la requête de gestion des ressources. Voici la liste des ressources avec des méthodes de gestion des ressources qui acceptent les en-têtes de requête :

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

Par exemple, si vous souhaitez créer une audience, y ajouter des membres, vérifier les diagnostics, puis récupérer l'audience pour vérifier sa taille, voici chaque étape, le type de requête à utiliser et si vous devez utiliser des destinations ou des en-têtes de requête :

Étape	Type de requête	En-têtes de destination ou de requête
Créer une audience	Gestion des ressources	En-têtes de requête
Ajouter des membres à une audience	Ingestion	Destinations
Vérifier les diagnostics	Ingestion	Destinations
Récupérer l'audience	Gestion des ressources	En-têtes de requête

Pour passer d'un type de requête à un autre, cliquez sur l'onglet Ingestion ou Gestion des ressources au-dessus de chaque tableau.

Si vous êtes un annonceur ou une agence, passez aux scénarios pour les annonceurs pour obtenir des exemples de configuration des en-têtes et de construction d'un Destination :

• Google Ads
• Display & Video 360
• Google Analytics

Si vous êtes un partenaire pour les données, accédez aux scénarios de partenaire pour les données pour obtenir des exemples de configuration des en-têtes et de construction d'un Destination permettant de gérer les ressources et d'envoyer des données à un compte avec un lien produit vers votre compte de partenaire pour les données :

• Google Ads
• Display & Video 360
• Google Analytics

La section Exigences détaillées décrit en détail les exigences et les règles de validation.

Scénarios pour les annonceurs

Voici comment configurer un Destination ou des en-têtes de requête pour les scénarios courants pour les annonceurs et les agences. Ce schéma montre comment l'API Data Manager utilise les identifiants et les champs Destination pour accéder au compte de l'annonceur.

Google Ads

Voici un schéma montrant un exemple d'ensemble de comptes et d'utilisateurs Google Ads.

Compte administrateur M1

M1 comporte deux comptes enfants directs :

1. Compte administrateur M2
2. Compte client C1

Le compte Google [e-mail] est un utilisateur dans M1.

Compte administrateur M2

M2 dispose de deux comptes enfants directs :

1. Compte client C1
2. Compte client C2

Le compte Google [e-mail] est un utilisateur dans M2.

Compte client C1

C1 a deux comptes administrateur parents directs :

1. Compte administrateur M1
2. Compte administrateur M2

Le compte Google [e-mail] est un utilisateur de C1.

Compte client C2

Le compte administrateur M2 est le seul parent direct de C2.

Aucun des comptes Google listés n'est un utilisateur dans C2.

Les scénarios d'accès direct et d'accès administrateur montrent comment configurer une destination pour envoyer des données à ces comptes.

Scénario d'accès direct

Si vous souhaitez envoyer des données à un compte Google Ads et que vos identifiants correspondent à un compte Google qui est un utilisateur du compte Google Ads :

Ingestion

Destination
operating_account	account_id Numéro client du compte Google Ads account_type GOOGLE_ADS
login_account	Ne définissez pas login_account ou définissez-le sur les mêmes valeurs que operating_account.
linked_account	Ne définissez pas le champ linked_account.
product_destination_id	ID de l'audience ou de l'action de conversion.

Gestion des ressources

En-têtes de requête
login-account	accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Voici un exemple de scénario d'accès direct, utilisant les comptes du diagramme et les identifiants du compte Google [e-mail] :

Ingestion

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

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

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Gestion des ressources

En-têtes de requête
login-account	accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Scénario d'accès administrateur

Si vous souhaitez envoyer des données à un compte Google Ads et que vos identifiants correspondent à un compte Google qui est un utilisateur d'un compte administrateur Google Ads où le compte annonceur est un compte enfant :

Ingestion

Destination
operating_account	account_id Numéro client du compte client Google Ads account_type GOOGLE_ADS
login_account	account_id Numéro client du compte administrateur Google Ads account_type GOOGLE_ADS
linked_account	Ne définissez pas le champ linked_account.
product_destination_id	ID de l'audience ou de l'action de conversion.

Gestion des ressources

En-têtes de requête
login-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Voici un exemple de scénario d'accès administrateur pour le compte client Google Ads C2 à partir du diagramme et des identifiants du compte Google [e-mail] :

Ingestion

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Gestion des ressources

En-têtes de requête
login-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Voici un autre exemple de scénario d'accès administrateur pour le compte client Google Ads C2 et les identifiants du compte Google [e-mail], qui est un utilisateur du compte administrateur Google Ads M1 :

Ingestion

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Gestion des ressources

En-têtes de requête
login-account	accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Display & Video 360

Vous pouvez envoyer des données à Display & Video 360 de deux manières :

1. Accès direct, où les identifiants concernent un compte Google qui est un utilisateur du compte d'annonceur ou de partenaire Display & Video 360.
2. Accès partenaire Display & Video 360, où les identifiants correspondent à un compte Google qui est un utilisateur du compte partenaire Display & Video 360, et où le compte opérationnel est un compte d'annonceur Display & Video 360 sous le compte partenaire.

Scénarios d'accès direct

Si vous souhaitez envoyer des données à un compte annonceur Display & Video 360 et que vos identifiants correspondent à un compte Google qui est un utilisateur du compte annonceur :

Ingestion

Destination
operating_account	account_id ID du compte annonceur Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	Ne définissez pas login_account ou définissez-le sur les mêmes valeurs que operating_account.
linked_account	Ne définissez pas le champ linked_account.
product_destination_id	ID de l'audience.

Gestion des ressources

En-têtes de requête
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Voici un exemple de Destination pour un scénario d'accès direct permettant d'envoyer des données à un annonceur Display & Video 360 :

Ingestion

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Gestion des ressources

En-têtes de requête
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

De même, si vous souhaitez envoyer des données à un compte partenaire Display & Video 360 et que vos identifiants correspondent à un compte Google qui est un utilisateur du compte partenaire :

Ingestion

Destination
operating_account	account_id ID du compte de partenaire Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
login_account	Ne définissez pas login_account ou définissez-le sur les mêmes valeurs que operating_account.
linked_account	Ne définissez pas le champ linked_account.
product_destination_id	ID de l'audience.

Gestion des ressources

En-têtes de requête
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Voici un exemple de Destination pour un scénario d'accès direct permettant d'envoyer des données à un partenaire Display & Video 360 :

Ingestion

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Gestion des ressources

En-têtes de requête
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Scénario d'accès partenaire Display & Video 360

Si vous souhaitez envoyer des données à un annonceur Display & Video 360 et que vos identifiants concernent un compte Google qui est un utilisateur du compte partenaire parent Display & Video 360 de l'annonceur :

Ingestion

Destination
operating_account	account_id ID du compte annonceur Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id ID du compte de partenaire Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
linked_account	Ne définissez pas le champ linked_account.
product_destination_id	ID de l'audience.

Gestion des ressources

En-têtes de requête
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Voici un exemple de Destination pour un scénario d'accès partenaire permettant d'envoyer des données à un annonceur Display & Video 360. Dans ce scénario, les identifiants doivent correspondre à un compte Google qui est un utilisateur du compte partenaire Display & Video 360 DISPLAY_VIDEO_PARTNER_ID, et le compte annonceur Display & Video 360 DISPLAY_VIDEO_ADVERTISER_ID doit être un compte enfant du compte partenaire DISPLAY_VIDEO_PARTNER_ID.

Ingestion

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Gestion des ressources

En-têtes de requête
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Google Analytics

Remarque : Si le operating_account est un compte Google Analytics, ne définissez pas le login_account ou définissez-le sur les mêmes valeurs que le operating_account. Sinon, la requête échoue et l'erreur OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH s'affiche.

Ingestion

Destination
operating_account	account_id ID de la propriété Google Analytics account_type GOOGLE_ANALYTICS_PROPERTY
login_account	Ne définissez pas login_account ou définissez-le sur les mêmes valeurs que operating_account.
linked_account	Ne définissez pas le champ linked_account.
product_destination_id	ID de mesure du flux de données.

Gestion des ressources

En-têtes de requête
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Voici un exemple de Destination pour envoyer des événements à Google Analytics :

Ingestion

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}

Gestion des ressources

En-têtes de requête
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Scénarios de partenaires pour les données

Voici comment configurer un Destination pour les scénarios courants d'un partenaire de données qui envoie des données à des comptes d'annonceurs avec une association de produit établie au compte de partenaire de données.

Remarque : Dans tous les scénarios de partenaires de données, les identifiants doivent correspondre à un compte Google qui est un utilisateur du compte de partenaire de données.

Ce schéma montre comment l'API Data Manager utilise les identifiants et les champs Destination pour accéder au compte de l'annonceur via un lien vers un produit.

Google Ads

Voici un schéma montrant un exemple d'ensemble de comptes Google Ads et de partenaires de données. Le diagramme indique également le compte Google auquel un utilisateur est associé dans chaque compte Google Ads ou de partenaire de données, ainsi que les associations de produits entre les comptes.

Partenaire pour les données D1

Une association de produits existe entre D1 et le compte administrateur Google Ads M2.

Le compte Google [e-mail] est un utilisateur dans D1.

Partenaire pour les données D2

Une association de produits existe entre D2 et le compte client Google Ads C1.

Le compte Google [e-mail] est un utilisateur dans D2.

Compte administrateur M1

M1 comporte deux comptes enfants directs :

1. Compte administrateur M2
2. Compte client C1

Compte administrateur M2

M2 dispose de deux comptes enfants directs :

1. Compte client C1
2. Compte client C2

Compte client C1

C1 a deux comptes administrateur parents directs :

1. Compte administrateur M1
2. Compte administrateur M2

Compte client C2

Le compte administrateur M2 est le seul parent direct de C2.

Voici ce que vous pouvez faire avec cet ensemble de comptes :

Agir en tant que partenaire pour les données D1

Pour agir en tant que partenaire de données D1, utilisez les identifiants du compte Google [e-mail] afin d'envoyer des données au compte administrateur M2, au compte client C1 ou au compte client C2, en utilisant une destination avec login_account défini sur le compte de partenaire de données D1 et linked_account défini sur le compte administrateur M2.

En tant que partenaire de données D1, vous ne pouvez pas envoyer de données au compte administrateur M1, car il n'existe aucun lien produit entre D1 et M1.

Agir en tant que partenaire pour les données D2

Pour agir en tant que partenaire de données D2, utilisez les identifiants du compte Google [e-mail] pour envoyer des données au compte client C1, en utilisant une destination avec login_account défini sur le compte de partenaire de données D2 et linked_account défini sur le compte client C1.

En tant que partenaire pour les données D2, vous ne pouvez pas envoyer de données au compte administrateur M1, au compte administrateur M2 ni au compte client C2, car aucun produit n'est associé à D2, ni à aucun de ces comptes ou à leurs comptes administrateur parents.

La principale différence entre les partenaires de données D1 et D2 réside dans la façon dont ils sont associés aux comptes Google Ads.

• Le partenaire de données D1 est associé à un compte administrateur Google Ads. Il s'agit d'un exemple de scénario d'association de produits pour les administrateurs.
• Le partenaire de données D2 est associé à un compte client Google Ads. Il s'agit d'un exemple de scénario de lien direct vers un produit.

Scénario de lien direct vers un produit

Si vous souhaitez envoyer des données à un compte Google Ads et que l'association de produit est établie entre le compte Google Ads et votre compte partenaire de données :

Ingestion

Destination
operating_account	account_id Numéro client du compte Google Ads account_type GOOGLE_ADS
login_account	account_id Numéro client du compte de partenaire pour les données account_type DATA_PARTNER
linked_account	Ne définissez pas le champ linked_account.
product_destination_id	ID de l'audience ou de l'action de conversion.

Gestion des ressources

En-têtes de requête
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Voici un exemple de scénario de lien direct vers un produit utilisant les comptes du diagramme, ainsi que les en-têtes de requête correspondants pour les demandes de gestion des ressources. Dans ce scénario, le partenaire de données D2 envoie des données sur les membres de l'audience au client Google Ads C1 à l'aide de l'association de produits entre D2 et C1, ainsi que des identifiants pour le compte Google [e-mail] :

Ingestion

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Gestion des ressources

En-têtes de requête
login-account	accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Scénario d'association de produits par un administrateur

Si vous souhaitez envoyer des données à un compte Google Ads et que l'association de produit est établie entre un compte administrateur Google Ads parent et votre compte partenaire de données :

Ingestion

Destination
operating_account	account_id Numéro client du compte client Google Ads account_type GOOGLE_ADS
login_account	account_id Numéro client du compte de partenaire pour les données account_type DATA_PARTNER
linked_account	account_id Numéro client du compte administrateur Google Ads account_type GOOGLE_ADS
product_destination_id	ID de l'audience ou de l'action de conversion.

Gestion des ressources

En-têtes de requête
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID

Voici un exemple de scénario de lien vers un produit administrateur utilisant des comptes du diagramme. Dans ce scénario, le partenaire de données D1 envoie les données des membres de l'audience au client Google Ads C2 à l'aide de l'association de produits entre D1 et M2, et des identifiants du compte Google [e-mail] :

Ingestion

{
  "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"
    }
  ]
}

Gestion des ressources

En-têtes de requête
login-account	accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID

Display & Video 360

En tant que partenaire de données, vous pouvez envoyer des données à un compte Display & Video 360 de deux manières :

1. Utilisez un lien produit direct entre un compte de partenaire de données et le compte de partenaire ou d'annonceur Display & Video 360.
2. Envoyez des données à un annonceur Display & Video 360 à l'aide d'une association de produit entre un compte de partenaire de données et le compte partenaire Display & Video 360 parent de l'annonceur.

Scénarios de liens directs vers des produits

Si vous souhaitez envoyer des données à un annonceur Display & Video 360 et que l'association de produits est établie entre le compte d'annonceur Display & Video 360 et votre compte de partenaire de données :

Ingestion

Destination
operating_account	account_id ID du compte annonceur Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id Numéro client du compte de partenaire pour les données account_type DATA_PARTNER
linked_account	Ne définissez pas le champ linked_account.
product_destination_id	ID de l'audience ou de l'action de conversion.

Gestion des ressources

En-têtes de requête
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Voici un exemple de Destination pour un scénario de lien direct vers un produit permettant d'envoyer des données à un annonceur Display & Video 360, ainsi que les en-têtes de requête correspondants pour les demandes de gestion des ressources :

Ingestion

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Gestion des ressources

En-têtes de requête
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Si vous souhaitez envoyer des données à un compte partenaire Display & Video 360, vous devez associer le compte partenaire Display & Video 360 à votre compte partenaire de données.

Ingestion

Destination
operating_account	account_id ID du compte de partenaire Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
login_account	account_id Numéro client du compte de partenaire pour les données account_type DATA_PARTNER
linked_account	Ne définissez pas le champ linked_account.
product_destination_id	ID de l'audience ou de l'action de conversion.

Gestion des ressources

En-têtes de requête
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Voici un exemple de Destination pour un scénario de lien direct vers un produit permettant d'envoyer des données à un partenaire Display & Video 360, ainsi que les en-têtes de requête correspondants pour les demandes de gestion des ressources :

Ingestion

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Gestion des ressources

En-têtes de requête
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Ne définissez pas l'en-tête linked-account.

Scénario d'association à un produit partenaire Display & Video 360

Si vous souhaitez envoyer des données à un annonceur Display & Video 360 et que l'association de produit à votre compte de partenaire de données est établie avec un compte partenaire Display & Video 360 dont le compte d'annonceur est un compte enfant :

Ingestion

Destination
operating_account	account_id ID du compte annonceur Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id Numéro client du compte de partenaire pour les données account_type DATA_PARTNER
linked_account	account_id ID du compte de partenaire Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
product_destination_id	ID de l'audience ou de l'action de conversion.

Gestion des ressources

En-têtes de requête
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Voici un exemple de Destination pour un scénario d'association de produit partenaire permettant d'envoyer des données à un annonceur Display & Video 360 à l'aide d'une association de produit entre le partenaire de données et le partenaire Display & Video 360 parent de l'annonceur :

Ingestion

{
  "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"
    }
  ]
}

Gestion des ressources

En-têtes de requête
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Google Analytics

L'API Data Manager ne permet pas d'envoyer des données à un compte Google Analytics à l'aide d'une association de produits. Utilisez plutôt l'approche Scénarios pour les annonceurs Google Analytics.

Exigences détaillées

Cette section contient des exigences détaillées concernant les champs de compte d'un Destination pour une requête IngestionService, les en-têtes de requête équivalents pour les requêtes de gestion des ressources, des conseils sur la façon de définir le product_destination_id et la façon de déterminer où vos identifiants ont accès.

Champs de compte

Un Destination peut comporter jusqu'à trois comptes différents :

operating_account

Le champ operating_account est obligatoire.

operating_account indique le compte qui reçoit les données dans la requête. L'élément operating_account peut prendre l'une des valeurs suivantes :

• Un compte Google Ads
• Un compte annonceur Display & Video 360
• Un compte partenaire Display & Video 360
• Une propriété Google Analytics
• Un compte partenaire pour les données si vous envoyez des données à une audience appartenant à ce compte.

Il n'existe pas d'en-tête de requête correspondant au champ operating_account d'un Destination. Lorsque vous envoyez une demande de gestion des ressources, le compte cible de la demande est le compte d'exploitation.

Champ login_account et en-tête de requête login-account

Le login_account n'est pas toujours requis. Il est défini par défaut sur operating_account dans une requête IngestionService et sur le compte cible dans une requête de gestion des ressources. Dans une requête de gestion des ressources, utilisez l'en-tête de requête login-account pour identifier le compte de connexion.

L'API Gestionnaire de données vérifie les points suivants :

1. Le compte Google des identifiants est un utilisateur du compte de connexion.

2. Le compte de connexion est l'un des suivants :

   • Identique à operating_account. Il s'agit de la valeur par défaut si vous ne définissez pas le login_account d'un Destination dans une requête IngestionService ou si vous ne définissez pas l'en-tête login-account dans une requête de gestion des ressources.

   • Un compte administrateur Google Ads ou un compte partenaire Display & Video 360 qui est un parent de operating_account dans une demande IngestionService, ou un parent du compte cible dans une demande de gestion des ressources.

   • Un compte de partenaire de données avec un lien produit vers linked_account dans une requête IngestionService ou l'en-tête linked-account dans une requête de gestion des ressources.

Champ linked_account et en-tête de requête linked-account

Remarque : Ne spécifiez un compte associé que si le compte de connexion a la valeur account_type définie sur DATA_PARTNER et qu'un parent de operating_account est associé au compte du partenaire de données. Si le operating_account est directement associé au compte du partenaire de données, ne définissez pas linked_account.

linked_account indique le compte associé au login_account d'une demande IngestionService ou le compte cible d'une demande de gestion des ressources.

ID de destination du produit

Le product_destination_id d'un Destination identifie l'objet du operating_account qui reçoit les données. Par exemple, il peut s'agir d'un ID d'audience pour Google Ads ou Display & Video 360, d'un ID d'action de conversion pour Google Ads ou d'un ID de mesure pour un flux Google Analytics.

Voici comment trouver l'ID de chaque type de destination de produit.

Audience Google Ads

L'ID de destination du produit pour importer des membres d'audience est l'ID d'audience. Récupérez cet ID à l'aide de l'interface utilisateur Google Ads ou de l'API Data Manager.

Interface utilisateur de Google Ads

Pour obtenir l'ID d'audience depuis l'UI Google Ads :

1. Accédez à Gestion des audiences dans l'UI Google Ads.
2. Cliquez sur le nom de l'audience pour afficher les détails.
3. L'ID d'audience est indiqué à côté de ID de la liste.

API Data Manager

Récupérez le UserList à l'aide de la méthode List, en fournissant les en-têtes de requête si nécessaire, et utilisez le id du UserList pour l'ID de destination du produit.

Événement Google Ads

L'ID de destination du produit pour ingérer les événements est l'ID de l'action de conversion.

Pour obtenir l'ID d'action de conversion dans l'UI Google Ads :

1. Accédez à Conversions dans l'UI Google Ads.
2. Cliquez sur le nom d'une action de conversion pour afficher ses détails.

3. L'ID de l'action de conversion correspond à la valeur du paramètre de requête d'URL nommé ctId.

   https://ads.google.com/aw/conversions/detail?ocid=...&ctId=CONVERSION_ACTION_ID&...
   

Pour obtenir l'ID d'action de conversion à partir de l'API Google Ads :

1. Envoyez une requête Search ou SearchStream à GoogleAdsService avec la requête suivante :

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

2. Récupérez l'ID de l'action de conversion dans le champ id de conversion_action dans la réponse.

   [
     {
       "results": [
         {
           "conversionAction": {
             "resourceName": "customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID",
             "id": "CONVERSION_ACTION_ID",
             "name": "CONVERSION_ACTION_NAME"
           }
         }
       ]
     }
   ]
   

Audience Display & Video 360

L'ID de destination du produit pour importer des membres d'audience est l'ID d'audience. Récupérez cet ID à l'aide de l'UI Display & Video 360 ou de l'API Data Manager.

Interface utilisateur Display & Video 360

Pour obtenir l'ID d'audience dans l'UI Display & Video 360 :

1. Connectez-vous à l'UI Display & Video 360 sur https://displayvideo.google.com.
2. Accédez au partenaire ou à l'annonceur Display & Video 360 que vous utilisez pour le operating_account.
3. Accédez à Audiences dans le menu de gauche, puis sélectionnez Toutes les audiences.
4. Recherchez l'audience dans la liste. L'ID d'audience est le nombre qui figure à côté du nom dans la colonne Nom.

API Data Manager

Récupérez le UserList à l'aide de la méthode List, en fournissant les en-têtes de requête si nécessaire, et utilisez le id du UserList pour l'ID de destination du produit.

Événement Google Analytics

L'ID de destination du produit pour ingérer des événements est l'ID de mesure du flux de données.

Déterminer où les identifiants ont accès

Les identifiants que vous utilisez pour autoriser une requête d'API Data Manager sont associés à un compte Google spécifique.

• Si vous utilisez des identifiants utilisateur, les requêtes sont autorisées en tant que compte Google de l'utilisateur qui a accordé l'autorisation d'agir en son nom lorsque vous avez généré les identifiants.
• Si vous utilisez des identifiants de compte de service, les requêtes sont autorisées en tant que compte Google du compte de service.

Découvrez comment vérifier que le compte Google associé à vos identifiants a accès à un compte Google Ads, Display & Video 360 ou Google Analytics.

Google Ads ou un partenaire pour les données

1. Accédez à Accès et sécurité dans l'interface utilisateur Google Ads pour login_account.
2. Cliquez sur l'onglet Utilisateurs.
3. Si login_account est un compte administrateur Google Ads, désactivez l'option Afficher les utilisateurs de toute la hiérarchie pour masquer les utilisateurs des comptes enfants.
4. Vérifiez que le compte Google associé à vos identifiants figure dans la liste des comptes affichés dans l'onglet Utilisateurs.

Display & Video 360

1. Accédez à Gestion des utilisateurs et préférences relatives aux e-mails dans l'UI Display & Video 360.
2. Vérifiez que la page Gestion des utilisateurs indique que le compte Google associé à vos identifiants est un utilisateur de login_account.

Google Analytics

1. Accédez à Gestion des accès à la propriété dans l'interface utilisateur Google Analytics.
2. Vérifiez que la propriété Google Analytics spécifiée dans login_account est sélectionnée.
3. Vérifiez que le compte Google associé à vos identifiants dispose du rôle Éditeur ou Administrateur au niveau de la propriété.