Passer au contenu principal

​
Que sont les événements personnalisés ?

Un événement personnalisé est une action utilisateur nommée (ou une inaction) que vous envoyez à OneSignal. Vous envoyez des événements depuis votre application, votre site web ou des systèmes externes afin de déclencher des automatisations, contrôler le flux des Journeys et personnaliser les expériences utilisateur en temps réel. Exemples :
  • Intégration terminée
  • Achat effectué
  • Panier abandonné
  • Abonnement annulé
  • Nouveau niveau de jeu atteint
Lorsque OneSignal reçoit un événement personnalisé, vous pouvez :
  • Démarrer un Journey
  • Continuer un Journey avec une étape Wait Until
  • Faire sortir des utilisateurs d’un Journey
  • Personnaliser les messages à l’aide des propriétés d’événement
  • Segmenter les utilisateurs par comportement (accès anticipé)

​
Quand devez-vous utiliser les événements personnalisés ?

Utilisez les événements personnalisés lorsque :
  • La messagerie doit réagir au comportement utilisateur en temps réel
  • Les données représentent quelque chose qui s’est produit (et non un état permanent)
  • Vous avez besoin de propriétés d’événement pour la personnalisation ou la logique de Journey
N’utilisez pas les événements personnalisés lorsque :
  • Vous souhaitez stocker des attributs utilisateur à long terme (utilisez plutôt les Tags)
Les événements personnalisés représentent quelque chose qui s’est produit à un moment précis. Contrairement aux Tags, ils ne mettent pas à jour de manière permanente le profil de l’utilisateur — ils enregistrent un comportement.Consultez Tags vs événements personnalisés ci-dessous pour une comparaison détaillée.

​
Structure d’un événement personnalisé

Les événements personnalisés incluent les champs suivants :
​
name
string
requis
Le nom de l’événement. Maximum 128 caractères.
​
properties
object
Paramètres optionnels décrivant l’événement (par exemple : nom du forfait, ID produit ou prix). Ils peuvent être utilisés pour la personnalisation et le contrôle du flux des Journeys.
​
external_id
string
L’ID externe de l’utilisateur. Un identifiant utilisateur est requis lors de l’utilisation de l’API Create Custom Events. Soit external_id soit onesignal_id doit être fourni.
​
timestamp
string
L’heure à laquelle l’événement s’est produit (ou se produira), formatée en chaîne ISO 8601. Voir API Create Custom Events.
​
idempotency_key
string
Un UUID unique utilisé pour empêcher le traitement en double des événements. Voir API Create Custom Events.
Limites de taille des événements :
  • Charge utile maximale d’un événement : 2024 octets
  • Taille maximale d’une requête (événements multiples) : 1 Mo

​
Envoyer des événements personnalisés à OneSignal

Envoyez des événements personnalisés avec les méthodes suivantes :
Tous les événements sont traités de la même manière à des fins de facturation, quelle que soit leur source.
Exemple de charge utile d’événement personnalisé :
JSON
{
  "events": [
    {
      "name": "purchase",
      "properties": {
        "item": "T-shirt",
        "size": "small",
        "color": "blue",
        "price": 24.99
      },
      "external_id": "user_12345",
      "timestamp": "2025-10-21T19:09:32.263Z",
      "idempotency_key": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

​
Vérifier que les événements sont reçus

Après l’envoi d’événements, confirmez qu’ils atteignent OneSignal dans Data > Custom Events.

​
Onglet Event List

L’onglet Event List fournit une vue d’ensemble de tous les événements personnalisés de votre application, organisés par nom d’événement. Pour chaque type d’événement, vous pouvez voir :
  • Le nombre total d’événements ingérés
  • L’événement le plus récent (avec la charge utile JSON complète et les propriétés)
  • La source de l’événement (SDK, API ou intégration)
  • L’horodatage de la dernière occurrence
Sélectionnez un événement pour ouvrir sa vue détaillée, où vous pouvez également mettre à jour sa période de rétention. La vue détaillée comprend :
  • Répartition par source : Nombre d’événements ingérés par source. Développez pour voir le dernier schéma d’événement et l’horodatage de l’événement le plus récent.
  • Activités : Les 10 événements les plus récents, incluant la source et l’horodatage. Développez n’importe quelle entrée pour inspecter la charge utile JSON complète.
  • Utilisation : Où l’événement est actuellement utilisé (Journeys ou segments). Cliquez directement sur le Journey ou le segment associé pour modifier ses paramètres.

​
Onglet Event Activity

L’onglet Event Activity fournit un flux en direct des événements les plus récents ingérés dans votre application OneSignal. Utilisez-le pour :
  • Filtrer par nom d’événement, source ou ID externe
  • Inspecter les charges utiles JSON complètes
  • Déboguer les problèmes d’intégration
Le flux ne s’actualise pas automatiquement. Actualisez manuellement après l’envoi de nouveaux événements.

​
Utiliser les événements personnalisés dans OneSignal

Une fois que les événements arrivent dans OneSignal, vous pouvez les utiliser de la manière suivante :

​
Déclencher les règles d’entrée et de sortie des Journeys

Définissez un événement personnalisé comme règle d’entrée ou de sortie d’un Journey pour ajouter ou retirer immédiatement des utilisateurs lorsque l’événement se produit. Exemple :
  • signup_completed → Démarrer l’intégration ou retirer d’un Journey d’encouragement à l’essai
  • purchase → Envoyer une confirmation et une vente croisée ou retirer du Journey de panier abandonné

Paramètres de Journey

Intégrez des utilisateurs dans les Journeys avec des événements personnalisés.

​
Contrôler le flux du Journey (Wait Until)

Utilisez une étape Wait Until pour maintenir les utilisateurs en attente jusqu’à ce qu’un événement personnalisé se produise. Exemple :
  • Attendre jusqu’à purchase après added_to_cart
Vous pouvez définir une fenêtre d’expiration. Si l’utilisateur ne déclenche pas l’événement à temps, vous pouvez envoyer un message de secours ou quitter le Journey.

Étape Wait Until du Journey

Maintenez les utilisateurs en attente jusqu’à ce qu’un événement personnalisé se produise.

​
Personnaliser les Journeys avec les propriétés d’événement

Référencez les propriétés d’événement à l’aide de Liquid dans vos modèles de Journey. Exemple :
Liquid
Thanks for purchasing {{ journey.first_event.properties.item }}!

Personnalisation par événement personnalisé

Guide complet pour utiliser les propriétés d’événement afin de personnaliser les Journeys.

​
Segmenter les utilisateurs avec les événements personnalisés

Créez un segment basé sur l’occurrence d’un événement personnalisé.
La segmentation par événements personnalisés est en accès anticipé.Pour demander l’accès, envoyez un e-mail à support@onesignal.com avec :
  • Le nom de votre entreprise
  • Vos ID d’application OneSignal
Limitations actuelles :
  • Non compatible avec Email Warm Up ou les tests A/B
  • Ne peut pas alimenter les Journeys
  • Ne peut pas être combiné avec d’autres filtres de segment

Segmentation

Guide complet de la segmentation.

​
Disponibilité du forfait et coûts de rétention

Les événements personnalisés sont disponibles sur tous les forfaits payants.

FAQ Facturation

En savoir plus sur la rétention des événements et la tarification.

​
Tags vs événements personnalisés

Les Tags et les Événements personnalisés sont tous deux des moyens d’ajouter des données à vos utilisateurs. Cependant, il existe quelques différences clés :
FonctionnalitéTagsÉvénements personnalisés
Utilisation des donnéesSegmentation et personnalisationDéclencher des Journeys sans Segment, étapes Wait Until, personnalisation directement dans les Journeys
Rétention des donnéesÀ vie30+ jours (stockage à vie disponible)
Format des donnéesChaînes ou nombres clé-valeurJSON
Source des donnéesSDK OneSignal, API ou intégrations (limitées)SDK OneSignal, API ou intégrations
Accès aux donnéesSegmentation et personnalisation des messagesPersonnalisation des Journeys et des modèles de messages Journey, Segmentation (Prochainement)
La distinction clé entre les Tags et les Événements personnalisés réside dans leur profondeur et leurs cas d’utilisation. Les tags sont des propriétés d’un utilisateur, telles que le Nom, le Statut du compte ou l’Emplacement. Les événements sont des choses que l’utilisateur a faites, comme Acheter un article, Terminer un niveau ou Inviter un ami. Les tags et les événements peuvent tous deux être utilisés pour la segmentation et la personnalisation. En pratique, vous utiliserez probablement les deux :
  • Les tags pour les propriétés utilisateur qui sont statiques et ne changent pas souvent
  • Les événements personnalisés pour les scénarios en temps réel, la segmentation complexe et les flux de travail de parcours plus sophistiqués