Configurer des destinations

Chaque Destination dans un IngestAudienceMembersRequest ou 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 du compte, comme une action de conversion Google Ads ou un flux Google Analytics.
3. Chemin d'accès aux identifiants de la demande vers le compte qui reçoit les données.

Si vous êtes annonceur ou si vous gérez une agence, consultez les scénarios pour les annonceurs pour obtenir des exemples de création 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 création d'un Destination permettant d'envoyer des données à un compte avec un lien produit vers votre compte 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 pour les scénarios courants des annonceurs et des 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 cloudysanfrancisco@gmail.com 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 baklavainthebalkans@gmail.com 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 jeffersonloveshiking@gmail.com 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 :

Voici un exemple de scénario d'accès direct, utilisant les comptes du diagramme et les identifiants du compte Google jeffersonloveshiking@gmail.com.

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

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

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

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 :

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 baklavainthebalkans@gmail.com :

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

Voici un autre exemple de scénario d'accès administrateur pour le compte client Google Ads C2 et les identifiants du compte Google cloudysanfrancisco@gmail.com, qui est un utilisateur du compte administrateur Google Ads M1 :

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

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 :

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

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

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 :

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

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

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 :

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 PARTNER_ID, et le compte annonceur Display & Video 360 ADVERTISER_ID doit être un compte enfant du compte partenaire PARTNER_ID.

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

Google Analytics

Remarque : operating_account et login_account doivent être identiques lorsque la destination est un compte Google Analytics. Dans le cas contraire, la requête échoue et l'erreur OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH s'affiche.

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

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

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.

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 222larabrown@gmail.com 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 jeffersonloveshiking@gmail.com 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 222larabrown@gmail.com 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 jeffersonloveshiking@gmail.com 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 de 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. Voici 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 de partenaire de données :

Voici un exemple de scénario de lien direct vers un produit utilisant les comptes du diagramme. Dans ce scénario, le partenaire de données D2 envoie les données des membres de l'audience au client Google Ads C1 à l'aide de l'association de produits entre D2 et C1, ainsi que des identifiants du compte Google jeffersonloveshiking@gmail.com :

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

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 produits est établie entre un compte administrateur Google Ads parent et votre compte partenaire de données :

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 222larabrown@gmail.com :

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

Display & Video 360

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

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 :

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

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.

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 :

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

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 :

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 :

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

Google Analytics

L'API Data Manager n'est pas compatible avec l'envoi de 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, des conseils pour 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 au compte partenaire pour les données.

login_account

Le login_account n'est pas toujours obligatoire et est défini par défaut sur operating_account.

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

1. Le compte Google des identifiants est un utilisateur dans login_account.

2. login_account est l'un des éléments suivants :

   • Identique à operating_account. Il s'agit de la valeur par défaut si vous ne définissez pas login_account.

   • Un compte responsable Google Ads ou partenaire Display & Video 360 qui est le parent de operating_account.

   • Un compte partenaire pour les données avec un lien produit vers linked_account.

linked_account

L'attribut linked_account indique le compte qui possède un lien produit vers login_account.

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.

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.

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

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

   SELECT
     user_list.id,
     user_list.name
   FROM user_list
   WHERE user_list.name = 'USER_LIST_NAME'
   

2. Récupérez l'ID d'audience à partir du champ id dans user_list de la réponse.

   [
     {
       "results": [
         {
           "userList": {
             "resourceName": "customers/CUSTOMER_ID/userLists/USER_LIST_ID",
             "id": "USER_LIST_ID",
             "name": "USER_LIST_NAME"
           }
         }
       ]
     }
   ]
   

É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 de l'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.

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.

É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'UI 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é.