21.4 Création et configuration d’une fonction Google Cloud

21.4.1 Création de votre fonction Google Cloud

Accédez à https://console.cloud.google.com/. Accédez à Fonctions cloud.

GCP

Vous verrez alors ceci. Cliquez sur Créer un projet.

GCP

En tant que nom du projet, utilisez Launch côté serveur - GCP.
En tant que Emplacement, indiquez où stocker votre projet.

Cliquez sur CREATE.

GCP

Votre projet sera alors créé.

GCP

Vous pouvez ensuite créer une fonction Cloud. Cliquez sur CRÉER UNE FONCTION.

GCP

Vous verrez alors ceci.

GCP

Effectuez les choix suivants :

  • Nom de la fonction : ldap-launch-ssf (remplacez ldap par votre ldap)
  • Région : sélectionner une région
  • Type de déclencheur : select HTTP
  • Authentification : Sélectionnez Autoriser les appels non authentifiés .

Vous devriez maintenant avoir ceci. Cliquez sur SAVE.

GCP

Cliquez sur NEXT.

GCP

Vous verrez alors :

GCP

Effectuez les choix suivants :

  • Runtime : sélectionnez Node.js 12
  • Point d’entrée : enter helloAEP

GCP

Cliquez sur ENABLE API pour activer l’API Cloud Build. Vous verrez alors une nouvelle fenêtre. Dans cette nouvelle fenêtre, cliquez de nouveau sur ENABLE.

GCP

Une fois que l’API de création de cloud a été activée, vous verrez ceci.

GCP

Revenez à la fonction cloud.

GCP

Dans votre éditeur en ligne de fonction Cloud, assurez-vous que vous y avez le code suivant :

/**
 * Responds to any HTTP request.
 *
 * @param {!express:Request} req HTTP request context.
 * @param {!express:Response} res HTTP response context.
 */
exports.helloAEP = (req, res) => {
  let message = req.query.message || req.body.message || 'Hello World!';
  res.status(200).send(message);
};

Cliquez ensuite sur DEPLOY.

Vous verrez alors ceci. Votre fonction cloud est en cours de création. Cela peut prendre quelques minutes.

GCP

Une fois votre fonction créée et en cours d’exécution, vous verrez ceci. Cliquez sur le nom de la fonction pour l’ouvrir.

GCP

Vous verrez alors ceci. Accédez à TRIGGER. Vous verrez ensuite l’URL du déclencheur qui est ce que vous utiliserez pour définir le point de terminaison dans Launch côté serveur.

GCP

Copiez l'URL du déclencheur, qui se présente comme suit : https://us-central1-launch-server-side-gcp.cloudfunctions.net/vangeluw-launch-ssf.

Dans les étapes suivantes, vous allez configurer le serveur de collecte de données Adobe Experience Platform pour diffuser des informations spécifiques sur Pages vues vers votre fonction Google Cloud. Au lieu de transférer uniquement la charge utile complète en l’état, vous enverrez uniquement des éléments tels que ECID, horodatage et Nom de page à votre fonction Google Cloud.

Voici un exemple de payload que vous devez analyser pour filtrer les variables mentionnées ci-dessus :

{
  "events": [
    {
      "xdm": {
		  "eventType": "web.webpagedetails.pageViews",
		  "web": {
		    "webPageDetails": {
		      "URL": "https://public.aepdemo.net/index.html",
		      "name": "Luma Home"
		    },
		    "webReferrer": {
		      "URL": "https://public.aepdemo.net/admin.html"
		    }
		  },
		  "device": {
		    "screenHeight": 1080,
		    "screenWidth": 1920,
		    "screenOrientation": "landscape"
		  },
		  "environment": {
		    "type": "browser",
		    "browserDetails": {
		      "viewportWidth": 1920,
		      "viewportHeight": 507,
		      "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 11_1_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.96 Safari/537.36",
		      "acceptLanguage": "en"
		    }
		  },
		  "placeContext": {
		    "localTime": "2021-01-29T15:45:26.815+01:00",
		    "localTimezoneOffset": -60
		  },
		  "timestamp": "2021-01-29T14:45:26.815Z",
		  "implementationDetails": {
		    "name": "https://ns.adobe.com/experience/alloy/reactor",
		    "version": "2.3.0+2.2.0",
		    "environment": "browser"
		  },
		  "_experienceplatform": {
		    "identification": {
		      "core": {
		        "ecid": "83249052138816938582105724584714316131"
		      }
		    },
		    "demoEnvironment": {
		      "tms": "Launch",
		      "ldap": "vangeluw",
		      "brandLogo": "https://parsefiles.back4app.com/hgJBdVOS2eff03JCn6qXXOxT5jJFzialLAHJixD9/d632e769791f0a4dbe0b84058d282d45_logo.png",
		      "brandName": "Luma",
		      "brandIndustry": "retail"
		    }
		  }
		}

Il s’agit des champs qui contiennent les informations qui doivent être analysées :

  • ECID : events.xdm._experienceplatform.identification.core.ecid
  • timestamp : horodatage
  • Nom de la page : events.xdm.web.webPageDetails.name

Allons maintenant sur le serveur de collecte de données Adobe Experience Platform pour configurer les éléments de données afin de rendre cela possible.

21.4.2 Mise à jour de la propriété du serveur de collecte de données Adobe Experience Platform : Éléments de données

Accédez à https://experience.adobe.com/#/data-collection/.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Dans le coin supérieur gauche, cliquez sur Côté client et dans le menu déroulant, cliquez sur Côté serveur. Vous verrez ensuite un aperçu de toutes les propriétés disponibles du serveur de collecte de données Adobe Experience Platform. Cliquez pour ouvrir la propriété que vous avez créée dans exercice 21.1.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Dans le menu de gauche, accédez à Éléments de données. Cliquez sur Ajouter un élément de données.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Un nouvel élément de données à configurer s’affiche.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Effectuez la sélection suivante :

  • Comme Nom, saisissez customerECID.
  • En tant que Extension, sélectionnez Core.
  • En tant que Type d’élément de données, sélectionnez Chemin.
  • Comme Chemin, saisissez arc.event.xdm.--aepTenantId--.identification.core.ecid. En entrant ce chemin, vous allez filtrer le champ ecid de la payload de l’événement envoyée par le site web ou l’application mobile dans Adobe Edge.
REMARQUE

Dans les chemins ci-dessus et ci-dessous, une référence est faite à arc. ​arcdésigne Adobe Resource Context et ​arcalways désigne l’objet disponible le plus élevé disponible dans le contexte côté serveur. Des enrichissements et des transformations peuvent être ajoutés à cet objet arc à l’aide des fonctions du serveur de collecte de données Adobe Experience Platform.

Dans les chemins ci-dessus et ci-dessous, une référence est faite à event. ​représente un événement unique et le serveur de collecte de données Adobe Experience Platform évalue toujours chaque événement individuellement. Parfois, vous pouvez voir une référence à events dans la payload envoyée par le SDK Web côté client, mais dans le serveur de collecte de données Adobe Experience Platform, chaque événement est évalué individuellement.

Vous allez maintenant avoir ceci. Cliquez sur Enregistrer.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Cliquez sur Ajouter un élément de données.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Un nouvel élément de données à configurer s’affiche.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Effectuez la sélection suivante :

  • En tant que Nom, saisissez eventTimestamp.
  • En tant que Extension, sélectionnez Core.
  • En tant que Type d’élément de données, sélectionnez Chemin.
  • En tant que Chemin, saisissez arc.event.xdm.timestamp. En entrant ce chemin, vous allez filtrer le champ horodatage de la payload d’événement envoyée par le site web ou l’application mobile dans Adobe Edge.

Vous allez maintenant avoir ceci. Cliquez sur Enregistrer.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Cliquez sur Ajouter un élément de données.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Un nouvel élément de données à configurer s’affiche.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Effectuez la sélection suivante :

  • En tant que Nom, saisissez pageName.
  • En tant que Extension, sélectionnez Core.
  • En tant que Type d’élément de données, sélectionnez Chemin.
  • En tant que Chemin, saisissez arc.event.xdm.web.webPageDetails.name. En entrant ce chemin, vous allez filtrer le champ name de la payload de l’événement envoyée par le site web ou l’application mobile dans Adobe Edge.

Vous allez maintenant avoir ceci. Cliquez sur Enregistrer.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Ces éléments de données sont maintenant créés :

Transfert côté serveur de la collecte de données Adobe Experience Platform

21.4.3 Mise à jour de la propriété du serveur de collecte de données Adobe Experience Platform : Mettre à jour une règle

Dans le menu de gauche, accédez à Règles. Dans l’exercice précédent, vous avez créé la règle Toutes les pages. Cliquez sur cette règle pour l’ouvrir.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Vous ferez alors ceci. Cliquez sur l’icône + sous Actions pour ajouter une nouvelle action.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Vous verrez alors ceci.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Effectuez la sélection suivante :

  • Sélectionnez Extension : Adobe Cloud Connector.
  • Sélectionnez le Type d’action : Lancer l’appel de récupération.

Cela devrait vous donner le nom suivant : Adobe Cloud Connector - Lancer l’appel de récupération. Vous devriez maintenant voir ceci :

Transfert côté serveur de la collecte de données Adobe Experience Platform

Configurez ensuite les éléments suivants :

  • Modifiez le protocole de requête de GET en POST.
  • Saisissez l’URL de la fonction Google Cloud que vous avez créée lors de l’une des étapes précédentes qui ressemble à ceci : https://us-central1-launch-server-side-gcp.cloudfunctions.net/vangeluw-launch-ssf

Vous devriez maintenant avoir ceci. Ensuite, accédez à Body.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Vous verrez alors ceci. Cliquez sur le bouton radio JSON.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Configurez Body comme suit :

CLÉ VALEUR
customerECID {{customerECID}}
pageName {{pageName}}
eventTimestamp {

Vous verrez alors ceci. Cliquez sur Conserver les modifications.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Vous verrez alors ceci. Cliquez sur Enregistrer.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Vous avez maintenant mis à jour votre règle existante dans une propriété de serveur de collecte de données Adobe Experience Platform. Accédez à Flux de publication pour publier vos modifications. Ouvrez votre bibliothèque de développement v1 en cliquant sur Modifier comme indiqué.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Cliquez sur le bouton Ajouter toutes les ressources modifiées, après quoi votre règle et votre élément de données apparaîtront dans cette bibliothèque. Cliquez ensuite sur Enregistrer et créer pour le développement. Vos modifications sont en cours de déploiement.

Transfert côté serveur de la collecte de données Adobe Experience Platform

Au bout de quelques minutes, vous verrez que le déploiement est terminé et prêt à être testé.

Transfert côté serveur de la collecte de données Adobe Experience Platform

21.3.4 Test de votre configuration

Ouvrez une nouvelle fenêtre de navigateur incognito propre et accédez à https://public.aepdemo.net.

Vous verrez alors ceci.

Configuration de la collecte de données Adobe Experience Platform

Saisissez votre ID de configuration et cliquez sur Charger la configuration. Votre configuration est ensuite chargée.

Configuration de la collecte de données Adobe Experience Platform

Faites défiler l’écran vers le bas et cliquez sur Enregistrer la configuration.

Configuration de la collecte de données Adobe Experience Platform

Vous serez ensuite redirigé vers la page d’accueil Admin. Accédez à Sélectionnez LDAP. Sélectionnez votre LDAP et cliquez sur Enregistrer.

Configuration de la collecte de données Adobe Experience Platform

Vous serez ensuite redirigé vers la page d’accueil Admin. Accédez à Sélectionner la marque et sélectionnez la marque Luma, cliquez sur Enregistrer.

Configuration de la collecte de données Adobe Experience Platform

Vous serez ensuite redirigé vers la page d’accueil Admin. Cliquez sur le logo Luma .

Configuration de la collecte de données Adobe Experience Platform

Vous verrez ensuite la page d’accueil de Luma.

Configuration de la collecte de données Adobe Experience Platform

Lorsque vous ouvrez la vue Développeur de votre navigateur, vous pouvez examiner les demandes réseau comme indiqué ci-dessous. Lorsque vous utilisez le filtre interagir, les demandes réseau envoyées par le client de collecte de données Adobe Experience Platform à Adobe Edge s’affichent.

Configuration de la collecte de données Adobe Experience Platform

Basculez votre vue vers votre fonction Google Cloud et accédez à LOGS. Vous devriez maintenant avoir une vue similaire à celle-ci, avec plusieurs entrées de journal affichées. Chaque fois que vous voyez L’exécution de la fonction a commencé, cela signifie que le trafic entrant a été reçu dans votre fonction Google Cloud.

Configuration de la collecte de données Adobe Experience Platform

Mettons un peu à jour votre fonction pour qu’elle fonctionne avec les données entrantes et affiche les informations reçues du serveur de collecte de données Adobe Experience Platform. Accédez à SOURCE et cliquez sur EDIT.

Configuration de la collecte de données Adobe Experience Platform

Dans l’écran suivant, cliquez sur NEXT.

Configuration de la collecte de données Adobe Experience Platform

Mettez à jour votre code comme suit :

/**
 * Responds to any HTTP request.
 *
 * @param {!express:Request} req HTTP request context.
 * @param {!express:Response} res HTTP response context.
 */
exports.helloAEP = (req, res) => {
  console.log('>>>>> Function has started. The following information was received from Launch Server Side:');
  console.log(req.body);

  let message = req.query.message || req.body.message || 'Hello World!';
  res.status(200).send(message);
};

Vous aurez alors ceci. Cliquez sur DEPLOY.

Configuration de la collecte de données Adobe Experience Platform

Au bout de quelques minutes, votre fonction sera de nouveau déployée. Cliquez sur le nom de votre fonction pour l’ouvrir.

Configuration de la collecte de données Adobe Experience Platform

Sur votre site web de démonstration, accédez à un produit, par exemple Nadia Elements Shell.

Configuration de la collecte de données Adobe Experience Platform

Basculez votre vue vers votre fonction Google Cloud et accédez à LOGS. Vous devriez maintenant avoir une vue similaire à celle-ci, avec plusieurs entrées de journal affichées.

Pour chaque page vue de votre site web de démonstration, une nouvelle entrée de journal s’affiche dans les journaux de votre fonction Google Cloud, qui affiche les informations reçues.

Configuration de la collecte de données Adobe Experience Platform

Vous avez maintenant réussi à envoyer des données collectées par Adobe Experience Platform Data Collection, en temps réel, à un point de terminaison de fonction Google Cloud. À partir de là, ces données peuvent être utilisées par n’importe quelle application Google Cloud Platform, comme BigQuery pour le stockage et la création de rapports, ou pour des cas pratiques d’apprentissage automatique.

Étape suivante : 21.5 Création et configuration d’une fonction Microsoft Azure

Revenir au module 21

Revenir à tous les modules

Sur cette page