12.3 Connexion de GCP et BigQuery à Adobe Experience Platform

Objectifs

  • Exploration des API et services dans Google Cloud Platform
  • 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 des 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 Google Cloud Platform et votre environnement BigQuery pour recevoir les appels d’API de Adobe Experience Platform.

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

  • project
  • clientId
  • clientSecret
  • refreshToken

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

Copiez l’ID de projet dans un fichier texte séparé.

Credential Dénomination Exemple
Identifiant de 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 menu supérieure :

demo

L’ID de projet s’affiche sur le côté droit :

demo

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

  • clientId
  • clientSecret
  • refreshToken

12.3.1 API et services cloud Google

Pour commencer, revenez à la page d’accueil de Google Cloud Platform. Pour ce faire, cliquez simplement sur le logo dans le coin supérieur gauche de votre écran.

demo

Une fois que vous êtes sur la page d’accueil, accédez au menu de gauche, puis cliquez sur API et services, puis cliquez sur Tableau de bord.

demo

Vous verrez maintenant le API et services page d’accueil.

demo

Sur cette page, vous pouvez voir l’utilisation de vos différentes connexions 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. Pour des raisons de sécurité de Google, un être humain doit également effectuer la première authentification, avant qu’un accès programmatique ne soit autorisé.
  • Deuxièmement, vous avez besoin des informations d’identification API (clientId et clientSecret) qui seront utilisées pour l’authentification API et l’accès à votre connecteur BigQuery.

Écran de consentement OAuth 12.3.2

Commençons par créer l’écran de consentement OAuth. Dans le menu de gauche de la API et services homepage, cliquez sur Écran de consentement OAuth.

demo

Vous verrez alors :

demo

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

demo

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

La seule chose à faire ici est de saisir le nom de l'écran de consentement dans la Nom de l’application et sélectionnez le champ Adresse électronique du service clientèle. Pour le Nom de l’application, utilisez cette convention d’affectation des noms :

Dénomination Exemple
--demoProfileLdap-- - AEP BigQuery Connector vangeluw - AEP BigQuery Connector

demo

Faites ensuite défiler l’écran vers le bas jusqu’à ce que vous voyiez Coordonnées du développeur et indiquez une adresse électronique.

demo

Cliquez sur ENREGISTRER ET CONTINUER.

demo

Vous verrez alors ceci. Cliquez sur ENREGISTRER ET CONTINUER.

demo

Vous verrez alors ceci. Cliquez sur ENREGISTRER ET CONTINUER.

demo

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

demo

Vous verrez alors ceci. Cliquez sur PUBLIER L’APPLICATION.

demo

Cliquez sur CONFIRMER.

demo

Vous verrez alors ceci.

demo

À l’étape suivante, vous allez terminer la configuration de l’API et obtenir vos informations d’identification d’API.

12.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 :

demo

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

demo

Vous verrez 3 options. Cliquez sur le bouton ID client OAuth:

demo

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

demo

Plusieurs nouveaux champs s’affichent. Vous devez maintenant saisir la variable Nom de l’ID client OAuth et saisissez également la variable URI de redirection autorisés.

Suivez cette convention d’affectation des noms :

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 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 de BigQuery Source Connector dans Adobe Experience Platform.

demo

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

Cliquez ensuite sur Créer:

demo

Votre ID client et votre secret client s’affichent désormais.

demo

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.

Pour récupérer votre configuration du connecteur source BigQuery dans Adobe Experience Platform, vous disposez déjà des valeurs suivantes :

Informations d’identification de BigQuery Connector Valeur
Identifiant de projet votre propre ID de projet (ex.: composer-task-306413)
clientid yourclientid
cilentsecret yourclientsecret

Vous manquez toujours le refreshToken. Pour des raisons de sécurité, l’attribut refreshToken est obligatoire. Dans le monde des API, les jetons expirent généralement toutes les 24 heures. Ainsi, la variable 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 à Google Cloud Platform et à BigQuery.

12.3.4 API BigQuery et refreshToken

Il existe de nombreuses façons d’obtenir un jeton d’actualisation pour accéder aux API Google Cloud Platform. L’une de ces options est par exemple l’utilisation de Postman.
Cependant, Google a créé quelque chose de plus facile à tester et à lire avec ses API, un outil appelé OAuth 2.0 Playground.

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

Vous verrez alors le OAuth 2.0 Playground page d’accueil.

demo

Cliquez sur le bouton engrenage dans le coin supérieur droit de l’écran :

demo

Assurez-vous que vos paramètres sont identiques à ce que vous pouvez voir dans l’image ci-dessus.

Vérifiez deux fois que les paramètres sont sûrs à 100 %.

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

demo

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

demo

Renseignez les champs suivants du tableau :

Paramètres de l’API de terrain de lecture Vos informations d’identification d’API Google
ID client OAuth votre propre identifiant client (dans le fichier texte de votre bureau) ;
Secret client OAuth votre propre secret client (dans le fichier texte de votre bureau)

demo

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

demo

Une fois que vous avez rempli vos informations d’identification, veuillez cliquer sur Fermer

demo

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

demo

Sélectionnez ensuite la portée comme indiqué dans l’image ci-dessous :

demo

Une fois que vous les avez sélectionnés, un bouton bleu s’affiche, qui indique : Autorisation des API. Cliquez dessus.

demo

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

Un avertissement peut s'afficher : Cette application n’est pas vérifiée. Cela se produit car votre Platform BigQuery Connector n’a pas encore été officiellement validé. Google ne sait donc pas s’il s’agit d’une application authentique ou non. Vous devez ignorer cette notification.

Cliquez sur Avancé.

demo

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

demo

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

demo

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

demo

Google vous montre maintenant huit Autorisation s’affiche. 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 autorise les demandes programmatiques).

Encore une fois, huit fenêtres contextuelles différentes ne s’affiche pas. Vous devez cliquer sur Autoriser pour tous.

demo

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

demo

Après la dernière Autoriser Cliquez en appuyant sur la touche, vous serez renvoyé à la plate-forme OAuth 2.0 et vous verrez ceci :

demo

Cliquez sur Échanger le code d’autorisation des jetons.

demo

Après quelques secondes, la variable Étape 2 - Échange du code d’autorisation pour les jetons se ferme automatiquement. vous verrez Étape 3 - Configuration de la requête vers l’API.

Vous devez retourner à Étape 2 Échange du code d’autorisation pour les jetons, puis cliquez sur Étape 2 Échange du code d’autorisation pour les jetons pour visualiser à nouveau le Jeton d’actualisation.

demo

Vous verrez maintenant le Jeton d’actualisation.

demo

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

Informations d’identification du connecteur source BigQuery Valeur
Identifiant de projet votre propre ID de projet aléatoire (par exemple,: apt-summer-273608)
clientid yourclientid
cilentsecret yourclientsecret
refreshtoken yourrefreshtoken

Ensuite, configurez votre connecteur source dans Adobe Experience Platform.

Exercice 12.3.5 - Connecter Platform à 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 une sandbox. L’environnement de test à sélectionner est nommé --aepSandboxId--. Pour ce faire, cliquez sur le texte Production Prod dans la ligne bleue en haut de votre écran. Après avoir sélectionné l’environnement de test approprié, l’écran change et vous êtes désormais dans votre environnement de test dédié.

Ingestion des données

Dans le menu de gauche, accédez à Sources. Vous verrez alors le Sources page d’accueil. Dans le Sources , cliquez sur Bases de données. Cliquez sur le bouton Google BigQuery carte. Cliquez ensuite sur Configuration ou + Configurer.

demo

Vous devez maintenant créer une connexion.

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

demo

Commençons par nommer la connexion :

Utilisez cette convention d’affectation des noms :

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

Ce qui devrait vous donner quelque chose comme ceci :

demo

Renseignez ensuite l’API GCP et BigQuery Authentification du compte-details que vous avez stocké dans un fichier texte sur votre bureau :

Informations d’identification de BigQuery Connector Valeur
Identifiant de projet votre propre ID de projet aléatoire (par exemple,: apt-summer-273608)
clientId
clientSecret
refreshToken

Votre Authentification du compte-details doit maintenant ressembler à ceci :

demo

Après avoir renseigné tous ces champs, cliquez sur Connexion à la source.

demo

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

demo

Maintenant que votre connexion est créée, veuillez cliquer sur Suivant:

demo

Le jeu de données BigQuery que vous avez créé lors de l’exercice 12.2 s’affiche désormais.

demo

Bien joué ! Dans l’exercice suivant, vous allez charger des données de cette table et les mapper à un schéma et à un jeu de données dans Adobe Experience Platform.

Étape suivante : 12.4 Chargement de données de BigQuery dans Adobe Experience Platform

Revenir au module 12

Revenir à tous les modules

Sur cette page