Configuration d'un événement unitaire configure-an-event

Les événements unitaires sont liés à un profil spécifique. Ils peuvent être basés sur des règles ou générés par le système. En savoir plus sur les événements unitaires dans cette section.

Les premières étapes nécessaires pour configurer un nouvel événement sont les suivantes :

  1. Dans la section du menu ADMINISTRATION, accédez à Configurations. Dans la section Événements, cliquez sur Gérer. La liste des événements s'affiche.

  2. Cliquez sur Créer un événement pour créer un événement. Le volet de configuration d'événement s'ouvre dans la partie droite de l'écran.

  3. Saisissez le nom de votre événement. Vous pouvez également ajouter une description.

    note note
    NOTE
    Seuls les caractères alphanumériques et les traits de soulignement sont autorisés. La longueur maximale est de 30 caractères.
  4. Dans le champ Type, choisissez Unitaire.

  5. Dans le champ Type d'identifiant d'événement, sélectionnez le type d'identifiant d'événement à utiliser : Basé sur une règle ou Généré par le système. Pour en savoir plus sur les types d'identifiant d'événements, reportez-vous à cette section.

  6. Le nombre de parcours qui font appel à cet événement apparaît dans le champ Utilisé(e) dans. Vous pouvez cliquer sur l'icône Afficher les parcours pour faire apparaître la liste des parcours utilisant cet événement.

  7. Définissez les champs de payload et de schéma : c'est dans ces champs que vous sélectionnez les informations d'événement (désignées généralement sous le nom de payload) que le parcours s'attend à recevoir. Vous pourrez alors utiliser ces informations dans votre parcours. Consultez cette section.

    note note
    NOTE
    Lorsque vous sélectionnez le type Généré par le système, seuls les schémas dont le champ est de type eventID sont disponibles. Lorsque vous sélectionnez le type Basé sur des règles, tous les schémas Événement d'expérience sont disponibles.
  8. Pour les événements basés sur des règles, cliquez dans le champ condition d'identifiant d'événement. À l’aide de l’éditeur d’expression simple ou avancé, définissez la condition qui sera utilisée par le système pour identifier les événements qui déclencheront votre parcours.

    Dans notre exemple, nous avons écrit une condition basée sur la ville du profil. Cela signifie que chaque fois que le système reçoit un événement qui correspond à cette condition (champ Ville et valeur Paris), il le transmet aux parcours.

    note note
    NOTE
    Dans l'éditeur d'expression simple, tous les opérateurs ne sont pas disponibles ; ils dépendent du type de données. Par exemple, pour un type de chaîne de champ, vous pouvez utiliser « contient » ou « égal à ».
    Si vous modifiez votre schéma avec de nouvelles valeurs d’énumération après avoir créé l’événement, vous devez suivre les étapes suivantes pour appliquer les modifications à l’événement existant : désélectionnez le champ d’énumération des champs de l’événement, confirmez la sélection, puis sélectionnez à nouveau le champ d’énumération. La nouvelle valeur d’énumération s’affiche maintenant.
  9. Ajoutez un espace de noms. Cette étape est facultative, mais recommandée. En effet, l'ajout d'un espace de noms permet d'exploiter les informations stockées dans le service de profil client en temps réel. Il définit le type de clé dont dispose l'événement. Consultez cette section.

  10. Définissez l'identifiant du profil : effectuez votre choix parmi vos champs de payload ou définissez une formule pour identifier la personne associée à l'événement. Cette clé est configurée automatiquement (mais peut toujours être modifiée) si vous sélectionnez un espace de noms. En effet, le parcours sélectionne la clé qui doit correspondre à l'espace de noms ; par exemple, si vous sélectionnez un espace de noms d'email, la clé d'email est sélectionnée. Consultez cette section.

  11. Cliquez sur Enregistrer.

    L'événement est maintenant configuré et prêt à être déposé dans un parcours. Des étapes de configuration supplémentaires sont requises pour la réception d'événements. Voir cette page.

Définition des champs de payload define-the-payload-fields

La définition de la payload vous permet de choisir les informations que le système s'attend à recevoir de l'événement dans votre parcours, ainsi que la clé permettant d'identifier la personne associée à l'événement. La payload est basée sur la définition de champ XDM d'Experience Cloud. Pour plus d’informations sur XDM, consultez la documentation Adobe Experience Platform.

  1. Sélectionnez un schéma XDM dans la liste et cliquez ensuite sur le champ Champs ou sur l'icône Modifier.

    Tous les champs définis dans le schéma sont affichés. La liste des champs varie d'un schéma à l'autre. Vous pouvez rechercher un champ spécifique, ou utiliser les filtres pour afficher l'ensemble des nœuds et des champs ou uniquement les champs sélectionnés. En fonction de la définition du schéma, certains champs peuvent être obligatoires et présélectionnés. Vous ne pouvez pas les désélectionner. Tous les champs obligatoires pour que les parcours reçoivent correctement l'événement sont sélectionnés par défaut.

    note note
    NOTE
    Pour les événements générés par le système, veillez à ajouter le groupe de champs "orchestration" au schéma XDM. Vous aurez ainsi la garantie que votre schéma contient toutes les informations requises pour fonctionner avec Journey Optimizer.

  2. Sélectionnez les champs que vous prévoyez de recevoir de l'événement. Il s'agit des champs que l'utilisateur chargé de la conception de parcours exploitera dans le parcours. Ils doivent également inclure la clé qui sera utilisée pour identifier la personne associée à l'événement (voir cette section).

    note note
    NOTE
    Pour les événements générés par le système, le champ eventID est automatiquement ajouté à la liste des champs sélectionnés afin que Journey Optimizer puisse identifier l'événement. Le système à l'origine de l'envoi de l'événement ne doit pas générer d'identifiant, mais plutôt utiliser celui indiqué dans l'aperçu de la payload. Consultez cette section.
  3. Une fois la sélection des champs nécessaires terminée, cliquez sur OK ou appuyez sur la touche Entrée.

    Le nombre de champs sélectionnés s'affiche dans le champ Champs.

Sélectionnez l'espace de noms select-the-namespace

Un espace de noms vous permet de définir le type de clé utilisé pour identifier la personne associée à l'événement. Sa configuration est facultative. Elle est obligatoire si vous souhaitez récupérer, dans vos parcours, des informations supplémentaires provenant du profil client en temps réel. Il n'est pas nécessaire de définir l'espace de noms si vous utilisez uniquement des données provenant d'un système tiers via une source de données personnalisée.

Vous pouvez utiliser l'un des espaces de noms prédéfinis ou en créer un à l'aide du service Espace de noms d'identité. Consultez la documentation d’Adobe Experience Platform.

Si vous sélectionnez un schéma doté d'une identité principale, les champs Identifiant du profil et Espace de noms sont déjà renseignés. Si aucune identité n'est définie, identityMap > id est sélectionné comme clé principale. Vous devez ensuite sélectionner un espace de noms et la clé sera préremplie (sous le champ Espace de noms) à l'aide de identityMap > id.

Lors de la sélection de champs, les champs d'identité principale sont balisés.

Sélectionnez un espace de noms dans la liste déroulante.

Un seul espace de noms est autorisé par parcours. Si vous utilisez plusieurs événements dans le même parcours, ils doivent utiliser le même espace de noms. Voir cette page.

NOTE
Vous pouvez uniquement sélectionner un espace de noms d’identité basé sur les personnes. Si vous avez défini un espace de noms pour une table de correspondance (par exemple : espace de noms ProductID pour une recherche de produit), il ne sera pas disponible dans la liste déroulante Espace de noms.

Définir l’identifiant du profil define-the-event-key

La clé correspond au champ ou à la combinaison de champs faisant partie des données de payload de l'événement et permettant au système d'identifier la personne associée à l'événement. Il peut s'agir de l'ID Experience Cloud, d'un ID CRM ou encore d'une adresse e-mail.

Pour utiliser les données stockées dans la base de données de profil client en temps réel d’Adobe, la clé d’événement doit correspondre aux informations que vous avez définies en tant qu’identité d’un profil dans Service de profil client en temps réel.

Le système peut ainsi effectuer la réconciliation entre l’événement et le profil de l’iindividu. Si vous sélectionnez un schéma doté d'une identité principale, les champs Identifiant du profil et Espace de noms sont déjà renseignés. Si aucune identité n'est définie, identityMap > id est la clé principale. Vous devez ensuite sélectionner un espace de noms et la clé est automatiquement préremplie à l’aide de la fonction identityMap > id.

Lors de la sélection de champs, les champs d'identité principale sont balisés.

Si vous devez utiliser une autre clé, telle qu'un ID CRM ou une adresse e-mail, vous devez l'ajouter manuellement, comme expliqué ci-dessous :

  1. Cliquez dans le champ Identifiant du profil ou sur l'icône représentant un crayon.

  2. Sélectionnez le champ choisi comme clé dans la liste des champs de payload.

Lorsque l'événement est reçu, la valeur de la clé permet au système d'identifier la personne qui y est associée. Associée à un espace de noms (voir cette section), la clé peut être utilisée pour exécuter des requêtes sur Adobe Experience Platform. Voir cette page.
La clé sert également à vérifier qu'une personne se trouve dans un parcours. En effet, une personne ne peut se trouver à deux endroits différents dans le même parcours. Par conséquent, le système n'autorise pas qu'une même clé (CRMID=3224, par exemple) se trouve à des endroits différents dans un même parcours.

Éditeur d’expression avancé adv-exp-editor

Lors de la définition de la condition d’identifiant d’événement ou de l’identifiant du profil, vous pouvez basculer vers l’éditeur d’expression avancé pour créer des clés plus complexes (une concaténation de deux champs d’événements, par exemple).

Vous avez accès aux fonctions d’expression avancées du bouton Mode avancé si vous souhaitez effectuer des manipulations supplémentaires. Ces fonctions vous permettent de manipuler les valeurs utilisées pour exécuter des requêtes spécifiques, comme modifier des formats, exécuter des concaténations de champs, prendre uniquement en compte une partie d'un champ (les 10 premiers caractères, par exemple), etc. Consultez cette page.

Prévisualisation de la payload preview-the-payload

Cet aperçu vous permet de valider la définition de la payload.

NOTE
Pour les événements générés par le système, lorsque vous créez un événement, enregistrez-le et rouvrez-le avant d'afficher la prévisualisation de la payload. Cette étape est nécessaire pour générer un identifiant d'événement dans la payload.
  1. Cliquez sur l'icône Afficher la payload pour prévisualiser la payload attendue par le système.

    Vous remarquerez que les champs sélectionnés sont affichés.

  2. Vérifiez l'aperçu pour valider la définition de la payload.

  3. Vous pouvez ensuite partager l'aperçu de la payload avec la personne responsable de l'envoi de l'événement. Cette payload peut l’aider à concevoir la configuration d’un envoi d’événement vers Journey Optimizer. Consultez cette page.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76