Utiliser des identifiants supplémentaires dans les parcours supplemental-id

Dans un tableau d’objets avec l’ID supplémentaire comme bookingNum et un attribut au même niveau appelé bookingCountry, le parcours effectue une itération sur l’objet de tableau en fonction de bookingNum et crée une instance de parcours sur chaque objet.

• L’expression suivante dans l’activité de condition effectue une itération sur le tableau d’objets et vérifie si la valeur de bookingCountry est égale à « FR » :

  code language-none
  @event{<event_name>.<object_path>.<object_array_name>.all(currentEventField.<attribute_path>.bookingNum==${supplementalId}).at(0).<attribute_path>.bookingCountry}=="FR"

• L’expression suivante dans l’éditeur de personnalisation d’e-mail effectue une itération dans le tableau d’objets, extrait la valeur bookingCountry applicable à l’instance de parcours active et l’affiche dans le contenu :

  code language-none
  {{#each context.journey.events.<event_ID>.<object_path>.<object_array_name> as |l|}} {%#if l.<attribute_path>.bookingNum = context.journey.technicalProperties.supplementalId%} {{l.<attribute_path>.bookingCountry}} {%/if%} {{/each}}

• Exemple d’événement de déclenchement du parcours :

  code language-none
  "bookingList": [ { "bookingInfo": { "bookingNum": "x1", "bookingCountry": "US" } }, { "bookingInfo": { "bookingNum": "x2", "bookingCountry": "FR" } } ]

Vous devez activer le expressActivation sur l’audience au moment de la création. Journey Optimizer doit alors activer chaque enregistrement indépendamment, sans déduplication par identifiant de profil. Cet indicateur ne peut pas être modifié une fois l’audience créée.

Utilisez l’appel API suivant lors de la création de l’audience :

Point d’entrée :

POST https://platform.adobe.io/data/core/ais/external-audience

En-têtes requis :

Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json
x-api-key: {API_KEY}
x-gw-ims-org-id: {IMS_ORG}
x-sandbox-name: {SANDBOX_NAME}

Corps de la requête (défini sur expressActivation: true) :

{
  "name": "my_audience_name",
  "fields": [ ... ],
  "sourceSpec": { ... },
  "audienceType": "people",
  "namespace": "CustomerAudienceUpload",
  "expressActivation": true
}

Pour en savoir plus, consultez la documentation sur la création d’une API d’audience externe.

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 utiliser des identifiants supplémentaires dans les parcours Adobe Journey Optimizer pour permettre à un seul profil d’avoir plusieurs instances de parcours simultanées, chacune limitée à un identifiant secondaire distinct tel qu’un identifiant de réservation, d’abonnement ou de politique.

Intentions:

• Comprendre quand et pourquoi utiliser un identifiant supplémentaire au lieu de se fier uniquement à un identifiant de profil
• Configurez un identifiant supplémentaire dans un parcours déclenché par un événement en marquant un attribut comme une identité dans le schéma d’événement
• Configurez un identifiant supplémentaire dans un parcours Lecture d’audience en activant l’option dans l’activité Lecture d’audience .
• Référencez des attributs d’identifiant supplémentaires pour la personnalisation des messages et la logique conditionnelle à l’aide de l’éditeur d’expression
• Appliquez la syntaxe d’expression correcte pour effectuer une itération sur les tableaux d’objets indexés par un ID supplémentaire
• Identifiez les mécanismes de sécurisation et les limitations avant d’implémenter des identifiants supplémentaires dans un parcours

Glossaire:

• Identifiant supplémentaire : un identifiant secondaire (par exemple, identifiant de commande, identifiant de réservation, identifiant d’abonnement) utilisé avec l’identifiant de profil pour étendre une instance de parcours à un enregistrement spécifique, ce qui permet d’activer plusieurs instances simultanées par de profil (spécifique au produit)
• Identifiant de profil : identifiant principal utilisé par défaut pour exécuter des parcours. Un profil actif dans un parcours ne peut pas rejoindre à nouveau un autre parcours sans identifiant supplémentaire.
• Espace de noms d’identifiant non-personne : espace de noms d’identité qui ne représente pas une personne (obligatoire pour les identifiants supplémentaires) et qui doit être distinct de l’espace de noms d’identité principal
• espace de noms joai : ne s’applique pas à cette page (voir dépannage des actions entrantes).
• DULE : étiquetage et application de l’utilisation des données : cadre de validation des politiques de gouvernance des données dans Adobe Experience Platform. Les identifiants supplémentaires ne sont pas soumis aux vérifications DULE.

Mécanismes de sécurisation :

• Les identifiants supplémentaires sont pris en charge uniquement pour les parcours déclenchés par un événement et Lecture d’audience ; non pris en charge pour les parcours de qualification d’audience
• Un profil ne peut pas avoir plus de 10 instances de parcours simultanées
• Chaque instance de parcours est comptabilisée dans le capping de la fréquence même lorsqu’elle est créée avec des identifiants supplémentaires
• L’identifiant supplémentaire doit être de type string ; les tableaux de chaînes et les mappages ne sont pas pris en charge
• L’attribut ID supplémentaire ne doit pas être marqué comme identité de Principal dans le schéma
• L’espace de noms utilisé pour l’ID supplémentaire doit être un espace de noms d’identifiant non-personne
• Après avoir appliqué l’espace de noms d’identité non-personne à un schéma, un nouvel événement ou groupe de champs doit être créé ; les entités existantes ne peuvent pas être actualisées
• Pour les parcours Lecture d’audience avec ID supplémentaires : le taux de lecture est limité à 500 profils par seconde et par instance de parcours ; seules les audiences du service de profil unifié sont prises en charge ; l’ID supplémentaire doit être un champ de profil (et non un champ d’événement/de contexte)
• Les événements en aval dans le même parcours doivent utiliser le même ID supplémentaire et le même espace de noms
• L’ID supplémentaire est désactivé pour les parcours Lecture d’audience qui utilisent un événement métier.

Terminologie:

• Nom canonique : Identifiant supplémentaire — Acronyme : none — variantes : Identifiant supplémentaire, identifiant secondaire
• Synonymes : « identifiant supplémentaire » = « ID supplémentaire » (utilisé de manière interchangeable dans l’interface utilisateur et la documentation)
• Ne pas confondre : « Identifiant supplémentaire » ≠ « Identité principale » — l’identifiant supplémentaire ne doit jamais être marqué comme l’identité principale dans le schéma

FAQ:

• Q : À quoi sert un identifiant supplémentaire ? : permet à un seul profil de saisir et d’exécuter un parcours plusieurs fois simultanément, chaque instance étant limitée à un enregistrement secondaire différent tel qu’un identifiant de réservation, d’abonnement ou de police.
• Q : Quels types de parcours prennent en charge les identifiants supplémentaires ? — parcours déclenchés par un événement et parcours Lecture d’audience. Les parcours de qualification d’audience ne prennent pas en charge les identifiants supplémentaires.
• Q : Combien d’instances de parcours simultanées un profil peut-il avoir avec des identifiants supplémentaires ? : un maximum de 10 instances de parcours simultanées par profil.
• Q : Puis-je utiliser les attributs d’ID supplémentaires pour la personnalisation des messages ? — Oui. Référencez-les via le menu Attributs contextuels dans l’éditeur d’expression ou l’éditeur de personnalisation.
• Q : L’ID supplémentaire doit-il être marqué comme une identité de Principal dans le schéma ? — Non. Elle doit être marquée comme identité mais ne doit pas être définie comme identité de Principal.
• Q : Les politiques de gouvernance DULE sont-elles appliquées à l’identifiant supplémentaire ? — Non. Les contrôles de validation DULE ne sont pas effectués sur l’ID supplémentaire.