Configurer les destinations et les en-têtes

Le concept de 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 des destinations et des 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 requête d'ingestion utilise IngestionService pour ajouter ou supprimer des membres d'une audience, ou envoyer des événements. La liste destinations d'un IngestAudienceMembersRequest ou d'un IngestEventsRequest définit :

  1. Le 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, par exemple une action de conversion Google Ads ou un flux Google Analytics.
  3. Chemin d'accès des identifiants de la requête au compte qui reçoit les données.

  Vous pouvez inclure plusieurs destinations dans la même requête 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 les 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

Remarque : Une requête RetrieveRequestStatus n'accepte pas directement les destinations ni les en-têtes de requête. À la place, l'API Data Manager vérifie l'autorisation à l'aide des destinations et du chemin d'accès de la requête d'ingestion d'origine. Pour en savoir plus, consultez la section Autorisation du guide de diagnostic.

Pour basculer entre les détails de chaque type de requête dans ce guide, cliquez sur l'onglet Ingestion ou Gestion des ressources autour de chaque tableau.

Si vous êtes un annonceur ou une agence, accédez à la section Scénarios d'annonceur pour découvrir des exemples de définition d'en-têtes et de construction d'un Destination :

• Google Ads
• Display & Video 360
• Google Analytics
• Floodlight

Si vous êtes un partenaire pour les données, accédez à la section Scénarios pour les partenaires pour les données pour voir des exemples de définition d'en-têtes et de construction d'un Destination afin de gérer les ressources et d'envoyer des données à un compte associé à votre compte de partenaire pour les données via un lien de partenaire :

• Google Ads
• Display & Video 360
• Google Ad Manager
• Google Analytics
• Floodlight

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

Scénarios d'annonceur

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

Google Ads

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

Compte administrateur M1

M1 possède deux comptes enfants directs :

1. Compte administrateur M2
2. Compte client C1

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

Compte administrateur M2

M2 possède deux comptes enfants directs :

1. Compte client C1
2. Compte client C2

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

Compte client C1

C1 possède 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 de C2.

Le scénario d'accès direct et le scénario 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 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 utilisateur d'un compte administrateur Google Ads dans lequel le compte de l'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 du diagramme et les 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 correspondent à 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 le compte d'exploitation 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 d'annonceur Display & Video 360 et que vos identifiants correspondent à un compte Google utilisateur du compte d'annonceur :

Ingestion

Destination
operating_account	account_id ID du compte d'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 utilisateur du compte partenaire :

Ingestion

Destination
operating_account	account_id ID du compte 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 d'un partenaire Display & Video 360

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

Ingestion

Destination
operating_account	account_id ID du compte d'annonceur Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id ID du compte 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 d'annonceur Display & Video 360 DISPLAY_VIDEO_ADVERTISER_ID doit être un 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 operating_account est un compte Google Analytics, ne définissez pas login_account ou définissez-le sur les mêmes valeurs que operating_account. À défaut, la requête échoue avec l'erreur OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

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 d'un flux de données Web. ID d'application Firebase d'un flux de données d'application.

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.

Floodlight

Remarque : Si operating_account est une configuration Floodlight, ne définissez pas login_account ou définissez-le sur les mêmes valeurs que operating_account. Sinon, la requête échoue avec l'erreur OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

Ingestion

Destination
operating_account	account_id ID de configuration Floodlight Si votre annonceur est un annonceur enfant d'un annonceur parent, utilisez l'ID de l'annonceur parent dans Campaign Manager 360 comme ID de configuration Floodlight. Sinon, utilisez l'ID de votre annonceur. Découvrez comment trouver la référence annonceur dans l'UI de Campaign Manager 360. account_type FLOODLIGHT_CONFIG
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'activité Floodlight

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

Ingestion

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

Scénarios de partenaires pour les données

Voici comment configurer un Destination pour les scénarios courants d'un partenaire pour les données qui envoie des données aux comptes d'annonceurs avec un lien partenaire établi vers le compte du partenaire pour les données.

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

Ce diagramme montre comment l'API Data Manager utilise les champs d'identifiants et Destination pour accéder au compte de l'annonceur via un lien partenaire.

Google Ads

Voici un schéma illustrant un exemple d'ensemble de comptes Google Ads et de partenaires pour les données. Le diagramme montre également quel compte Google est un utilisateur dans chaque compte Google Ads ou partenaire pour les données, ainsi que les liens partenaires entre les comptes.

Partenaire pour les données D1

Un lien partenaire existe entre D1 et le compte administrateur Google Ads M2.

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

Partenaire pour les données D2

Un lien partenaire existe entre D2 et le compte client Google Ads C1.

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

Compte administrateur M1

M1 possède deux comptes enfants directs :

1. Compte administrateur M2
2. Compte client C1

Compte administrateur M2

M2 possède deux comptes enfants directs :

1. Compte client C1
2. Compte client C2

Compte client C1

C1 possède 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 pour les données D1, utilisez les identifiants du compte Google [e-mail] pour :

• Envoyez des données au compte client C1 ou C2 en utilisant une destination dont le paramètre login_account est défini sur le compte de partenaire pour les données D1 et le paramètre linked_account sur le compte administrateur M2.

• Envoyez les données directement au compte administrateur M2 en utilisant une destination dont le paramètre login_account est défini sur le compte de partenaire pour les données D1. Ne définissez pas linked_account.

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

Agir en tant que partenaire pour les données D2

Pour agir en tant que partenaire pour les données D2, utilisez les identifiants du compte Google [e-mail] afin d'envoyer des données au compte client C1, en utilisant une destination dont le paramètre login_account est défini sur le compte du partenaire pour les données D2. Ne définissez pas linked_account.

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 il n'existe pas de lien de partenariat entre D2 et l'un de ces comptes ou leurs comptes administrateur parents.

La principale différence entre les partenaires pour les données D1 et D2 réside dans la manière dont ils sont associés aux comptes Google Ads.

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

Scénario de lien direct avec le partenaire

Si vous souhaitez envoyer des données à un compte Google Ads et que le lien partenaire se trouve entre le compte Google Ads et votre compte de partenaire pour les 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 du 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 de partenaire direct utilisant les comptes du diagramme, ainsi que les en-têtes de requête correspondants pour les requêtes de gestion des ressources. Dans ce scénario, le partenaire pour les données D2 envoie les données des membres de l'audience au client client Google Ads C1 à l'aide du lien partenaire entre D2 et C1, et des identifiants du 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 d'un partenaire administrateur

Si vous souhaitez envoyer des données à un compte Google Ads et que le lien du partenaire se trouve entre un compte administrateur Google Ads parent et votre compte de partenaire pour les 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 du 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 d'association de partenaires administrateurs utilisant les comptes du diagramme. Dans ce scénario, le partenaire pour les données D1 envoie les données des membres de l'audience au client client Google Ads C2 à l'aide du lien partenaire 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 pour les données, vous pouvez envoyer des données à un compte Display & Video 360 de deux manières :

1. Utilisez un lien partenaire direct entre un compte de partenaire pour les 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'un lien partenaire entre un compte de partenaire pour les données et le compte partenaire Display & Video 360 parent de l'annonceur.

Scénarios de liens partenaires directs

Si vous souhaitez envoyer des données à un annonceur Display & Video 360 et que le lien partenaire est établi entre le compte de l'annonceur Display & Video 360 et votre compte de partenaire pour les données :

Ingestion

Destination
operating_account	account_id ID du compte d'annonceur Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id Numéro client du compte du 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 d'association directe de partenaire afin d'envoyer des données à un annonceur Display & Video 360, ainsi que les en-têtes de requête correspondants pour les requêtes 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 disposer d'un lien partenaire entre le compte partenaire Display & Video 360 et votre compte partenaire pour les données.

Ingestion

Destination
operating_account	account_id ID du compte partenaire Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
login_account	account_id Numéro client du compte du 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 d'association directe de partenaire afin d'envoyer des données à un partenaire Display & Video 360, ainsi que les en-têtes de requête correspondants pour les requêtes 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 de partenaire parent

Si vous souhaitez envoyer des données à un annonceur Display & Video 360 et que le lien partenaire vers votre compte de partenaire pour les données est associé à un compte partenaire Display & Video 360 dont le compte d'annonceur est un compte enfant :

Ingestion

Destination
operating_account	account_id ID du compte d'annonceur Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id Numéro client du compte du partenaire pour les données account_type DATA_PARTNER
linked_account	account_id ID du compte 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 de lien partenaire permettant d'envoyer des données à un annonceur Display & Video 360 à l'aide d'un lien partenaire entre le partenaire pour les 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 Ad Manager

Si vous souhaitez envoyer des données à un compte Google Ad Manager et que vous disposez d'un lien partenaire entre votre compte de partenaire pour les données et le compte Google Ad Manager :

Ingestion

Destination
operating_account	account_id L'ID d'association d'audience du compte Google Ad Manager account_type GOOGLE_AD_MANAGER_AUDIENCE_LINK
login_account	account_id Numéro client du compte du 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.

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 envoyer des données à un compte Google Ad Manager à l'aide d'un lien partenaire :

Ingestion

      {
        "destinations": [
          {
            "operatingAccount": {
              "accountId": "GAM_AUDIENCE_LINK_ID",
              "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK"
            },
            "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.

Google Analytics

L'API Data Manager ne permet pas d'envoyer des données à un compte Google Analytics à l'aide d'un lien partenaire. Utilisez plutôt l'approche Scénarios d'annonceur pour Google Analytics.

Floodlight

L'API Data Manager ne permet pas d'envoyer des données à une configuration Floodlight à l'aide d'un lien partenaire. Utilisez plutôt l'approche Scénarios d'annonceur pour Floodlight.

Exigences détaillées

Cette section contient les 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 pour définir le product_destination_id et comment déterminer où vos identifiants ont accès.

Champs de compte

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

operating_account

Le champ operating_account est obligatoire.

operating_account indique quel compte reçoit les données de la requête. operating_account peut être l'un des éléments suivants :

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

Il n'existe pas d'en-tête de requête correspondant au champ operating_account d'un Destination. Lors de l'envoi d'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 obligatoire. Par défaut, il s'agit du operating_account dans une requête IngestionService et du 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 Data Manager vérifie que :

1. Le compte Google des identifiants est un utilisateur du compte administrateur.

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

   • Identique à operating_account. Il s'agit de l'option par défaut si vous ne définissez pas le champ 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 requête IngestionService, ou un parent du compte cible dans une requête de gestion des ressources.

   • Un compte de partenaire pour les données avec un lien de partenaire 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 défini account_type sur DATA_PARTNER et qu'un parent de operating_account est associé au compte du partenaire pour les données. Si le operating_account est directement associé au compte du partenaire pour les données, ne définissez pas linked_account.

linked_account indique quel compte dispose d'un lien partenaire vers le login_account d'une requête IngestionService ou le compte cible d'une requête 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. Il peut s'agir, par exemple, 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 de données Google Analytics.

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

Audience Google Ads

L'ID de destination du produit pour l'ingestion des membres de l'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 à partir de l'UI Google Ads :

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

API Data Manager

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

Événement Google Ads

L'identifiant de destination du produit pour l'ingestion d'événements est l'identifiant de l'action de conversion. Récupérez cet ID à l'aide de l'UI Google Ads ou de l'API Google Ads.

Interface utilisateur de Google Ads

Pour obtenir l'identifiant de l'action de conversion à partir de l'interface utilisateur Google Ads :

1. Accédez à Conversions dans l'UI Google Ads.
2. Cliquez sur le nom de l'action de conversion.
3. Accédez à l'onglet Détails.
4. L'identifiant de l'action de conversion est le numéro à côté de ID du type de conversion.

API Google Ads

Pour obtenir l'identifiant de l'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. Obtenez l'identifiant de l'action de conversion à partir du champ id dans conversion_action de 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 l'ingestion des membres de l'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.

UI de Display & Video 360

Pour obtenir l'ID d'audience à partir de l'UI Display & Video 360 :

1. Connectez-vous à l'interface utilisateur de Display & Video 360 à l'adresse https://displayvideo.google.com.
2. Accédez au partenaire ou à l'annonceur Display & Video 360 que vous utilisez pour 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 numéro situé à 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 des 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 dépend du type de flux de données.

Flux de données Web

Utilisez l'ID de mesure du flux de données.

Flux de données d'application

Utilisez l'ID d'application Firebase du flux de données. Voici deux options pour trouver votre ID d'application Firebase :

• Dans l'interface utilisateur de Google Analytics, accédez à Flux de données, cliquez sur le flux de données, puis recherchez l'ID DE L'APPLICATION FIREBASE.
• Utiliser la console Firebase

Événement Floodlight

L'ID de destination du produit pour l'ingestion d'événements dans Floodlight est l'ID de l'activité Floodlight. Récupérez cet ID à l'aide de l'interface utilisateur ou de l'API Campaign Manager 360.

UI de Campaign Manager 360

Pour obtenir l'ID d'activité Floodlight à partir de l'interface utilisateur de Campaign Manager 360 :

1. Connectez-vous à l'interface utilisateur de Campaign Manager 360.
2. Accédez à l'annonceur Campaign Manager 360 que vous utilisez pour le operating_account.
3. Accédez à Floodlight dans le menu de gauche, puis sélectionnez Activités.
4. Recherchez l'activité Floodlight dans la liste. L'ID correspond au numéro situé à côté du nom dans la colonne Nom de l'activité.

API Campaign Manager 360

Pour obtenir l'ID d'activité Floodlight à partir de l'API Campaign Manager 360 :

1. Envoyez une requête list à la ressource floodlightActivities.
2. Spécifiez l'floodlightConfigurationId de la configuration Floodlight.
3. Vous pouvez également utiliser le paramètre searchString pour filtrer par nom d'activité.
4. Obtenez l'ID de l'activité Floodlight à partir du champ id de l'élément FloodlightActivity sélectionné dans la réponse.

Déterminer les accès des identifiants

Les identifiants que vous utilisez pour autoriser une requête 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.

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

Google Ads ou 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 le 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 de 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'interface utilisateur de 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'UI Google Analytics.
2. Vérifiez que la propriété Google Analytics spécifiée dans le 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é.

Floodlight (Campaign Manager 360)

1. Connectez-vous à l'interface utilisateur de Campaign Manager 360.
2. Accédez à Admin > Profils utilisateur dans le menu de gauche.
3. Vérifiez que le compte Google de vos identifiants figure dans la liste des profils affichés.
4. Cliquez sur le profil et vérifiez qu'il a accès au compte d'annonceur utilisé comme login_account. Si vous ne définissez pas de login_account dans la requête, la valeur par défaut est operating_account. Assurez-vous que le compte dispose d'un rôle utilisateur avec l'autorisation Insérer des conversions hors connexion.