DocumentationExperience PlatformGuide des connecteurs sources

[Beta]{class="badge informative"}

Google Ads

Dernière mise à jour : 29 juillet 2026

Créé pour :

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Google Ads est une plateforme de publicité en ligne de Google qui vous aide à atteindre des clients potentiels sur des sites web de recherche, YouTube, Maps et partenaires. Vous pouvez cibler la bonne audience, contrôler votre budget et suivre les résultats afin de stimuler la sensibilisation, les prospects et les ventes.

Utilisez la source Google Ads pour vous authentifier auprès de l’API Google Ads, connecter les comptes d’annonceurs ou les hiérarchies de comptes de responsable et ingérer des données de rapports dans Experience Platform pour les workflows d’analyse et d’activation en aval.

IMPORTANT
La source Google Ads dans l’interface utilisateur d’Experience Platform est actuellement en version bêta et ne prend en charge que l’ingestion unique. Pour une ingestion incrémentielle, utilisez la connexion basée sur l’API et le flux de données.

Conditions préalables

Avant de connecter votre compte Google Ads à Experience Platform, vérifiez que les conditions suivantes sont remplies.

Liste autorisée d’adresses IP

Vous devez ajouter à votre place sur la liste autorisée des adresses IP spécifiques à une région avant de connecter vos sources à Experience Platform. Pour plus d’informations, consultez le guide sur la connexion des adresses IP à ​.

Configuration des autorisations sur Experience Platform

Pour connecter votre compte Google Ads à Experience Platform les autorisations Afficher les sources et Gérer les sources doivent être activées. Contactez votre administrateur de produit pour obtenir les autorisations nécessaires. Pour plus d’informations, consultez le guide de l’interface utilisateur du contrôle d’accès.

Exigences d’accès Google Ads

Vous devez disposer d’informations d’identification d’API Google Ads valides et d’un accès au compte Google Ads à partir duquel vous souhaitez effectuer la lecture. Si le compte de l’annonceur cible est géré par le biais d’un compte Google AdsManager (MCC) la connexion doit également inclure l’ID de client de connexion correct afin que les requêtes puissent être acheminées via la hiérarchie de gestionnaire appropriée.

En pratique :

  • Si le compte de l’annonceur cible est directement accessible par l’utilisateur ou l’utilisatrice autorisé(e) par OAuth, loginCustomerId peut ne pas être nécessaire.
  • Si le compte de l’annonceur n’est accessible que par le biais d’une hiérarchie MCC, loginCustomerId devez identifier le compte du responsable utilisé pour accéder à ce compte enfant.
  • Un loginCustomerId incorrect ou manquant peut entraîner des échecs d’autorisation lors de la tentative d’interrogation de comptes enfants gérés.

Collecter les informations d’identification requises

Pour connecter Google Ads à Experience Platform, vous devez fournir des valeurs pour les propriétés de connexion suivantes.

Informations d’identification
Description
clientCustomerId
Numéro de compte du compte client Google Ads que vous souhaitez gérer avec l’API Google Ads. Cet identifiant suit généralement le format 123-456-7890.
loginCustomerId
Numéro de compte du compte Google Ads Manager utilisé pour récupérer les données de rapport pour un client opérationnel spécifique. Cela est nécessaire lorsque l’accès au compte cible est arbitré par le biais d’une hiérarchie MCC.
developerToken
Jeton de développeur utilisé pour accéder à l’API Google Ads. Un jeton de développeur unique peut être utilisé sur Google Ads comptes auxquels votre application est autorisée à accéder.
refreshToken
Jeton d’actualisation OAuth 2.0 utilisé pour obtenir de nouveaux jetons d’accès après leur expiration.
clientId
Identifiant client OAuth 2.0 associé à votre application Google.
clientSecret
Secret client OAuth 2.0 associé à votre application Google.
googleAdsApiVersion
Version de l’API Google Ads utilisée par le connecteur. Experience Platform prend actuellement en charge la version v19 et ultérieure.
connectionSpec.id
Identifiant de spécification de connexion Google Ads requis pour les requêtes API Flow Service : d771e9c1-4f26-40dc-8617-ce58c4b53702.

À propos de loginCustomerId

La valeur loginCustomerId est l’un des champs de configuration les plus importants de la source de Google Ads.

Utilisez loginCustomerId lorsque :

  • L’utilisateur autorisé OAuth a accès par le biais d’un compte de responsable,
  • Le compte de l’annonceur cible est un compte enfant dans un MCC.
  • Le compte n’est pas directement renvoyé en tant que compte accessible de niveau supérieur.

Ne définissez pas de loginCustomerId inutile pour les comptes d’annonceurs directement accessibles. Dans la mesure du possible, vérifiez d’abord si le compte est directement accessible et ne fournissez qu’un ID de responsable lorsque l’accès dépend vraiment de cette hiérarchie.

Comportement d’authentification et de connexion

La source Google Ads utilise OAuth 2.0 pour authentifier les requêtes envoyées à l’API Google Ads. Experience Platform stocke les détails de connexion dans une connexion de base et utilise les informations d’identification fournies pour autoriser les appels d’API Google Ads au nom du client.

Pour les scénarios de compte du responsable, le connecteur peut avoir besoin de résoudre la hiérarchie de responsable appropriée pour accéder avec succès au compte de l’annonceur cible. En interne, cela implique généralement :

  1. Énumération des comptes accessibles,
  2. Déterminer si un compte est un compte de gestionnaire,
  3. Identifier les comptes feuilles autres que le responsable,
  4. Résolution de l’identifiant loginCustomerId correct lorsque le compte cible est accessible uniquement par le biais d’une hiérarchie MCC.

Ce comportement est particulièrement important pour les clients qui gèrent plusieurs comptes d’annonceurs à partir d’une seule structure de compte de responsable.

Comportement en matière de sélection des données et de création de rapports

Google Ads sélection des données est basée sur Google Adslangage de requête (GAQL). Lors de la configuration, vous spécifiez les attributs, segments et mesures à récupérer pour l’ingestion.

Pour les extractions de rapports volumineuses, Google Ads prend en charge les modèles de recherche standard et de récupération par flux. En interne, la récupération en continu est préférable pour les jeux de résultats plus volumineux, car elle permet d’utiliser les lignes de rapport de manière incrémentielle plutôt que de les mettre en mémoire tampon page par page.

Lors de la configuration de la sélection des données dans l’interface utilisateur d’Experience Platform, utilisez le Query Builder Google Ads pour choisir le type de ressource et les champs à ingérer, valider la requête, puis copier les attributs requis dans le workflow source.

Chemins de connexion pris en charge

Vous pouvez connecter Google Ads à Experience Platform à l’aide des API ou de l’interface utilisateur.

Utilisation des API

Utilisez l’API Flow Service ​ lorsque vous avez besoin d’une configuration programmatique, d’une configuration répétable ou d’une prise en charge de l’ingestion incrémentielle. À un niveau élevé, le workflow d’API comprend :

  1. la création d’une connexion de base ;
  2. l’exploration de la configuration source ;
  3. Création de la connexion source et cible,
  4. Création d’un flux de données pour l’ingestion

Utilisation de l’interface utilisateur

Utilisez l’espace de travail Sources Experience Platform pour une configuration guidée lorsque vous souhaitez vous connecter Google Ads via l’interface utilisateur. Le flux de l’interface utilisateur prend en charge l’entrée d’informations d’identification, la sélection d’attributs, la prévisualisation et la création de flux de données. Actuellement, le chemin d’accès à l’interface utilisateur reste en version bêta et ne prend en charge que l’ingestion unique.

Limites et notes connues

  • La source Google Ads dans l’interface utilisateur est actuellement en version bêta.
  • L’interface utilisateur ne prend actuellement en charge que l’ingestion unique.
  • Utilisez le chemin d’accès basé sur l’API pour l’ingestion incrémentielle.
  • Experience Platform prend actuellement en charge Google Ads version d’API v19 et plus récente.
  • Les hiérarchies de comptes de gestionnaire nécessitent une gestion attentive des loginCustomerId ; des valeurs incorrectes peuvent empêcher l’accès aux comptes enfants d’annonceurs.

Étapes suivantes

Après avoir rassemblé vos informations d’identification et confirmé le modèle d’accès à votre compte, continuez avec l’un des chemins de configuration suivants :

recommendation-more-help
experience-platform-help-sources