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é.

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

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

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.

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.

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

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.

Vous verrez alors ceci :

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

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 :

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

Cliquez sur ENREGISTRER ET CONTINUER.

Vous verrez alors ceci. Cliquez sur ENREGISTRER ET CONTINUER.

Vous verrez alors ceci. Cliquez sur ENREGISTRER ET CONTINUER.

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

Vous verrez alors ceci. Cliquez sur PUBLISH APP.

Cliquez sur CONFIRMER.

Vous verrez alors ceci.

À 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 :

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

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

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

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 :

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.

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 :

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

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 :

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.

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

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.

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

Veuillez remplir les champs suivants du tableau :

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

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

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

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

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

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é.

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

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

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

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.

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

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

Cliquez sur Code d'autorisation Exchange pour les jetons.

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.

Vous allez maintenant voir le jeton d’actualisation.

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 :

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.

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.

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

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

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

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

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ébut en nommant la connexion :

Veuillez utiliser cette convention d'affectation de nom :

Ce qui devrait vous donner quelque chose comme ça :

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

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

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

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é.

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

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

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