Événements personnalisés

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
Mesurer les conversions et les attribuer aux messages qui les ont générées
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 :

string

requis

Le nom de l’événement. Maximum 512 octets. Les noms sont mesurés en octets, de sorte qu’un nom composé de caractères multi-octets atteint la limite plus tôt que ne le suggère son nombre de caractères.

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.

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.

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.

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

Limites des noms d’événements

Chaque application peut envoyer jusqu’à 1 000 noms d’événements personnalisés uniques. Les événements envoyés sous un nom que votre application utilise déjà sont toujours acceptés. Atteindre la limite n’interrompt donc jamais les événements que vous envoyez déjà. Une fois qu’une application atteint 1 000 noms, les événements envoyés sous un nouveau nom sont rejetés. OneSignal rejette l’événement individuel, et non la requête, de sorte que les autres événements du même lot sont traités normalement. L’API renvoie HTTP 202 avec un tableau errors, et chaque événement rejeté porte le code d’erreur too many event names. Un événement rejeté n’est pas stocké, n’est pas facturé et ne peut pas déclencher un Journey, personnaliser un message ou être utilisé dans un segment. Il apparaît toutefois dans Data > Events & Conversions, marqué comme échoué avec la raison “This app has reached its limit of unique event names”, afin que vous puissiez voir quels noms ont été rejetés. Pour libérer de la place, supprimez un nom d’événement personnalisé que vous n’utilisez plus. La suppression d’un nom libère son emplacement et supprime définitivement les événements stockés sous ce nom.

La page Custom Events vous avertit dès que votre application dépasse 900 noms d’événements uniques, avant qu’un événement ne soit rejeté.

La limite de noms est distincte de la durée pendant laquelle OneSignal conserve chaque événement. Consultez Stockage et rétention des événements personnalisés pour la rétention.

Nommez vos événements pour ne pas atteindre la limite

Le nom de l’événement indique ce qui s’est passé. Tout ce qui varie appartient aux propriétés. Placer un ID, un prix ou toute autre valeur variable dans le nom crée un nouveau nom unique à chaque envoi et épuise rapidement la limite de 1 000.

{
  "name": "purchase_completed",
  "properties": { "product_id": "SKU-4412", "price": 24.99, "currency": "USD" }
}

{
  "name": "purchase_completed_SKU-4412_24.99"
}

Les propriétés sont disponibles dans les Journeys, les conversions et les segments.

Supprimer un nom d’événement pour libérer un emplacement

La suppression d’un nom d’événement personnalisé libère son emplacement et supprime définitivement les événements stockés sous ce nom. Cette action est irréversible.

Trouver les événements que vous n'utilisez plus

Allez dans Data > Events & Conversions et ouvrez l’onglet Event List. Sélectionnez un événement pour ouvrir sa vue détaillée. Le panneau Usage affiche chaque Journey et segment qui y fait référence, et l’horodatage de la dernière occurrence indique si l’événement arrive encore.

Retirer l'événement de tout ce qui l'utilise encore

Un événement listé sous Usage est actif. Mettez d’abord à jour ou supprimez ces Journeys et segments, sinon la suppression du nom affectera leur comportement.

Supprimer le nom

Ouvrez le menu de la ligne à côté du nom de l’événement et sélectionnez Delete, puis confirmez. Vous avez besoin de l’autorisation de supprimer des événements personnalisés. Si l’option est absente, demandez à une personne de votre compte disposant d’un rôle qui l’accorde.

Actualiser la page

La suppression s’exécute en arrière-plan et peut prendre quelques minutes. La page ne se met pas à jour d’elle-même, alors sélectionnez Refresh List pour confirmer que le nom a disparu et que l’emplacement est libre.

Envoyer des événements personnalisés à OneSignal

Tous les événements sont traités de la même manière à des fins de facturation, quelle que soit leur source.

API et SDK

Create Custom Events API

Envoyez des événements depuis votre backend.

Mobile/Web SDKs

Suivez les événements côté client.

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"
    },
    {
      "name": "add_to_cart",
      "properties": {
        "item": "Hoodie",
        "size": "medium",
        "color": "black",
        "price": 49.99
      },
      "external_id": "user_12345",
      "timestamp": "2025-10-21T19:12:10.000Z",
      "idempotency_key": "789a0123-b45c-67d8-e901-234567890abc"
    },
    {
      "name": "signup_completed",
      "properties": {
        "plan": "pro",
        "trial": true
      },
      "external_id": "user_67890",
      "timestamp": "2025-10-21T19:15:44.000Z",
      "idempotency_key": "def01234-5678-90ab-cdef-012345678901"
    }
  ]
}

Intégrations

OneSignal se connecte à plus de 25 sources de données externes pour importer des événements personnalisés, incluant des entrepôts de données, des bases de données et des plateformes de streaming, sans code personnalisé requis.

Twilio Segment

Routez les événements et les audiences entre Segment et OneSignal.

Amplitude

Synchronisez les cohortes et importez des événements personnalisés depuis Amplitude.

Snowflake

Importez des événements personnalisés depuis votre entrepôt Snowflake.

Google BigQuery

Importez des événements personnalisés depuis des datasets BigQuery.

Apache Kafka

Diffusez des événements personnalisés depuis des topics Kafka.

Parcourir toutes les sources d'événements personnalisés

Consultez la liste complète des bases de données, entrepôts et plateformes de streaming qui importent des événements personnalisés dans OneSignal.

Pas de ressources développeur ? Importez des événements personnalisés directement depuis une feuille de calcul Google Sheets, sans aucun code requis. Ajoutez vos données d’événement à une feuille et OneSignal les importe automatiquement. Idéal pour l’expérimentation précoce ou les équipes sans support technique.

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

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

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.

Les événements personnalisés apparaissent instantanément sur la page Custom Events. Cependant, il peut s’écouler jusqu’à 5 minutes avant que les événements n’apparaissent dans le profil d’un utilisateur sous Activity Timeline > Custom Events. Cela s’explique par le fait que la page Custom Events reflète l’ingestion récente, tandis que le profil utilisateur est alimenté par le stockage à long terme.

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.

Mesurer les conversions

Définissez un événement personnalisé comme métrique de conversion pour mesurer l’impact commercial de votre messagerie. OneSignal attribue les conversions aux messages push, email, SMS, in-app et RCS qui les ont générées à l’aide d’un modèle d’attribution multicanal au dernier point de contact. Configurez cela dans Settings > Analytics > Conversion Metrics, où vous choisissez comment mesurer l’événement :

Count suit la fréquence à laquelle l’événement s’est produit (par exemple, 15 achats).
Value totalise une propriété d’événement numérique (par exemple, 1 250 $ de revenus à partir d’une propriété price).

Les conversions apparaissent sur le tableau de bord global des conversions et sur les rapports de messages, de modèles et de Journeys.

Le fait qu’un événement compte comme une conversion est indépendant de son paramètre de rétention. Un événement peut compter dans une métrique de conversion même lorsque la rétention est configurée de sorte que l’événement ne soit pas stocké.

Métriques de conversion

Fenêtres d’attribution, modèle d’attribution et instructions de configuration.

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
Les segments d’événements personnalisés sont basés sur les utilisateurs. Ils ne peuvent pas être combinés avec des segments basés sur les abonnements pour l’inclusion ou l’exclusion lors de l’envoi de messages en dehors des Journeys, qui sont eux-mêmes basés sur les utilisateurs.
Les filtres temporels (« s’est produit au cours des X derniers jours ») font référence au moment où l’événement a été reçu par OneSignal, et non au moment où il s’est produit à l’origine. Si vous importez des événements historiques et devez segmenter par heure d’événement d’origine, utilisez un Tag pour stocker l’heure de l’événement sous forme d’horodatage unix. Le filtre de tag prend en charge un opérateur « Time Elapsed » pour les comparaisons temporelles dynamiques. Notez que les tags sont au niveau utilisateur, donc seule la valeur la plus récente est stockée.

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. L’envoi d’événements est gratuit. OneSignal ne facture que les événements que vous stockez, ce dont les segments et les profils utilisateur ont besoin.

Stockage et rétention des événements personnalisés

Activez le stockage, définissez la rétention par événement et gérez vos événements stockés.

FAQ Facturation

Comment le stockage des événements apparaît sur votre facture.

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ées	Segmentation et personnalisation	Déclencher des Journeys sans Segment, étapes Wait Until, personnalisation directement dans les Journeys
Rétention des données	À vie	Illimitée (min. 30 jours)
Format des données	Chaînes ou nombres clé-valeur	JSON
Source des données	SDK OneSignal, API ou import CSV	SDK OneSignal, API ou intégrations
Accès aux données	Segmentation et personnalisation des messages	Personnalisation 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

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

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

​Structure d’un événement personnalisé

​Limites des noms d’événements

​Nommez vos événements pour ne pas atteindre la limite

​Supprimer un nom d’événement pour libérer un emplacement

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

​API et SDK

Create Custom Events API

Mobile/Web SDKs

​Intégrations

Twilio Segment

Amplitude

Snowflake

Google BigQuery

Apache Kafka

Parcourir toutes les sources d'événements personnalisés

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

​Onglet Event List

​Onglet Event Activity

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

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

Paramètres de Journey

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

Étape Wait Until du Journey

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

Personnalisation par événement personnalisé

​Mesurer les conversions

Métriques de conversion

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

Segmentation

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

Stockage et rétention des événements personnalisés

FAQ Facturation

​Tags vs événements personnalisés

Que sont les événements personnalisés ?

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

Structure d’un événement personnalisé

Limites des noms d’événements

Nommez vos événements pour ne pas atteindre la limite

Supprimer un nom d’événement pour libérer un emplacement

Envoyer des événements personnalisés à OneSignal

API et SDK

Intégrations

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

Onglet Event List

Onglet Event Activity

Utiliser les événements personnalisés dans OneSignal

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

Contrôler le flux du Journey (Wait Until)

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

Mesurer les conversions

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

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

Tags vs événements personnalisés