Documentation Experience Platform Guide des connecteurs sources

Google Ads (V2)

Dernière mise à jour : 2 octobre 2026

Rubriques :
Sources

Créé pour :

Developer

IMPORTANT

La source de Google Ads est disponible dans le cadre du SKU Customer Journey Analytics.

Google Ads (V2) est un connecteur source de médias achetés Adobe Experience Platform qui ingère des données de compte publicitaire, de campagne, de groupe publicitaire, de publicité, de ressource, d’expérience et de performances à partir de l’API Google Ads dans Experience Platform.

Le connecteur mappe les données Google Ads aux structures XDM (Modèle de données d’expérience) de médias payants normalisées, ce qui vous permet d’analyser les données Google Ads avec les données d’autres réseaux publicitaires, propriétés web, systèmes commerciaux et applications clientes.

Google Ads (V2) utilise un accès en lecture seule pour récupérer les données de rapport et les métadonnées publicitaires. Il ne crée, ne modifie et ne supprime pas les ressources Google Ads.

Exemples de cas d’utilisation

Cas d’utilisation

Objectif

Aide d’Google Ads (V2)

Analyse de publicité cross-canal

Comparez Google Ads performances avec celles de Meta Ads et d’autres canaux médias payants.

Ingère des données Google Ads dans des structures XDM de médias payants courantes avec des identifiants normalisés à travers chaque niveau d’entité.

Modélisation et attribution du mix média

Évaluez la contribution des médias achetés aux résultats commerciaux.

Fournit des données sur les performances des campagnes et des publicités, notamment les impressions, les clics, les dépenses, les conversions et la valeur de conversion pour l’analyse en aval.

Optimisation des campagnes et des budgets

Identifiez les campagnes, les stratégies d’offres et les configurations de ciblage qui produisent les meilleurs résultats.

Ingère les métadonnées, les budgets, les stratégies d’offres, les types de canaux, les statuts, les dates et les critères de ciblage sélectionnés de la campagne.

Creative et performances des ressources

Identifiez les ressources créatives, les formats publicitaires et les expériences les plus performants.

Ingère des métadonnées de contenu créatif au niveau de l’annonce, y compris les associations de ressources, les types et les libellés de performances.

Analyse Performance Max

Analysez les groupes de ressources Performances Max et les ressources associées.

Utilise les données de groupe de ressources Performances Max pour représenter les performances du groupe de ressources et les relations d’expérience là où Google Ads n’expose pas de structure au niveau des annonces traditionnelle.

Analyse du parcours client

Liez l’engagement publicitaire au web, au commerce, au CRM et à d’autres événements client.

Rend les données Google Ads disponibles dans Experience Platform pour une utilisation avec les analyses en aval et les workflows d’activation.

Conditions préalables

Avant de connecter Google Ads (V2) à Experience Platform, vérifiez que vous disposez des éléments suivants :

Configuration des autorisations sur Experience Platform

Les autorisations Afficher les sources et Gérer les sources doivent être activées pour votre compte Experience Platform.

Contactez votre administrateur de produit si vous ne disposez pas des autorisations requises. Pour plus d’informations, consultez le guide de l’interface utilisateur du contrôle d’accès.

Configuration de l’accès à l’API Google Ads

Experience Platform gère le flux d’autorisation OAuth 2.0 pour Google Ads (V2). Vous ne créez pas de projet Google Cloud, de client OAuth, ni de jeton d’actualisation.

Vous devez avoir :

Jeton de développeur Google Ads valide.
Accès au compte publicitaire Google Ads à ingérer.
Autorisation d’accès aux comptes publicitaires appropriés par le biais d’Google Ads ou d’un compte de gestionnaire de Google Ads.

Accès au compte du responsable

Si le compte de l’annonceur est accessible par le biais d’un compte Google Ads Manager, indiquez également l’ID client de responsable approprié comme loginCustomerId.

Le loginCustomerId n’est pas requis lorsque l’utilisateur autorisé par OAuth peut accéder directement au compte de l’annonceur cible et qu’aucune hiérarchie de responsable n’est nécessaire.

Google Ads (V2) énumère les comptes accessibles, identifie les comptes du responsable, parcourt la hiérarchie des comptes du responsable et résout les comptes de l’annonceur disponibles pour l’ingestion.

Collecter les informations d’identification requises

Pour connecter Google Ads (V2) à Experience Platform, fournissez les valeurs suivantes.

Informations d’identification

Description

developerToken

Jeton de développeur Google Ads utilisé pour autoriser les requêtes API.

loginCustomerId

Identifiant client numérique du compte du responsable utilisé pour accéder au compte de l’annonceur. Ces informations d’identification sont requises pour l’accès au compte du responsable.

Authentification et découverte de compte

Google Ads (V2) utilise OAuth 2.0 pour autoriser l’accès à l’API Google Ads. Experience Platform gère le flux d’autorisation. Vous ne devez donc pas configurer les portées ou les autorisations OAuth côté Google Ads.

Une fois votre compte autorisé, Experience Platform utilise votre jeton de développeur pour accéder aux ressources de création de rapports Google Ads. Pour les configurations de compte du responsable, le connecteur résout la hiérarchie de compte et identifie les comptes de l’annonceur disponibles pour l’ingestion.

Le workflow de découverte de compte comprend les opérations suivantes :

Énumérer les comptes accessibles à l’utilisateur autorisé.
Déterminez si un compte accessible est un compte de gestionnaire.
Parcourir la hiérarchie des comptes du responsable.
Identifier les comptes des annonceurs qui ne sont pas des gestionnaires.
Utilisez le loginCustomerId approprié lorsque les requêtes sont acheminées via la hiérarchie de compte du responsable.
Récupérez les métadonnées du compte telles que l’identifiant du compte, le nom du compte, la devise et le fuseau horaire.

Google Ads (V2) effectue des opérations d’API en lecture seule. Il n’émet pas de requêtes de mutation, de création, de mise à jour ou de suppression sur les ressources Google Ads.

Sélection et ingestion des données

Google Ads (V2) utilise le langage de requête Google Ads (GAQL) pour récupérer les métadonnées du compte, les métadonnées de la campagne et les données de rapports.

Le connecteur utilise des requêtes spécifiques aux ressources pour récupérer les attributs, les segments et les mesures requis pour chaque entité. Le connecteur utilise des SearchStream pour le reporting des ressources et des jeux de résultats volumineux où le traitement incrémentiel des lignes est bénéfique.

L’inventaire des requêtes pris en charge comprend des ressources telles que :

customer
customer_client
campaign
campaign_budget
campaign_criterion
geo_target_constant
ad_group
ad_group_criterion
ad_group_ad
ad_group_ad_asset_view
ad_group_ad_asset_combination_view
asset
asset_group
asset_group_asset
change_status

Les mesures de performances sont récupérées à l’aide de segments basés sur une date, tels que segments.date.

Configuration du schéma

Google Ads (V2) mappe les données source aux structures XDM de médias payants normalisées. Le connecteur organise les données par niveau d’entité de sorte que les métadonnées et les mesures de performances puissent être jointes sur les enregistrements de compte, de campagne, de groupe publicitaire, de publicité, de ressource et d’expérience.

Entité

Principal Google Ads ressources

Données représentées

Compte

customer, customer_client

Identifiant du compte, nom du compte, devise, fuseau horaire, statut du responsable et métadonnées du compte.

Campaign

campaign, campaign_budget, campaign_criterion

Nom de la campagne, statut, canal publicitaire, sous-type, objectif, budgets, stratégie d’enchères, dates, suivi des URL et configuration du ciblage.

Groupe publicitaire

ad_group, ad_group_criterion

Identifiant, nom, statut, enchères, ciblage, mots-clés, emplacements et relation de campagne du groupe publicitaire.

Annonce publicitaire

ad_group_ad

Identifiant de l’annonce, type d’annonce, contenu créatif, URL de destination, statut de diffusion, informations sur les politiques et les révisions, et relations entre la campagne et le groupe publicitaire.

Ressource

asset, ad_group_ad_asset_view, asset_group_asset

Identifiant de ressource, type de ressource, texte, image ou métadonnées vidéo, dimensions, utilisation, libellé de performance et publicités ou campagnes associées.

Expérience

ad_group_ad_asset_combination_view, asset_group, asset_group_asset

Composition créative dérivée, ressources diffusées, titres, descriptions, appels à l’action, URL de page de destination et relations d’expérience.

Mesures de synthèse

Champs et segments.date de metrics.* spécifiques aux ressources

Impressions, clics, dépenses, conversions au niveau de la date, valeur de conversion, CTR, CPC, CPM, mesures vidéo et autres mesures de performances prises en charge.

Conventions d’identifiant

Le mappage V2 définit des identifiants qualifiés pour la plateforme pour les entités de médias achetés. Par exemple :

Le connecteur dérive les identifiants de compte de l’ID de client Google Ads.
Les identifiants de campagne combinent l’identifiant client Google Ads et l’identifiant de campagne.
Le groupe publicitaire et les identifiants d’annonces publicitaires incluent leur hiérarchie parente.
Les identifiants de ressource combinent l’identifiant client Google Ads et l’identifiant de ressource.
Le connecteur dérive les identifiants d’expérience du contexte de combinaison créative ou de groupe de ressources.
Les chemins hiérarchiques représentent la relation entre les entités de compte, de campagne, de groupe publicitaire, d’annonce, d’expérience et de ressource.

Performances Max data

Les campagnes Performances Max n’exposent pas toujours les mêmes relations d’entité que les types de campagne traditionnels.

Pour les données Performance Max :

asset_group représente le principal regroupement des ressources.
asset_group_asset représente les relations actif à groupe.
Les mesures de groupe de ressources fournissent le contexte nécessaire à l’analyse des performances des ressources.
Les groupes de ressources agissent comme un proxy d’expérience lorsqu’une entité d’expérience native n’est pas disponible.

Limites et considérations des données

Tenez compte des restrictions suivantes lors de la planification de l’implémentation de votre Google Ads (V2).

Prise en charge des mesures spécifiques aux ressources

Google Ads n’expose pas toutes les mesures pour chaque ressource. Par exemple, certaines ressources ne prennent pas en charge les mesures ou les segments, tandis que d’autres ne prennent en charge qu’un ensemble limité de mesures.

La disponibilité des mesures varie également entre les requêtes Annonce publicitaire, Ressource, Expérience, Campagne et Performance Max.

Enregistrements d’expérience dérivés

Google Ads ne fournit pas une seule entité d’expérience universelle équivalente au modèle d’expérience utilisé par les schémas XDM de médias achetés.

Le connecteur dérive les enregistrements d’expérience des données d’annonces, de combinaison de ressources et de groupes de ressources disponibles.

Métadonnées vidéo

L’API Google Ads fournit des identifiants vidéo et des références de ressources associées. Cependant, certaines propriétés multimédias, telles que la durée de la vidéo, le codec, le débit, la fréquence d’image et la présence audio, ne sont pas directement disponibles via l’API Google Ads.

Ces champs sont nuls, sauf si un service d’enrichissement approuvé est ajouté.

Disponibilité des ressources

Les métadonnées et la prise en charge des performances des ressources varient selon le type de ressource. Par exemple, les métadonnées d’image et de texte sont directement disponibles, tandis que certaines propriétés vidéo nécessitent un enrichissement supplémentaire.

Champs spécifiques à Google

Google Ads concepts sans équivalent XDM de média payant direct sont représentés à l’aide de additionalDetails ou définis sur null, en fonction du mappage approuvé.

Mappages d’énumération

Le connecteur mappe Google Ads valeurs d’énumération de l’API aux valeurs XDM à l’aide de correspondances exactes, de correspondances sémantiques fermées ou de valeurs de secours approuvées. Les valeurs non prises en charge, inconnues, obsolètes ou non spécifiées sont ignorées ou définies sur null.

Étapes suivantes

Après avoir confirmé vos informations d’identification Google Ads et votre modèle d’accès au compte, continuez en créant une connexion à à l’aide Google Ads l’interface utilisateur d’Experience Platform.

recommendation-more-help

experience-platform-help-sources