Liste - Événements personnalisés

Les événements et les données d'événements sont des informations importantes sur lesquelles les marketers peuvent agir. Pensez à un panier abandonné, un achat, un bon utilisé, une visite dans un magasin… Tous ces événements peuvent représenter autant de raisons pour le marketer d'interagir avec le contact de l'audience. Pour ce faire, des événements personnalisés peuvent être créés. Un contact de l'audience ayant une fiche dans les événements personnalisés consignés peut déclencher l'exécution d'un journey.

Les événements personnalisés sont des événements stockés dans une liste dédiée et liés 1:n à une liste d'audiences. Vous pouvez générer des journeys pour les contacts de votre audience en fonction d'événements qui leur sont spécifiques dans la liste des événements personnalisés. Tout type de message peut être envoyé à la suite d'un événement, y compris les canaux personnalisés (impression, 'X' (anciennement Twitter), etc.). Ces messages peuvent être personnalisés avec les détails des événements personnalisés.

La liste des événements personnalisés peut être remplie via une tâche planifiée, ou encore manuellement via l'interface Selligent. Indirectement, les données peuvent également être ajoutées via l'API. Vous trouverez de plus amples informations ici. De plus, des fiches d'événements personnalisés peuvent également être créées à partir d'un Custom journey via le Composant Données d'événement.

Les journeys pilotés par les événements sont déclenchés pour chaque nouvel événement entrant dans la liste des événements personnalisés.

Cas d'utilisation typiques :

  • Panier abandonné — Le premier message est envoyé quelques heures après que le contact a abandonné le panier. Un rappel est envoyé 2 jours plus tard si le processus n'est pas terminé.
  • Message d'anniversaire avec codes coupons personnalisés.
  • Expiration de carte — Un message d'expiration de carte spécifique est envoyé avec les détails de la carte aux détenteurs de Mastercard. L'audience est sélectionnée en fonction des données d'une liste d'événements chargée à partir d'un système externe.
  • ...

 

Dans ce sujet :

 

Type d'événements personnalisés

Vous pouvez créer deux types d'événements personnalisés :

  • Planifiés — Les événements personnalisés planifiés peuvent être planifiés pour être exécutés à un moment précis et ne peuvent être traités que par un seul journey.
  • Instantanés — Les événements personnalisés sont traités en continu chaque fois qu'un nouvel événement est ajouté. Les événements personnalisés instantanés peuvent être utilisés dans plusieurs Custom journeys et être traités par tous les journeys qui y ont souscrit.

 

Créer une liste d'événements personnalisés

Pour créer une liste d'événements personnalisés, activez l'onglet Événements personnalisés pour la liste d'audiences à laquelle elle doit être liée.

Un aperçu de toutes les listes d'événements personnalisés existantes s'affiche. Vous pouvez alors :

  • ajouter de nouveaux événements personnalisés
  • supprimer ou modifier des événements personnalisés existants. Lorsque vous supprimez un événement personnalisé, un avertissement s'affiche quand l'événement personnalisé est utilisé, ainsi que le nombre de fois où il est utilisé.

 

Pour créer une nouvelle liste d'événements personnalisés, cliquez sur Nouveaux événements personnalisés dans le coin supérieur droit.

Un assistant s'ouvre et permet de choisir entre Instantané et Planifié.

Complétez les propriétés. La fenêtre Propriétés contient le type d'événements personnalisés à créer :

  • Nom et description — Donnez un nom explicite et une description.
  • Libellé — Le(s) libellé(s) attribué(s) à cet actif. Sélectionnez un ou plusieurs libellés dans la liste déroulante. (Ces libellés sont créés dans le module Configuration Admin.) Les utilisateurs disposant des autorisations d'accès appropriées peuvent également créer de nouveaux libellés en saisissant leur nouvelle valeur dans le champ Libellé.
  • Liste — Le nom de la liste d'audiences pour laquelle les événements personnalisés sont créés.

 

Une fois terminé, cliquez sur Créer des événements personnalisés. La liste des événements personnalisés est ajoutée au tableau de bord et s'ouvre immédiatement sur la définition des champs.

Selon le type sélectionné d'événements personnalisés, divers champs systémes sont générés dans la liste :

Instantané :

Vous pouvez utiliser les événements personnalisés instantanés dans plusieurs journeys et les traiter à différents moments. Le champ EXEC_CNT contient le nombre de fois où la fiche des événements personnalisés a été traitée dans un journey.

Planifié:

Les événements personnalisés planifiés ne peuvent être traités que par un Custom journey. Le champ JOURNEYID contient l'ID du journey qui doit en premier choisir l'événement personnalisé et qui traite les événements personnalisés.

Note technique : Un événement personnalisé programmé est considéré comme traité lorsqu'il est utilisé sur un chemin ininterrompu dans un composant sortant programmé tel qu'un e-mail, une notification mobile, un SMS, un canal personnalisé, un composant Google ou Facebook, ou encore des groupes de contrôle.

 

Ajouter de champs à des événements personnalisés

Lors de la création d'une liste d'événements personnalisés, des champs système sont créés par défaut tels que ID, USER_ID et State et EXTERNAL_ID.

  • L'USER_ID permet de lier les événements personnalisés à l'utilisateur dans l'audience liée.

  • Le champ EXTERNAL_ID permet de définir un identifiant externe unique qui donne aux utilisateurs Selligent la possibilité, après l'exécution, d’associer les données d'exécution à leurs propres fiches. Ce champ est facultatif. S’il n’est pas complété, Selligent lui attribuera un identifiant unique.

    Remarque importante : L'ID externe doit respecter le format GUID (UUID v4). Les autres types sont rejetés.

  • Le champ SG_EXTERNAL_ID est destiné à un UUID hexadécimal de 32 caractères sous la forme 8-4-4-4-12 (pour un total de 36 caractères).
    L'objectif de ce champ est de fournir une référence codifiée pour le système tiers appelant.
    Exemple : un code de transaction unique, un code de pièce de fournisseur, un code d'événement ou quoi que ce soit de significatif pour le système qui a déclenché l'événement ou l'appel d'API pour la traçabilité. Les plates-formes Selligent stockent simplement cette valeur au format UUID (pas de vérification de l'unicité).

    Exemples:
    12345678-aaaa-bbbb-9999-a1b2c3d4e5f6
    abcd1234-5555-6666-7777-aabbccddeeff
    23508685-0743-3124-7734-000012d16175

    Voir aussi : https://fr.wikipedia.org/wiki/Universally_unique_identifier

Vous pouvez ajouter des champs supplémentaires de la même manière que pour toute autre liste. (Consultez la rubrique Créer une liste pour plus d'informations). Ces champs contiennent les détails des événements personnalisés et peuvent être utilisés pour la personnalisation des messages envoyés au contact.

Remarque : Vous pouvez appliquer le type JSON aux champs de la liste d'événements personnalisés. Cinq champs au maximum peuvent être de ce type.
Pour chaque champ, vous devez définir la structure JSON (nom, utilisation et paramètres obligatoires).

Pour obtenir les données d'un champ JSON, utilisez la syntaxe suivante :
[% jsonValue(field, JSON key) %]
où :
* field = une expression renvoyant le champ JSON, par exemple : eventValue('FAVORITESHOPS')
* JSON key = le chemin pour accéder à la clé spécifique dans le JSON (tableau). Utilisez « . » comme séparateur et « [x] » comme opérateur d'indexation (basé sur zéro).
Exemple:
A Custom Events field called FAVORITESHOPS contains the JSON structure as displayed above.
- Pour obtenir la « ville » du premier élément du tableau ADDRESS, utilisez : [% jsonValue(eventValue('FAVORITESHOPS'), 'ADDRESS[0].CITY') %]
- Pour obtenir la « ville » du deuxième élément du tableau ADDRESS, utilisez : [% jsonValue(eventValue('FAVORITESHOPS'), 'ADDRESS[1].CITY') %]

Remarque : Un maximum de 25 champs tableau est autorisé. Chaque champ du tableau peut contenir un maximum de 25 caractères.

Remarque: Pour définir plus rapidement les champs des listes d'événements personnalisés, vous pouvez les copier et les coller dans une autre liste d'événements personnalisés.

 

Définir les propriétés des événements personnalisés

Une fois les événements personnalisés créés, vous pouvez toujours en modifier les propriétés. Accédez à l'entrée Propriétés dans la navigation de gauche :

  • Nom et description — Donnez un nom explicite et une description.
  • Libellé — Libellé attribuée à cette liste d'événements personnalisée.
  • Liste — Le nom de la liste d'audiences pour laquelle les événements personnalisés sont créés.
  • Champ de transaction: dans votre liste d'événements personnalisés, sélectionnez le champ qui contient la clé unique de la transaction. Cela permet de lier différents événements à une seule transaction.
  • Paramètres avancés - Nom de la table — Le nom utilisé pour la table physique créée dans la base de données.

 

Données des événements personnalisés

Remarque importante : Si l'onglet Données ne s’affiche pas lorsque vous accédez à un segment, il est probable que l'option 'Masquer les données personnelles' est activée. Vérifiez auprès de votre administrateur si cela ne vous semble pas correct.

Dans l'onglet Données, vous pouvez afficher les données dans la liste des événements personnalisés. Les fiches peuvent être saisies manuellement ou automatiquement via une importation, ou via le composant Données d'événement dans un Custom journey.

Exemple de données d'un tableau JSON dans une fiche d'événement personnalisé :
Les données d'un tableau JSON peuvent être saisies dans une zone de texte (qui peut être développée) :

Les données correspondent à cette structure de données JSON qui a été définie auparavant :

Pour plus d'informations sur l'ajout de données à votre liste, consultez cette rubrique.

Remarque technique : Il n'y a actuellement aucune méthode d'API permettant de créer un événement personnalisé. C'est pourquoi vous devez utiliser un appel d'API pour déclencher un Custom Journey qui contient un composant Données d'événement écrivant les données d'API comme nouvel événement dans la liste d'événements personnalisés.

Exemple:

Ce composant d'entrée contient les paramètres correspondant aux champs dans la liste des événements personnalisés.
Le composant Données d'événement crée l'événement dans la liste des événements personnalisés. La page de renvoi est obligatoire en tant que fin du journey.
Ce journey doit être publié, mais il n'a pas besoin d'être activé. Notez que le journey peut être mis en pause. Quand le journey est de nouveau activé, aucun événement personnalisé n'est ignoré. Chacun est traité avec un certain retard.
La méthode d'API qui déclenche le journey ci-dessus nécessite une méthode POST de l'objet PERSONNALISÉ.

Voici un exemple JSON utilisé pour transmettre les valeurs :
{
"user_id" : 13,
"parameter_values": {
"EVENTDAY": "Saturday",
"ENROLLED": "YES"
}
}

 

Utilisation

Les événements personnalisés utilisés dans un journey ne peuvent pas être supprimés et, par conséquent, la liste d'audiences correspondante ne peut pas non plus l'être. L'onglet Utilisation fournit des détails sur l'endroit où les événements personnalisés sont utilisés et s'ils le sont actuellement.

À partir de cet aperçu, vous pouvez cliquer sur le journey, le contenu ou la tâche dans lesquels les événements personnalisés sont utilisés.

 

Utiliser les événements personnalisés dans les journeys pilotés par les événements

Les événements personnalisés ont été conçus pour pouvoir utiliser les informations sur les événements liés aux contacts pour déclencher un journey. Les événements personnalisés instantanés sont traités en continu, alors que les événements personnalisés planifiés sont traités à un moment donné durant la période d'activation des événements personnalisés.

Voyons à présent comment nous pouvons utiliser ces événements personnalisés et agir sur ces derniers dans un journey. Pour ce faire, un nouveau composant a été ajouté aux Custom journeys, « Événements personnalisés », qui permet d'utiliser les données de la liste des événements personnalisés.

Pour plus d'informations à ce sujet, consultez le sujet suivant.

Remarque importante : les événements personnalisés ne peuvent être liés qu'à un maximum de 20 journeys à la fois. Lorsque vous atteignez cette limite, assurez-vous que tous les trajets liés sont toujours pertinents. Si non, pausez ces journeys.

 

Utiliser les données d'événement personnalisées dans le contenu Contenu

Les données de la liste d'événements personnalisés peuvent être utilisées pour personnaliser votre message.

Note: Les données d'événements personnalisés ne peuvent être utilisées que dans un message, pas dans un template.

La boîte de dialogue Personnalisation vous donne accès à cette information dès que vous avez configuré votre message pour l'utilisation des données d'événement. Ainsi, le marketer peut personnaliser le message de chaque contact en y ajoutant des informations à partir des fiches d'événements personnalisés correspondantes.

Exemple: Personnaliser l'objet du message en y intégrant la date de l'événement..

 

Lorsqu'un champ d'événements personnalisés de type JSON contient un tableau défini, ce dernier peut être utilisé comme source de données possible dans une sélection de données. Cela permet au marketer d'utiliser les données du tableau pour personnaliser le message.

Exemple:
La liste d'événements personnalisés AnnualCustomerDay2025 (JournéeClientAnnuelle2025) est liée à notre liste d’utilisateurs Parana. La liste d'événements personnalisés contient un champ JSON  PREFEREDLOCATIONS  (LieuxPréférés), dans lequel l'ADRESSE est un tableau..

Lorsque cette liste d'événements personnalisés est utilisée dans un message, le champ du tableau (l'adresse dans notre exemple) est disponible comme source de données possible dans la sélection de données. Ces données sont représentées par le nom du champ JSON (PREFEREDLOCATIONS), suivi du nom du champ du tableau dans le JSON (ADRESSE):

lorsque le champ du tableau est sélectionné comme source, les champs de ce tableau peuvent être sélectionnés dans la section Field selection (Sélection du champ).

Cela les rendra disponibles pour la personnalisation dans le message :

Ce qui permettra de les personnaliser dans le message : une fois cette sélection de données configurée, les données du tableau du champ d’événements personnalisés peuvent être utilisées dans un répéteur. Elles sont répertoriées comme suit dans la boîte de dialogue Personnalisation.

 

Remarque : Une confirmation s'affiche lorsque vous modifiez l'événement personnalisé qui est également utilisé comme sélection de données dans un message. Si vous décidez de modifier l'événement personnalisé, la sélection de données ne sera plus valable et sera supprimée. Il s'agit d'une mesure de sécurité pour s'assurer que le marketer ne peut pas corrompre les données..

Le filtre de sélection de données constitue une autre méthode d'utilisation des données d'événements personnalisés. En effet, les données de la sélection de données peuvent être filtrées de sorte à ne renvoyer que les éléments correspondant aux informations disponibles dans les événements personnalisés. Remarque : Les conditions préalables suivantes sont requises :

Exemple: Dans notre exemple, nous souhaitons utiliser le champ ID d'emplacement stocké dans la liste d'événements personnalisés pour filtrer la sélection de données et récupérer les détails d'un emplacement spécifique.
Nous disposons d'utilisateurs Parana Users avec une liste d'audiences ANNUALCUSTOMERDAYS2025.
Dans cette liste d'événements personnalisés, nous avons marqué le champ LOCATIONSID comme « Série d'identifiants de la sélection de données », nous permettant d'utiliser ces informations pour rechercher des détails sur le bon emplacement dans la sélection de données :

Dans ce message, nous avons sélectionné la liste d'événements personnalisés dans le champ de données d'événements. Ensuite, le champ d'événements personnalisés peut être utilisé dans le filtre de sélection de données :

Ainsi, seuls les emplacements correspondant à celui de la liste d'événements personnalisés sont renvoyés..

 

Utilisation des données d'événements personnalisées dans les composants Journey

La date dans les événements personnalisés peut être utilisée pour définir le parcours du contact dans le journey. Elle s'affiche

  • dans les contraintes du composant Fractionner basé sur des règles

  • dans les expressions du composant Fractionner basé sur des règles

  • dans le composant Filtre d'audience, pour filtrer les contacts :

  • Dans les paramètres d'un composant Redirection, par le biais de la boîte de dialogue Personnalisation :

 

Mettre en pause et reprendre les événements personnalisés

En haut de l'aperçu, le nom de la liste des événements personnalisés s'affiche avec les 3 états possibles en regard :

Pas de journey abonné — Les événements personnalisés ne sont pas encore utilisés dans un journey actif. Certains journeys contiennent peut-être déjà un composant Événement personnalisé lié à cette liste d'événements personnalisés, mais tant qu'ils ne sont pas actifs, le statut demeure « Pas de journey abonné ».

En pause — Cela signifie que la liste des événements personnalisés est utilisée dans un journey actif, mais qu'elle a été mise en pause. Par conséquent, de nouvelles fiches peuvent toujours être ajoutées à la liste des événements personnalisés, mais elles ne seront pas traitées. Elles restent dans la liste des événements personnalisés jusqu'à la reprise de la liste. Notez que lorsque le journey est de nouveau activé, aucun événement personnalisé n'est ignoré. Chacun est traité avec un certain retard.

Actif — La liste des événements personnalisés est utilisée dans un journey actif et toutes les fiches sont en cours de traitement.

Pour mettre en pause et reprendre la liste des événements personnalisés, cliquez sur le bouton Pause/Reprise dans la barre d'outils des événements personnalisés.

Ce bouton n'est disponible que lorsque les événements personnalisés sont utilisés dans au moins un journey actif. La réactivation n'est pas possible lorsqu'aucun journey actif n'est lié. Le cas échéant, l'utilisateur en est informé :

La boîte de dialogue fournit des informations sur le nom du journey et l'Unité commerciale à laquelle la liste d'événements personnalisés est liée, ainsi que sur le statut du journey.

Remarque : Lors de la mise en pause/reprise des événements personnalisés, vous pouvez supprimer les événements entrants non traités. Cela signifie que lorsque cette option est sélectionnée et que les événements personnalisés reprennent, toutes les fiches ajoutées aux événements personnalisés entre-temps ne seront plus traitées. Ces fiches sont définies sur l'état=60. Cette information est consultable dans l'entrée Données de la liste des événements personnalisés.