16.3 Connexion de GCP et BigQuery à Adobe Experience Platform

Objectifs

  • Explorez l’API et les services dans la plate-forme Google Cloud
  • Familiarisez-vous avec OAuth Playground pour le test des API Google
  • Créer votre première connexion BigQuery dans Adobe Experience Platform

Contexte

Adobe Experience Platform fournit un connecteur dans Sources qui vous aidera à importer les jeux de données BigQuery dans Adobe Experience Platform. Ce connecteur de données est basé sur l’API Google BigQuery. Par conséquent, il est important de préparer correctement votre plateforme Google Cloud et votre environnement BigQuery à recevoir des appels d’API de Adobe Experience Platform.

Pour configurer le connecteur de source BigQuery dans Adobe Experience Platform, vous aurez besoin de ces 4 valeurs :

  • projet
  • clientId
  • clientSecret
  • refreshToken

Jusqu'à présent, vous n'avez que le premier, l'ID de projet. Cette valeur ID de projet est un ID aléatoire généré par Google lorsque vous avez créé votre projet BigQuery au cours de l’exercice 16.1.

Copiez l'ID du projet dans un fichier texte séparé.

Informations d’identification Dénomination Exemple
ID du projet random composé-tâche-306413

Vous pouvez vérifier votre ID de projet à tout moment en cliquant sur Nom du projet dans la barre de menus supérieure :

démo

Vous verrez l'ID de projet sur le côté droit :

démo

Dans cet exercice, vous apprendrez à obtenir les 3 autres champs obligatoires :

  • clientId
  • clientSecret
  • refreshToken

16.3.1 API et services Google Cloud

Pour début, veuillez revenir à la page d'accueil de plateforme Google Cloud. Pour ce faire, il vous suffit de cliquer sur le logo dans le coin supérieur gauche de votre écran.

démo

Une fois que vous êtes sur la page d'accueil, accédez au menu de gauche et cliquez sur APIs & Services, puis sur Tableau de bord.

démo

Vous allez maintenant voir la page d'accueil des API et services.

démo

Sur cette page, vous pouvez voir l'utilisation de vos différentes connexions d'API Google. Pour configurer une connexion API afin que Adobe Experience Platform puisse lire à partir de BigQuery, vous devez suivre les étapes suivantes :

  • Tout d’abord, vous devez créer un écran de consentement OAuth pour activer les authentifications futures. Les raisons de sécurité de Google exigent également qu'un être humain effectue la première authentification, avant qu'un accès programmatique ne soit autorisé.
  • Ensuite, vous avez besoin des informations d’identification d’API (clientId et clientSecret) qui seront utilisées pour l’authentification d’API et l’accès à votre connecteur BigQuery.

16.3.2 Écran de consentement OAuth

Début avec la création de l'écran de consentement OAuth. Dans le menu de gauche de la page d'accueil API et services, cliquez sur Ecran de consentement OAuth.

démo

Vous verrez alors ceci :

démo

Sélectionnez le type d’utilisateur : Externe. Cliquez ensuite sur CREATE.

démo

Vous serez alors sur la fenêtre Configuration de l’écran de consentement OAuth.

La seule chose à faire ici est d'entrer le nom de l'écran de consentement dans le champ Nom de l'application et de sélectionner le courriel d'assistance utilisateur. Pour le nom de l’application, utilisez cette convention d’affectation de nom :

Dénomination Exemple
ldap - AEP BigQuery Connector vangeluw - Platform BigQuery Connector

démo

Ensuite, faites défiler l'écran jusqu'à ce que les coordonnées du développeur s'affichent et que vous renseigniez une adresse électronique.

démo

Cliquez sur ENREGISTRER ET CONTINUER.

démo

Vous verrez alors ceci. Cliquez sur ENREGISTRER ET CONTINUER.

démo

Vous verrez alors ceci. Cliquez sur ENREGISTRER ET CONTINUER.

démo

Vous verrez alors ceci. Cliquez sur RETOUR AU TABLEAU DE BORD.

démo

Vous verrez alors ceci. Cliquez sur PUBLISH APP.

démo

Cliquez sur CONFIRMER.

démo

Vous verrez alors ceci.

démo

À l’étape suivante, vous terminerez la configuration de l’API et obtiendrez vos informations d’identification d’API.

16.3.3 Informations d’identification de l’API Google : Secret client et ID client

Dans le menu de gauche, cliquez sur Informations d’identification. Vous verrez alors ceci :

démo

Cliquez sur le bouton + CRÉER LES INFORMATIONS D’IDENTIFICATION.

démo

Vous verrez 3 options. Cliquez sur l'ID client OAuth :

démo

Dans l’écran suivant, sélectionnez Application web.

démo

Plusieurs nouveaux champs apparaîtront. Vous devez maintenant entrer le nom de l'ID client OAuth et également saisir les URI de redirection autorisés a3/>.

Suivez cette convention d’affectation de nom :

Champ Valeur Exemple
Nom ldap - AEP BigQuery Connector vangeluw - Platform BigQuery Connector
URI de redirection autorisés https://developers.google.com/oauthplayground https://developers.google.com/oauthplayground

Le champ URI de redirection autorisés est un champ très important car vous en aurez besoin plus tard pour obtenir le RefreshToken, vous devez terminer la configuration du connecteur source BigQuery dans Adobe Experience Platform.

démo

Avant de continuer, vous devez appuyer physiquement sur le bouton Entrée après avoir saisi l’URL pour stocker la valeur dans le champ URI de redirection autorisés. Si vous ne cliquez pas sur le bouton Entrer, vous rencontrez des problèmes ultérieurement, dans le terrain de jeu OAuth 2.0.

Cliquez ensuite sur Créer :

démo

Vous allez maintenant voir votre ID de client et votre clé secrète client.

démo

Copiez ces deux champs et collez-les dans un fichier texte sur votre bureau. Vous pouvez toujours accéder à ces informations d’identification ultérieurement, mais il est plus facile de les enregistrer dans un fichier texte en regard de votre ID de projet BigQuery.

En tant que recapitulatif pour la configuration de BigQuery Source Connector dans Adobe Experience Platform, vous disposez déjà des valeurs suivantes :

Informations d’identification BigQuery Connector Valeur
ID du projet votre propre ID de projet (ex.: composé-tâche-306413)
clientid yourclientid
cilentsecret yourclientsecret

Le refreshToken vous manque toujours. Pour des raisons de sécurité, la valeur refreshToken est une exigence. Dans le monde des API, les jetons arrivent à expiration toutes les 24 heures. Par conséquent, refreshToken est nécessaire pour actualiser le jeton de sécurité toutes les 24 heures, de sorte que la configuration de votre connecteur source puisse continuer à se connecter à la plate-forme Google Cloud et à BigQuery.

16.3.4 API BigQuery et le jeton actualisé

Il existe de nombreuses façons d’obtenir un objet refreshToken pour accéder aux API de plateforme Google Cloud. Une de ces options est par exemple l'utilisation de Postman.
Cependant, Google a créé quelque chose de plus facile à tester et à jouer avec leurs API, un outil appelé OAuth 2.0 Playground.

Pour accéder à OAuth 2.0 Playground, accédez à https://developers.google.com/oauthplayground.

Vous verrez ensuite la page d'accueil OAuth 2.0 Playground.

démo

Cliquez sur l'icône engrenage dans le coin supérieur droit de l'écran :

démo

Assurez-vous que vos paramètres sont identiques à ceux de l’image ci-dessus.

Le doublon vérifie que les paramètres sont à 100 % sûrs.

Une fois que vous avez terminé, cochez la case Utiliser vos propres informations d’identification OAuth.

démo

Deux champs doivent s’afficher et vous avez la valeur pour eux.

démo

Veuillez remplir les champs suivants du tableau :

Paramètres de l’API Playground Vos informations d’identification d’API Google
ID client OAuth votre propre ID client (dans le fichier texte de votre bureau)
Secret client OAuth votre propre clé secrète client (dans le fichier texte de votre bureau)

démo

Copiez les ID client et Secret client du fichier texte que vous avez créé sur votre bureau.

démo

Une fois vos informations d’identification remplies, cliquez sur Fermer.

démo

Dans le menu de gauche, vous pouvez afficher toutes les API Google disponibles. Recherchez BigQuery API v2.

démo

Ensuite, sélectionnez l’étendue comme indiqué dans l’image ci-dessous :

démo

Une fois que vous les avez sélectionnés, un bouton bleu s’affiche, indiquant Autoriser les API. Cliquez dessus.

démo

Sélectionnez le compte Google que vous avez utilisé pour configurer GCP et BigQuery.

On peut voir un gros avertissement : Cette application n'est pas vérifiée. Cela se produit car votre plateforme BigQuery Connector n'a pas encore été officiellement révisée, Google ne sait donc pas s'il s'agit d'une application authentique ou non. Vous devriez ignorer cette notification.

Cliquez sur Avancé.

démo

Cliquez ensuite sur Aller à ldap - AEP BigQuery Connector (non sécurisé).

démo

Vous serez redirigé vers notre écran de consentement OAuth que vous avez créé.

démo

Si vous utilisez l’authentification à deux facteurs (2FA), saisissez le code de vérification qui vous a été envoyé.

démo

Google va maintenant vous montrer huit invites Permission différentes. Cliquez sur Autoriser pour les huit demandes d’autorisation. (Il s'agit d'une procédure qui doit être suivie et confirmée une fois par un être humain réel, avant que l'API ne permette les demandes programmatiques)

Là encore, huit fenêtres contextuelles différentes ne s'afficheront pas, vous devez cliquer sur Autoriser pour toutes les fenêtres.

démo

Après les huit demandes d’autorisation, vous verrez cet aperçu. Cliquez sur Autoriser pour terminer le processus.

démo

Après le dernier Autoriser-clic, vous serez renvoyé à la plate-forme OAuth 2.0 et vous verrez ceci :

démo

Cliquez sur Code d'autorisation Exchange pour les jetons.

démo

Au bout de quelques secondes, la vue Étape 2 - Échange le code d'autorisation pour les jetons se ferme automatiquement et vous verrez Étape 3 - Configurer la demande à l'API.

Vous devez revenir au code d'autorisation d'échange de l'étape 2 pour les jetons. Cliquez donc de nouveau sur code d'autorisation d'échange de l'étape 2 pour les jetons pour visualiser le jeton d'actualisation.

démo

Vous allez maintenant voir le jeton d’actualisation.

démo

Copiez le jeton d’actualisation et collez-le dans le fichier texte de votre bureau avec les autres informations d’identification du connecteur de source BigQuery :

Informations d'identification du connecteur de source BigQuery Valeur
ID du projet votre propre ID de projet aléatoire (ex.: apt-Summer-273608)
clientid yourclientid
cilentsecret yourclientsecret
actualiser yourrefreshtoken

Ensuite, configurez votre connecteur source dans Adobe Experience Platform.

Exercice 16.3.5 - Connecter la plate-forme à votre propre table BigQuery

Connectez-vous à Adobe Experience Platform en accédant à cette URL : https://experience.adobe.com/platform.

Une fois connecté, vous accédez à la page d'accueil de Adobe Experience Platform.

Ingestion des données

Avant de continuer, vous devez sélectionner un sandbox. Le sandbox à sélectionner est nommé --aepSandboxId--. Pour ce faire, cliquez sur le texte Production Prod dans la ligne bleue au-dessus de votre écran.

Ingestion des données

Après avoir sélectionné le sandbox approprié, vous verrez l'écran changer et vous êtes maintenant dans votre sandbox dédié.

Ingestion des données

Dans le menu de gauche, accédez à Sources.

démo

Vous verrez ensuite la page d'accueil Sources. Dans le menu Sources, cliquez sur Bases de données.

démo

Cliquez sur la carte Google BigQuery. Cliquez ensuite sur + Configurer.

démo

Vous devez maintenant créer une nouvelle connexion.

Cliquez sur Nouveau compte. Vous devez maintenant remplir tous les champs ci-dessous, en fonction de la configuration que vous avez effectuée dans GCP et BigQuery.

démo

Début en nommant la connexion :

Veuillez utiliser cette convention d'affectation de nom :

Informations d’identification BigQuery Connector Valeur Exemple
Nom du compte ldap - Connexion à BigQuery vangeluw - Connexion à BigQuery
Description ldap - Connexion à BigQuery vangeluw - Connexion à BigQuery

Ce qui devrait vous donner quelque chose comme ça :

démo

Ensuite, renseignez les champs GCP et BigQuery API Account Authentication-details que vous avez stockés dans un fichier texte sur votre bureau :

Informations d’identification BigQuery Connector Valeur
ID du projet votre propre ID de projet aléatoire (ex.: apt-Summer-273608)
clientId
cilentSecret
refreshToken

Les détails de votre authentification de compte doivent maintenant ressembler à ceci :

démo

Après avoir rempli tous ces champs, cliquez sur Se connecter à la source.

démo

Si vos détails Authentification du compte ont été correctement renseignés, vous devriez maintenant voir une confirmation visuelle du bon fonctionnement de la connexion en voyant la confirmation Connecté.

démo

Maintenant que votre connexion a été créée, cliquez sur Suivant :

démo

Vous allez maintenant voir le jeu de données BigQuery que vous avez créé lors de l'exercice 16.2.

démo

Bien joué ! Au cours de l'exercice suivant, vous allez charger les données de cette table et les mapper sur un schéma et un jeu de données dans Adobe Experience Platform.

Étape suivante : 16.4 Charger les données de BigQuery dans Adobe Experience Platform

Revenir au module 16

Revenir à tous les modules

Sur cette page