[Beta]{class="badge informative"}

Connexion de Google Ads à Experience Platform à l’aide de l’API Flow Service

Une connexion de base représente la connexion authentifiée entre votre source et Adobe Experience Platform. Suivez ce tutoriel pour connecter votre compte Google Ads à Experience Platform à l’aide de l’Flow Service API.

Une connexion de base à Google Ads stocke les détails d’authentification requis pour accéder à l’API Google Ads et crée l’identifiant de connexion que vous utiliserez aux étapes suivantes pour explorer votre configuration source et créer un flux de données.

Commencer

Ce guide nécessite une compréhension professionnelle des composants suivants d’Experience Platform :

Les sections suivantes contiennent des informations supplémentaires que vous devez connaître pour réussir à vous connecter à Google Ads à l’aide de l’API Flow Service.

Utilisation des API Experience Platform

Pour plus d’informations sur la manière d’effectuer avec succès des appels vers les API Experience Platform, consultez le guide Prise en main des API Experience Platform.

Collecte des valeurs des en-têtes requis

Pour lancer des appels aux API d’Experience Platform, vous devez d’abord suivre le tutoriel sur l’authentification. Le tutoriel sur l’authentification fournit les valeurs de chacun des en-têtes requis dans tous les appels API d’Experience Platform, comme illustré ci-dessous :

Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
x-sandbox-name: {SANDBOX_NAME}
Content-Type: application/json

Dans Experience Platform, toutes les ressources sont isolées dans des sandbox virtuels spécifiques. Toutes les requêtes envoyées aux API Experience Platform nécessitent un en-tête spécifiant le nom du sandbox dans lequel l’opération sera effectuée.

Collecter les informations d’identification requises

Pour plus d’informations sur l’authentification, consultez la Google Ads présentation de la source.

Créer une connexion de base

Une connexion de base conserve les informations échangées entre votre source et Experience Platform, y compris les informations d’authentification de votre source, l’état actuel de la connexion et votre identifiant de connexion de base unique.

Pour créer un identifiant de connexion de base, envoyez une requête POST au point d’entrée /connections et indiquez vos informations d’authentification Google Ads dans les paramètres de la requête.

Format d’API

POST /connections

Requête

La requête suivante crée une connexion de base pour Google Ads :

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json'
  -d '{
      "name": "Google Ads base connection",
      "description": "Google Ads base connection",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "clientCustomerID": "{CLIENT_CUSTOMER_ID}",
              "loginCustomerID": "{LOGIN_CUSTOMER_ID}",
              "developerToken": "{DEVELOPER_TOKEN}",
              "refreshToken": "{REFRESH_TOKEN}",
              "clientId": "{CLIENT_ID}",
              "clientSecret": "{CLIENT_SECRET}",
              "googleAdsApiVersion": "v19"

          }
      },
      "connectionSpec": {
          "id": "d771e9c1-4f26-40dc-8617-ce58c4b53702",
          "version": "1.0"
      }
  }'

Si votre compte d’annonceur cible est directement accessible et ne nécessite pas le routage gestionnaire-compte, vous pouvez omettre le loginCustomerID de l’objet auth.params.

Réponse

Une réponse réussie renvoie les détails de la connexion de base que vous venez de créer, y compris son identifiant unique (id). Cet identifiant est requis à l’étape suivante pour créer une connexion source.

{
    "id": "2484f2df-c057-4ab5-84f2-dfc0577ab592",
    "etag": "\"10033e77-0000-0200-0000-5e96785b0000\""
}

Vérifier les détails de votre connexion

Après avoir créé votre connexion de base, validez les éléments suivants avant de continuer :

Si l’authentification réussit mais que l’accès aux données en aval échoue, la cause la plus courante est une loginCustomerId incorrecte ou inutile.

Étapes suivantes

Ce tutoriel vous a permis de créer une connexion de base Google Ads à l’aide de l’API Flow Service.

Vous pouvez maintenant suivre les tutoriels suivants :

Dépannage

Erreurs d’autorisation pour les comptes enfants d’annonceurs

Si les requêtes échouent lorsque vous tentez d’accéder à un compte d’annonceur enfant, vérifiez que loginCustomerId est défini sur le compte de responsable approprié. Cela est nécessaire lorsque l’accès est arbitré par le biais d’une hiérarchie MCC.

Jeton d’actualisation non valide ou révoqué

Si le connecteur ne peut pas actualiser les jetons d’accès, réautorisez le compte Google Ads à générer un nouveau jeton d’actualisation.

Version d’API non prise en charge

Si les requêtes échouent en raison de versions incohérentes, assurez-vous que googleAdsApiVersion est défini sur une version prise en charge par Experience Platform.