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

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.

ETL

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

ETL

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

ETL

Vous verrez alors cette fenêtre contextuelle.

ETL

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

ETL

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

ETL

Vous verrez alors cet écran :

ETL

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.

ETL

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

ETL

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

ETL

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

ETL

Cliquez sur Supprimer dans la fenêtre contextuelle.

ETL

Votre workflow ressemble maintenant à ceci.

ETL

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.

ETL

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

ETL

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

ETL

Vous verrez alors ceci.

ETL

Cliquez sur Sélectionner….

ETL

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.

ETL

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.

ETL

Vous verrez alors ceci.

ETL

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

ETL

Cliquez sur Options de formatage.

ETL

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

ETL

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

ETL

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.

ETL

Vous devez maintenant disposer de la conception suivante :

ETL

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.

ETL

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

ETL

Vous verrez alors ceci.

ETL

Cliquez sur Sélectionner….

ETL

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.

ETL

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.

ETL

Vous verrez alors ceci.

ETL

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

ETL

Vous aurez alors ceci.

ETL

Cliquez sur Options de formatage.

ETL

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

ETL

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

ETL

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 :

ETL

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.

ETL

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

ETL

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.

ETL

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

ETL

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

ETL

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.

ETL

Tu vas voir cette fenêtre maintenant.

ETL

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.

ETL

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.

ETL

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

Vous verrez alors ceci.

ETL

Cliquez sur la petite icône +.

Une condition de jointure s’affiche alors.

ETL

Connectez ces deux champs entre eux :

m_account_id (string) = account_id (string)

ETL

Une fois que vous avez terminé, cliquez sur Enregistrer

ETL

Vos deux sources sont maintenant unies.

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

ETL

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.

ETL

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

ETL

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

ETL

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

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

ETL

Remplacez la condition de filtrage par Avancé.

ETL

Cliquez sur le bouton Modifier la condition de filtrage .

ETL

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

ETL

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.

ETL

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.

ETL

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

ETL

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.

ETL

Vous verrez alors cette fenêtre contextuelle :

ETL

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

  • Nom: hitId
  • Type : bigint

ETL

Cliquez sur OK pour enregistrer votre champ.

Vous verrez alors :

ETL

Cliquez sur Configurer…

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

ETL

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.

ETL

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.

ETL

Connectez l’objet Expression à l’objet target .

ETL

Regardez les fenêtres Propriétés.

ETL

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.

ETL

Vous obtiendrez alors ce qui suit :

ETL

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

ETL

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

ETL

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

ETL

Cliquez sur Enregistrer.

ETL

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

ETL

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

ETL

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

ETL

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)

ETL

Cliquez sur Exécuter.

ETL

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.

ETL

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

ETL

Vous verrez alors quelque chose comme ceci :

ETL

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

ETL

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

ETL

Connectez-vous à Adobe Experience 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 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.

Ingestion des données

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

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

ETL

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.

ETL

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

Sur cette page