Utiliser les données Adobe Experience Platform dans les parcours datalookup

Filtrage basé sur les catégories de produits

Scénario:Send : offrir un coupon aux utilisateurs et utilisatrices qui dépensent plus de 40 $ en produits ménagers.

Flux du parcours :

1. Événement d’achat : capturez les SKU à partir du panier de l’utilisateur ou de l’utilisatrice.

2. Activité de recherche de jeu de données :

   • Jeu de données : products-dataset (SKU comme clé primaire).
   • Clés de recherche : list(@event{purchase_event.products.sku}).
   • Champs à renvoyer : ["SKU", "category", "price"].

3. Activité de condition :

   • Filtrez les SKU dont la catégorie est « ménage ».

     code language-none
     @event{purchase_event.products.all( in(currentEventField.sku, @datasetlookup{MyDatasetLookupActivity1.entities.all(currentDatasetLookupField.category == 'household').sku} ) )}

   OU

   • Additionnez les dépenses totales pour les produits ménagers et comparez-les au seuil de 40 $.

     code language-none
     sum(@event{purchase_event.products.all( in(currentEventField.sku, @datasetlookup{MyDatasetLookUpActivity1.entities.all(currentDatasetLookupField.category == 'household').sku} ) )}.price}, ',', true ) > 40

4. Éditeur de personnalisation :

   Utilisez les données enrichies pour personnaliser le contenu de l’e-mail :

   code language-none
   {% let householdTotal = 0 %} {{#each journey.datasetlookup.3709000.entities as |product|}} {%#if get(product, "category") = "household"%} {% let householdTotal = householdTotal + product.price %}{%/if%} {{/each}} "Hi, thanks for spending " + {%= householdTotal %} + " on household products. Here is your reward!"

Personnalisation utilisant des données de fidélité externes

Scénario : identifier le compte de messagerie pour un profil dont le statut de fidélité est Platine. Dans ce scénario, le compte de fidélité est associé à un ID d’e-mail et les données de fidélité ne sont pas disponibles dans la boutique de recherche de profil standard.

Flux du parcours :

1. Déclencheur d’événement de profil : capturez les identifiants d’e-mail du contexte de profil ou d’événement.

2. Activité de recherche de jeu de données :

   • Jeu de données : loyalty-member-dataset (e-mail comme clé primaire).
   • Clés de recherche : @profile.email.
   • Champs à renvoyer : ["email", "loyaltyTier"].

3. Activité de condition :

   Divisez le parcours en fonction du niveau de fidélité :

   code language-none
   @datasetLookup{MyDatasetLookUpActivity1.entity.loyaltyMember.loyaltyTier} == 'Platinum'

4. Éditeur de personnalisation :

   Utilisez les données enrichies du niveau de fidélité pour personnaliser la communication sortante :

   code language-none
   {{context.journey.datasetLookup.1482319411.entity.loyaltyMember.loyaltyTier}}

Référence des connaissances sur l’IA

Cette section contient des connaissances structurées destinées à soutenir l’interprétation, la récupération et la réponse aux questions liées à ce sujet.

Pour une compréhension totale, ces informations doivent être combinées avec la documentation de cette page. Aucune des sources n’est conçue pour être autonome. La page décrit la fonctionnalité, tandis que cette section fournit un contexte supplémentaire qui permet de clarifier la terminologie, l’intention, l’applicabilité et les contraintes.

• TL;DR: Cette page explique comment configurer l’activité de recherche de jeu de données pour récupérer dynamiquement les données du jeu de données d’enregistrement AEP au moment de l’exécution du parcours pour la personnalisation en temps réel et la logique conditionnelle.

Intentions:

• Ajoutez une activité de recherche de jeu de données à un parcours pour récupérer des données d’enregistrement AEP externes au moment de l’exécution
• Sélectionnez des champs de jeu de données spécifiques (nœuds feuilles/valeurs primitives) à récupérer lors de la recherche.
• Définir une clé de recherche en mode avancé pour joindre le contexte du parcours aux enregistrements du jeu de données
• Utiliser des données de jeu de données enrichies dans l’éditeur d’expression de parcours ou l’éditeur de personnalisation
• Résolution des erreurs « Recherche de jeu de données introuvable » provoquées par l’utilisation du mode simple pour la clé de recherche

Glossaire:

• Activité de recherche de jeu de données : activité d’orchestration de parcours qui récupère des données des jeux de données d’enregistrement AEP au moment de l’exécution à l’aide d’une clé de jointure (spécifique au produit)
• Nœud feuille : champ au niveau le plus bas d’une hiérarchie de schéma qui contient une valeur primitive (chaîne, nombre, valeur booléenne, date) (spécifique au produit)
• Clé de recherche : expression de jointure (chaîne ou liste de chaînes) utilisée pour faire correspondre les données contextuelles du parcours aux enregistrements du jeu de données sélectionné (spécifique au produit)
• Données enrichies : données récupérées par une activité de recherche de jeu de données et stockées temporairement dans le parcours pour une utilisation dans des activités en aval (spécifiques au produit)

Mécanismes de sécurisation :

• Maximum de 10 activités de recherche de jeu de données par parcours.
• 20 champs sélectionnés maximum par activité de recherche.
• Maximum de 50 clés dans le tableau des clés de recherche.
• La taille des données enrichies est limitée à 10 Ko.
• Le jeu de données doit être activé pour la recherche dans Adobe Experience Platform avant d’apparaître dans la configuration de l’activité.
• Seuls les nœuds feuilles (valeurs primitives) peuvent être sélectionnés ; les tableaux et les mappages ne peuvent pas être sélectionnés.
• Seules les chaînes ou les listes de chaînes sont prises en charge comme clés de recherche.
• La clé de recherche doit être définie en mode avancé ; l’utilisation du mode simple entraîne l’indisponibilité de la sortie de l’activité en tant qu’attribut de contexte en aval.
• Les données enrichies sont transitoires et disponibles uniquement pendant l’exécution du parcours et dans la personnalisation de l’activité sortante.
• Pour de meilleures performances, limitez à 5 les activités de recherche par parcours (recommandé) ; la limite stricte appliquée par le système est de 10 activités par parcours. Il est également recommandé de disposer de 20 attributs maximum par recherche.

Terminologie:

• Nom canonique : activité de recherche de jeu de données — Acronyme : s.o. — variantes : recherche de données AEP, activité d’enrichissement des données
• Synonymes : « clé de recherche » = « clé de jointure »
• Ne les confondez pas : « Activité de recherche de jeu de données » ≠ « Recherche d’événement d’expérience » - La recherche de jeu de données récupère les données du jeu de données d’enregistrement, et non les événements d’expérience de série temporelle

FAQ:

• Q : Pourquoi mon jeu de données n’apparaît-il pas dans le menu déroulant Champ de jeu de données ? — Le jeu de données doit être activé pour la recherche dans Adobe Experience Platform. Suivez les instructions de la section À lire absolument pour l’activer.
• Q : Pourquoi renvoie-@datasetLookup{} une erreur « Recherche de jeu de données introuvable » dans une condition ? — La clé de recherche a été définie en mode simple au lieu du mode avancé. Redéfinissez-la en mode avancé et republiez le parcours.
• Q : Puis-je récupérer des tableaux ou mapper des champs à partir du jeu de données ? — Non, seuls les champs de nœud feuille primitifs (chaîne, nombre, valeur booléenne, date) peuvent être sélectionnés.
• Q : Comment puis-je accéder aux données enrichies dans un e-mail ? : utilisez l’éditeur de personnalisation avec le {{context.journey.datasetLookup.<activityId>.entities}} de syntaxe.
• Q : Les données enrichies sont-elles conservées après la fin du parcours ? — Non, les données enrichies sont transitoires et disponibles uniquement pendant la session d’exécution du parcours.