Chaque Destination dans un IngestAudienceMembersRequest ou IngestEventsRequest définit :
- Compte qui reçoit les données. Par exemple, un compte Google Ads ou une propriété Google Analytics.
- Entité de destination des données du compte, comme une action de conversion Google Ads ou un flux Google Analytics.
- 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 :
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 :
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 :
- Compte administrateur M2
- Compte client C1
Le compte Google
cloudysanfrancisco@gmail.comest un utilisateur dans M1.- Compte administrateur M2
M2 dispose de deux comptes enfants directs :
- Compte client C1
- Compte client C2
Le compte Google
baklavainthebalkans@gmail.comest un utilisateur dans M2.- Compte client C1
C1 a deux comptes administrateur parents directs :
- Compte administrateur M1
- Compte administrateur M2
Le compte Google
jeffersonloveshiking@gmail.comest 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 :
| Destination | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
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. | ||||
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 :
| Destination | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
Ne définissez pas le champ linked_account. |
||||
product_destination_id |
ID de l'audience ou de l'action de conversion. | ||||
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 :
- Accès direct, où les identifiants concernent un compte Google qui est un utilisateur du compte d'annonceur ou de partenaire Display & Video 360.
- 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 :
| Destination | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
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. | ||||
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 :
| Destination | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
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. | ||||
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 :
| Destination | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
Ne définissez pas le champ linked_account. |
||||
product_destination_id |
ID de l'audience. | ||||
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.
| Destination | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
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. | ||||
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.comest 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.comest un utilisateur dans D2.- Compte administrateur M1
M1 comporte deux comptes enfants directs :
- Compte administrateur M2
- Compte client C1
- Compte administrateur M2
M2 dispose de deux comptes enfants directs :
- Compte client C1
- Compte client C2
- Compte client C1
C1 a deux comptes administrateur parents directs :
- Compte administrateur M1
- 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.comafin d'envoyer des données au compte administrateur M2, au compte client C1 ou au compte client C2, en utilisant une destination aveclogin_accountdéfini sur le compte de partenaire de données D1 etlinked_accountdé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.compour envoyer des données au compte client C1, en utilisant une destination aveclogin_accountdéfini sur le compte de partenaire de données D2 etlinked_accountdé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 :
| Destination | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
Ne définissez pas le champ linked_account. |
||||
product_destination_id |
ID de l'audience ou de l'action de conversion. | ||||
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 :
| Destination | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
|
||||
product_destination_id |
ID de l'audience ou de l'action de conversion. | ||||
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 :
- Utilisez un lien produit direct entre un compte de partenaire de données et le compte de partenaire ou d'annonceur Display & Video 360.
- 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 :
| Destination | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
Ne définissez pas le champ linked_account. |
||||
product_destination_id |
ID de l'audience ou de l'action de conversion. | ||||
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.
| Destination | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
Ne définissez pas le champ linked_account. |
||||
product_destination_id |
ID de l'audience ou de l'action de conversion. | ||||
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 :
| Destination | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
|
||||
product_destination_id |
ID de l'audience ou de l'action de conversion. | ||||
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_accountLe champ
operating_accountest obligatoire.operating_accountindique le compte qui reçoit les données dans la requête. L'élémentoperating_accountpeut 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_accountLe
login_accountn'est pas toujours obligatoire et est défini par défaut suroperating_account.L'API Gestionnaire de données vérifie les points suivants :
Le compte Google des identifiants est un utilisateur dans
login_account.login_accountest l'un des éléments suivants :Identique à
operating_account. Il s'agit de la valeur par défaut si vous ne définissez paslogin_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_accountindique le compte qui possède un lien produit verslogin_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 :
- Accédez à Gestion des audiences dans l'UI Google Ads.
- Cliquez sur le nom de l'audience pour afficher les détails.
- 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 :
Envoyez une requête
SearchouSearchStreamàGoogleAdsServiceavec la requête suivante :SELECT user_list.id, user_list.name FROM user_list WHERE user_list.name = 'USER_LIST_NAME'Récupérez l'ID d'audience à partir du champ
iddansuser_listde 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 :
- Accédez à Conversions dans l'UI Google Ads.
- Cliquez sur le nom d'une action de conversion pour afficher ses détails.
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 :
Envoyez une requête
SearchouSearchStreamàGoogleAdsServiceavec la requête suivante :SELECT conversion_action.id, conversion_action.name FROM conversion_action WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'Récupérez l'ID de l'action de conversion dans le champ
iddeconversion_actiondans 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 :
- Connectez-vous à l'UI Display & Video 360 sur https://displayvideo.google.com.
- Accédez au partenaire ou à l'annonceur Display & Video 360 que vous utilisez pour le
operating_account. - Accédez à Audiences dans le menu de gauche, puis sélectionnez Toutes les audiences.
- 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
- Accédez à Accès et sécurité dans l'UI Google Ads pour
login_account. - Cliquez sur l'onglet Utilisateurs.
- Si
login_accountest un compte administrateur Google Ads, désactivez l'option Afficher les utilisateurs de toute la hiérarchie pour masquer les utilisateurs des comptes enfants. - Vérifiez que le compte Google associé à vos identifiants figure dans la liste des comptes affichés dans l'onglet Utilisateurs.
Display & Video 360
- Accédez à Gestion des utilisateurs et préférences relatives aux e-mails dans l'UI Display & Video 360.
- Vérifiez que la page Gestion des utilisateurs indique que le compte Google associé à vos identifiants est un utilisateur de
login_account.
Google Analytics
- Accédez à Gestion des accès à la propriété dans l'interface utilisateur Google Analytics.
- Vérifiez que la propriété Google Analytics spécifiée dans
login_accountest sélectionnée. - Vérifiez que le compte Google associé à vos identifiants dispose du rôle Éditeur ou Administrateur au niveau de la propriété.