5.4 Ingestion d’événements de commande hors ligne dans Adobe Experience Platform

Au cours de cet exercice, vous allez apprendre à importer des données de commande dans Informatica, à joindre des jeux de données et à ingérer des données transformées dans Adobe Experience Platform en tant qu’événements d’expérience.

Objectifs d’apprentissage

• Découvrez comment charger des données dans Informatica
• Découvrez comment créer un workflow de mappeur dans Informatica.
• Comprenez le processus permettant de joindre des jeux de données, d’enrichir les données et de les ingérer dans Platform.

Ressources de l’atelier

• Informatica : https://usw5.dm-us.informaticacloud.com/diUI/products/integrationDesign/main/home
• Adobe Experience Platform : https://experience.adobe.com/platform/

Tâches Lab

• Chargement de fichiers CSV de votre compartiment S3 dans Informatica pour les profils de programme de fidélité et de commandes hors ligne
• Créez un workflow de mappeur pour joindre les jeux de données ci-dessus, enrichir et filtrer les données.
• Exécutez la tâche pour ingérer les données dans Adobe Experience Platform

Contexte commercial : Utilisation d’Informatica pour ingérer des événements de commandes hors ligne dans Platform

Luma est une marque de mode et, en plus de sa présence en ligne, a des magasins de briques et mortiers dans le monde entier. Jusqu’à présent, l’équipe marketing a eu du mal à utiliser les données des commandes hors ligne pour optimiser son expérience en ligne. Récemment, ils ont introduit un nouveau programme de fidélité qui permet aux clients de collecter des points lors de leurs achats en magasin à l’aide de leur carte de fidélité. L’équipe marketing reçoit régulièrement un fichier plat contenant toutes les commandes hors ligne. Ils ont également un historique de tous les clients qui ont rejoint le programme de fidélité. Grâce à Informatica, nous rejoindrons les deux sources de données, enrichirons le résultat afin qu’il puisse être ingéré dans Adobe Experience Platform, puis hydratons le profil avec les événements de commande hors ligne.

Exercice 5.3.1 - Création de sources dans un workflow de mappage

Dans cet exercice, vous allez charger deux fichiers CSV de votre compartiment S3 dans Informatica :

• offline_orders.csv
• loyalty_data.csv

Accédez à https://apse1.dm-ap.informaticacloud.com/cloudshell/showProducts.

Connectez-vous à l’aide des informations d’identification qui vous ont été envoyées par courrier électronique.

Vous verrez ensuite la page d’accueil d’Informatica. Accédez à Intégration de données.

Sur la page d’accueil d’Informatica, cliquez sur le lien + Nouveau….

Vous verrez alors cette fenêtre contextuelle.

Dans le menu de gauche de la fenêtre contextuelle, sélectionnez Mappages. Sélectionnez ensuite Mapping.

Cliquez sur Créer pour commencer à créer votre workflow de mappage.

Vous verrez alors cet écran :

Commençons par configurer le nom de votre mappage. Pour le nom de votre mappage, utilisez LDAP - ex3. Dans cet exemple, le nom est vangeluw - ex3.

Cliquez sur Enregistrer dans le coin supérieur droit de l’écran pour enregistrer vos modifications.

Commençons ensuite la création de votre workflow de mappage. Votre workflow ressemble à ceci en ce moment.

Commençons par supprimer l’objet Target pour le moment. Sélectionnez l’objet Target et cliquez sur l’icône Supprimer .

Cliquez sur Supprimer dans la fenêtre contextuelle.

Votre workflow ressemble maintenant à ceci.

Sélectionnez l’objet Source . Après avoir sélectionné l’objet Source, une fenêtre Propriétés s’affiche au bas de votre écran.

Dans la fenêtre Propriétés, cliquez sur Source.

Ouvrez la liste déroulante Connexion, recherchez votre connexion S3 - LDAP et sélectionnez-la.

Vous verrez alors ceci.

Cliquez sur Sélectionner….

Vous verrez alors une fenêtre contextuelle qui affiche votre connexion S3. Dans la colonne Packages, le nom du compartiment s’affiche. Cliquez sur le nom du compartiment pour le sélectionner.

Après avoir sélectionné le nom de votre compartiment, vous verrez les quatre fichiers CSV que vous avez chargés dans votre compartiment S3 dans l’exercice 5.1.

Sélectionnez le fichier offline_orders.csv et cliquez sur OK.

Vous verrez alors ceci.

Dans la liste déroulante Format, remplacez le Type de format Aucun par Délimité.

Cliquez sur Options de formatage.

Dans l’écran Propriétés, cliquez sur Aperçu des données.

Vous devriez alors voir un aperçu comme celui-ci. Cliquez sur Terminé pour fermer la fenêtre d’aperçu.

Le fichier que vous venez de charger en tant que source contient les colonnes suivantes :

Colonne	Description
id	Numéro de ligne
timestamp	Horodatage du moment où le produit a été acheté
account_id	Identifiant du compte du programme de fidélité
product	SKU du produit
prix	Prix du produit
currency	Devise du prix du produit

Comme vous pouvez le voir dans l’aperçu, il existe plusieurs lignes vides, vous devrez donc procéder au nettoyage du fichier avant de l’ingérer dans Adobe Experience Platform.

Ensuite, vous allez configurer un second objet Source dans le workflow de mappage.

Faites glisser l’objet Source depuis le menu de gauche dans l’aperçu de la conception sur la zone de travail.

Vous devez maintenant disposer de la conception suivante :

Sélectionnez le second objet Source. Après avoir sélectionné le second objet Source, une nouvelle fenêtre Propriétés s’affiche au bas de votre écran.

Dans la fenêtre Propriétés, cliquez sur Source.

Ouvrez la liste déroulante Connexion, recherchez votre connexion S3 - LDAP et sélectionnez-la.

Vous verrez alors ceci.

Cliquez sur Sélectionner….

Vous verrez alors une fenêtre contextuelle qui affiche votre connexion S3. Dans la colonne Packages, le nom du compartiment s’affiche. Cliquez sur le nom du compartiment pour le sélectionner.

Après avoir sélectionné le nom de votre compartiment, vous verrez les quatre fichiers CSV que vous avez chargés dans votre compartiment S3 dans l’exercice 1.

Sélectionnez le fichier loyalty_data.csv et cliquez sur OK.

Vous verrez alors ceci.

Dans la liste déroulante Format, remplacez le Type de format Aucun par Délimité.

Vous aurez alors ceci.

Cliquez sur Options de formatage.

Dans l’écran Propriétés, cliquez sur Aperçu des données.

Vous devriez alors voir un aperçu comme celui-ci. Cliquez sur Terminé pour fermer la fenêtre d’aperçu.

Le fichier que vous venez de charger en tant que source contient les colonnes suivantes :

Colonne	Description
account_id	Identifiant du compte du programme de fidélité
first_name	Prénom du client
last_name	Nom du client
e-mail	Adresse électronique du client
gender	Genre du client
points	Nombre de points collectés par le client

Vous avez maintenant créé les connecteurs source requis pour cet exercice !

Exercice 5.3.2 - Sources de jointure

Dans cet exercice, vous rejoindrez les sources créées ci-dessus.

Votre workflow de mappage ressemble actuellement à ceci :

Vous devez maintenant rejoindre ces deux jeux de données. Pour ce faire, utilisez une balise Joiner. Dans le menu Conception, faites défiler l’écran vers le bas jusqu’à ce que l’objet Joiner s’affiche.

Faites glisser et déposez l’objet Joiner sur la zone de travail.

Ensuite, vous devez connecter les deux Sources au Joiner.

Cliquez sur l’icône orange + sur l’icône Joiner. Vous verrez désormais un noeud Principal et un noeud Détail.

Connectez la source à Principal et la source 1 aux détails comme indiqué ci-dessous.

Définissons maintenant les propriétés de la jointure.

Accédez à l’option de menu Champs entrants. Un message de notification indique que certains champs des deux sources portent le même nom. Réparons cela d'abord.

Cliquez sur Résoudre les conflits de nom de champ.

Tu vas voir cette fenêtre maintenant.

Pour Principal > Source, ouvrez la liste déroulante pour Options de changement de nom en bloc et sélectionnez Préfixe.

Saisissez le préfixe m_.

Cliquez sur OK.

Dans l’écran Champs entrants , vous pouvez maintenant faire défiler l’écran vers le bas. Vous verrez que tous les champs de la source du Principal ont désormais un préfixe m_ et que le message d’erreur a disparu.

Ensuite, vous devez définir la condition de jointure. Cliquez sur Condition de jointure dans le menu de gauche.

Vous verrez alors ceci.

Cliquez sur la petite icône +.

Une condition de jointure s’affiche alors.

Connectez ces deux champs entre eux :

m_account_id (string) = account_id (string)

Une fois que vous avez terminé, cliquez sur Enregistrer

Vos deux sources sont maintenant unies.

N’oubliez pas de cliquer sur Enregistrer pour enregistrer l’état actuel de votre mappage.

Exercice 5.3.3 - Filtrage des données

L’étape suivante consiste à filtrer les données. Plus précisément, vous devez supprimer les lignes vides potentielles, comme dans le cas d’un compte_id vide.

Pour filtrer les données, vous devez ajouter un objet Filter sur la zone de travail. Vous trouverez l’objet Filter dans le menu de gauche du workflow de conception.

Faites glisser et déposez l’objet Filter sur la zone de travail.

Regardez ensuite la fenêtre Propriétés .

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

Cliquez sur l’icône + sur le côté droit pour ajouter un filtre.

Remplacez la condition de filtrage par Avancé.

Cliquez sur le bouton Modifier la condition de filtrage .

Dans la fenêtre contextuelle Modifier le filtre, collez ce filtre :
IIF(ISNULL(account_id),FALSE,TRUE)

Cliquez sur OK pour enregistrer votre filtre.

Vous avez maintenant défini votre filtre, enrichissons vos données.

N’oubliez pas de cliquer sur Enregistrer pour enregistrer l’état actuel de votre mappage.

Exercice 5.3.4 - Enrichir les données

Lors de la phase d’enrichissement, vous pouvez ajouter des champs supplémentaires à votre jeu de données. Dans cet exemple, nous devons fournir un hitId unique à Adobe Experience Platform lors de l’ingestion de données d’événement d’expérience. Ce hitId ne fait pas encore partie du jeu de données. Vous allez donc l’ajouter maintenant à l’aide d’une Expression.

Pour enrichir les données, vous devez ajouter un objet Expression sur la zone de travail. L’objet Expression se trouve dans le menu de gauche du workflow Conception.

Faites glisser et déposez l’objet Expression sur la zone de travail.

Regardez ensuite la fenêtre Propriétés .

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

Cliquez sur l’icône + sur le côté droit pour ajouter un champ/expression.

Vous verrez alors cette fenêtre contextuelle :

Dans la fenêtre contextuelle, définissez le champ Nom et le Type :

• Nom: hitId
• Type : bigint

Cliquez sur OK pour enregistrer votre champ.

Vous verrez alors :

Cliquez sur Configurer…

Dans la fenêtre contextuelle Modifier l’expression, collez cette expression :
rand() * 1000000000000

Cliquez sur OK pour enregistrer votre expression.

Vous avez maintenant défini votre expression. Affichons vos données dans Adobe Experience Platform.

N’oubliez pas de cliquer sur Enregistrer pour enregistrer l’état actuel de votre mappage.

Exercice 5.3.5 - Données de sortie vers Target

La dernière étape consiste à ajouter l’objet Target au workflow. Dans le menu de gauche, faites glisser l’objet Target sur la zone de travail.

Connectez l’objet Expression à l’objet target .

Regardez les fenêtres Propriétés.

Dans le menu de gauche, accédez à Target. Dans la liste déroulante Connexion , sélectionnez le connecteur Adobe Experience Platform que vous avez créé précédemment.

Vous obtiendrez alors ce qui suit :

Cliquez sur le bouton Sélectionner pour sélectionner le jeu de données Adobe Experience Platform à utiliser.

Saisissez le terme de recherche ETL et cliquez sur Rechercher. Vous verrez alors ces jeux de données être renvoyés.

Sélectionnez le jeu de données Demo System - Event Dataset for ETL (Global v1.1).

Dans le menu de gauche de la fenêtre Propriétés, accédez à Mappage des champs.

Associez la sortie aux attributs de schéma comme indiqué ci-dessous :

Champ	Nom de l’élément
m_timestamp	timestamp
m_product	productListItemsArray.productListItems.name
m_product	productListItemsArray.productListItems.SKU
m_currency	commerce.order.currencyCode
e-mail	--aepTenantId--.identification.core.email
hitID	_id

Le mappage des champs doit ressembler à ceci (n’oubliez pas le mappage pour m_email).

Cliquez sur Enregistrer.

Vous avez maintenant terminé un workflow qui peut être Exécuter.

Cliquez sur le bouton Exécuter dans le coin supérieur droit de l’écran.

Après 30 secondes, vous verrez cette fenêtre contextuelle. (Remarque : cela peut prendre beaucoup de temps, veuillez juste attendre)

Vous devez remplacer Environnement d’exécution par l’Environnement d’exécution que vous avez créé lors de l’exercice précédent, comme dans la capture d’écran. (Si vous ne sélectionnez pas l’environnement d’exécution correct, votre tâche ne s’exécute pas correctement)

Cliquez sur Exécuter.

Au bout de 20 à 30 secondes, votre tâche s’exécute.

Vous pouvez consulter l’état de votre tâche en accédant à l’option de menu de gauche Mes tâches.

Recherchez votre tâche dans la liste et cliquez dessus pour l’ouvrir.

Vous verrez alors quelque chose comme ceci :

Cliquez sur le bouton Actualiser pour afficher les mises à jour.

Une fois votre tâche terminée, vos données seront ingérées dans Adobe Experience Platform.

Connectez-vous à Adobe Experience Platform.

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

Avant de continuer, vous devez sélectionner un environnement de test. 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é.

Accédez à Jeux de données et saisissez le terme de recherche ETL. Vous verrez alors ces jeux de données :

Ouvrez le jeu de données Demo System - Event Dataset for ETL (Global v1.1). Faites défiler l’écran vers le bas jusqu’à ce que les identifiants de lot s’affichent et recherchez votre lot spécifique.

Vous pouvez maintenant poursuivre l’exercice suivant.

Étape suivante : 5.5 Ingérer des données de deuxième et de troisième niveau dans Adobe Experience Platform

Revenir au module 5

Revenir à tous les modules