Utiliser des données Adobe Experience Platform à des fins de personnalisation aep-data

Ouvrez l’éditeur de personnalisation, disponible dans tout contexte où vous pouvez définir une personnalisation, tel que les messages. Découvrir comment utiliser l’éditeur de personnalisation

Accédez à la liste des fonctions d’assistance et ajoutez la fonction d’assistance datasetLookup au volet de code.

Cette fonction fournit une syntaxe prédéfinie pour vous permettre d’appeler des champs à partir de vos jeux de données Adobe Experience Platform. La syntaxe se présente comme suit :

{{datasetLookup datasetId="datasetId" id="key" result="store" required=false}}

• datasetId est l’identifiant du jeu de données que vous utilisez.

• id est l’identifiant de la colonne source qui doit être associée à l’identité principale du jeu de données de recherche.

  note
  NOTE
  La valeur saisie pour ce champ peut être un identifiant de champ (profile.packages.packageSKU), un champ transmis dans un événement de parcours (context.journey.events.event_ID.productSKU) ou une valeur statique (sku007653). Dans tous les cas, le système utilisera la valeur et la recherche du jeu de données pour vérifier si celui-ci correspond à une clé.
  Si vous utilisez une valeur de chaîne littérale pour la clé, conservez le texte entre guillemets. Par exemple : {{datasetLookup datasetId="datasetId" id="SKU1234" result="store" required=false}}. Si vous utilisez une valeur d’attribut comme clé dynamique, supprimez les guillemets. Par exemple : {{datasetLookup datasetId="datasetId" id=category.product.SKU result="SKU" required=false}}

• result est un nom arbitraire que vous devez fournir pour référencer toutes les valeurs de champ que vous allez récupérer du jeu de données. Cette valeur sera utilisée dans votre code pour appeler chaque champ.

• required=false : si la valeur required est définie sur TRUE, le message n’est diffusé que si une clé correspondante est trouvée. Si la valeur required est définie sur FALSE, une clé correspondante n’est pas requise et le message peut toujours être diffusé. Notez que si la valeur required est définie sur FALSE, il est recommandé de tenir compte des valeurs de secours ou des valeurs par défaut dans le contenu de votre message.

Adaptez la syntaxe à vos besoins. Dans cet exemple, nous allons récupérer les données relatives aux vols des passagères et passagers. La syntaxe se présente comme suit :

{{datasetLookup datasetId="1234567890abcdtId" id=profile.upcomingFlightId result="flight"}}

• Nous travaillons dans le jeu de données dont l’identifiant est « 1234567890abcdtId »,
• Le champ que nous voulons utiliser pour la liaison avec le jeu de données de recherche est profile.upcomingFlightId,
• Nous souhaitons inclure toutes les valeurs de champ sous la référence « vol ».

Une fois que la syntaxe à appeler dans le jeu de données Adobe Experience Platform a été configurée, vous pouvez spécifier les champs à récupérer. La syntaxe se présente comme suit :

{{result.fieldId}}

• result est la valeur que vous avez attribuée au paramètre result dans la fonction d’assistance datasetLookup. Dans cet exemple, « vol ».

• fieldID est l’identifiant du champ à récupérer. Cet identifiant est visible dans l’interface d’utilisation d’Adobe Experience Platform lors de la navigation dans le schéma d’enregistrement associé à votre jeu de données :

  accordion
  Où récupérer l’ID d’un champ ?
  Les ID de champ peuvent être récupérés lors de la prévisualisation d’un jeu de données dans l’interface d’utilisation d’Adobe Experience Platform. Découvrez comment prévisualiser des jeux de données dans la documentation d’Adobe Experience Platform.

Dans cet exemple, nous allons utiliser des informations relatives à l’heure et à la porte d’embarquement des passagères et passagers. Nous ajoutons donc ces deux lignes :

• {{flight._myorg.booking.boardingTime}}
• {{flight._myorg.booking.gate}}

Maintenant que votre code est prêt, vous pouvez terminer votre contenu comme vous le faites habituellement et le tester à l’aide de l’une des méthodes de simulation suivantes : cliquez sur Simuler du contenu pour tester les variations de contenu avec des exemples de données d’entrée ou la génération automatique par IA, ou cliquez sur Simuler du contenu, puis sélectionnez Simuler du contenu (profils AEP) dans la liste déroulante pour obtenir un aperçu avec des profils de test. Découvrir comment prévisualiser et tester votre contenu