Passer au contenu principal

​
Vue d’ensemble

Les événements personnalisés vous permettent de suivre les actions utilisateur significatives depuis votre application, site web ou systèmes externes — et d’agir en temps réel. Envoyez des événements utilisateur pour des comportements qui se produisent en dehors de OneSignal et utilisez-les pour délivrer des messages plus ciblés, pertinents et opportuns. Vous pouvez :
  • Envoyer des événements directement depuis votre application ou site web en utilisant les SDK OneSignal
  • Importer des événements depuis vos intégrations, CDP ou entrepôt de données
  • Les utiliser pour déclencher des Parcours, activer des étapes Wait Until, et segmenter les utilisateurs basés sur le comportement en temps réel (option de segmentation à venir)
Exemples de cas d’utilisation :
  • Utilisateur s’inscrit → Démarrer le parcours d’intégration
  • Utilisateur abandonne le panier → Envoyer un rappel ou une offre
  • Joueur atteint un nouveau niveau → Envoyer une récompense in-app
  • Utilisateur tente d’annuler son compte → Déclencher une campagne de réengagement

​
Qu’est-ce qu’un événement personnalisé ?

Un événement personnalisé est toute action utilisateur suivie — ou inaction — qui importe pour votre entreprise. Les exemples courants incluent :
  • Effectuer un achat
  • Terminer un niveau de jeu
  • Démarrer une séance d’entraînement
  • Annuler un abonnement
Chaque événement peut inclure des propriétés pour fournir un contexte supplémentaire. Structure d’événement personnalisé :
  • name (string, requis) — Nom de l’événement, max 128 caractères
  • properties (object, optionnel) — Données de contexte en JSON
  • Identifiant utilisateur (requis) — Soit external_id soit onesignal_id
Exemple : 
{
  "events": [
    {
      "external_id": "user_12345",
      "timestamp": "2025-10-21T19:09:32.263Z",
      "name": "purchase",
      "properties": {
        "item": "T-shirt",
        "size": "small",
        "color": "blue",
        "price": 24.99
      }
    }
  ]
}
Les événements personnalisés peuvent être :
  • Produits en temps réel depuis votre application ou site (SDK Mobile/Web OneSignal)
  • Ingérés depuis des intégrations comme Segment, Amplitude ou Databricks (à venir)
  • Importés depuis votre entrepôt ou CDP (à venir)

​
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

​
Intégrer les événements personnalisés dans OneSignal

Vous pouvez générer des événements directement avec nos API ou les ingérer depuis d’autres systèmes.
Tous les événements — qu’ils soient générés depuis un SDK ou ingérés depuis un entrepôt de données — sont traités de la même manière à des fins de facturation.

​
API OneSignal et SDK

Envoyez des événements via : Exemple : Envoi via API
curl
curl --request POST \
  --url https://api.onesignal.com/apps/{app_id}/custom_events \
  --header 'Content-Type: application/json' \
  --data '{
  "events": [
    {
      "name": "completed_onboarding",
      "external_id": "user_12345",
      "properties": {
        "plan": "Pro",
        "time_to_complete": 600
      }
    }
  ]
}'
​
name
string
required
L’identifiant ou le nom de l’événement. Maximum 128 caractères.
​
external_id
string
L’ID externe de l’utilisateur ciblé pour l’événement. Soit l’ID externe de l’utilisateur, soit l’ID OneSignal est requis.
​
properties
object
Paramètres optionnels concernant l’événement (par ex., nom du forfait, ID produit, prix).
Cet événement ajoutera immédiatement l’utilisateur avec external_id user_12345 à un Parcours avec completed_onboarding comme déclencheur de règle d’entrée d’événement personnalisé ou action wait until.

​
Intégrations

Si les événements sont déjà suivis ailleurs, importez-les via les intégrations prises en charge.

​
Afficher et vérifier les événements

Une fois que les événements commencent à arriver, vous pouvez les visualiser et les dépanner via plusieurs outils dans OneSignal.

​
Onglet Liste des événements

Naviguez vers votre Organisation

L’onglet Liste des événements fournit un tableau de bord de haut niveau de vos événements, organisés par type 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écemment ingéré (affiché au format JSON avec ses propriétés), la source de l’événement (SDK, API ou intégration), et la dernière fois que le type d’événement s’est produit. Dans la vue détaillée de chaque événement, vous avez également la possibilité de mettre à jour sa période de rétention. La vue de sous-détail offre des informations supplémentaires sur trois domaines clés :
  • Répartition par source – Affiche le nombre d’événements ingérés par source, avec la possibilité de développer et de visualiser le dernier schéma des événements ainsi que l’horodatage du dernier événement vu.
  • Activités – Liste les 10 événements les plus récents ingérés, affichant leur source et leur horodatage. Chaque entrée peut être développée pour révéler la charge utile JSON complète de l’événement.
  • Utilisation – Affiche où un événement particulier est utilisé dans OneSignal, comme dans les segments ou les parcours. De là, vous pouvez cliquer directement dans le segment ou le parcours pertinent pour accéder à ses paramètres.

​
Onglet Activité des événements

Naviguez vers votre Organisation

L’onglet Activité des événements fournit un flux en direct des événements les plus récents ingérés dans votre application OneSignal. Vous pouvez développer le flux pour examiner les événements jusqu’à 90 jours en arrière et appliquer des filtres par source, propriétés d’événement ou ID externe. Cet onglet est particulièrement utile pour déboguer les problèmes lors de la configuration des sources d’événements, car il vous permet de valider si les événements atteignent votre application comme prévu. Notez que le flux ne s’actualise pas automatiquement, vous devrez donc l’actualiser manuellement après l’envoi de nouveaux événements pour voir la dernière activité.

​
Onglet Stockage des événements (À venir)

Une vue dédiée pour gérer le stockage des événements pour votre application OneSignal.

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

​
Déclencher des Parcours avec des événements

Les Parcours déclenchés par événements vous permettent de contacter immédiatement les utilisateurs en fonction de l’activité en temps réel—sans besoin d’attendre les mises à jour de segment. Vous pouvez démarrer un Parcours dès qu’un utilisateur effectue une action clé.

​
Événement Wait Until

Utilisez l’étape Wait Until pour mettre en pause les utilisateurs dans un Parcours jusqu’à ce qu’un événement personnalisé spécifique ou une autre action se produise.
Vous pouvez également définir une fenêtre d’expiration. Si l’utilisateur ne remplit pas la condition à temps, vous pouvez continuer sur un chemin de secours, envoyer un message alternatif, ou quitter le Parcours.

​
Segmentation par événements personnalisés

La segmentation avec événements personnalisés est actuellement en Accès anticipé. Pour demander l’accès, contactez support@onesignal.com avec :
Vous pouvez créer un segment basé sur l’occurrence d’un événement personnalisé. Cela vous permettra de segmenter les utilisateurs en fonction du comportement sur votre application en utilisant le SDK OneSignal ou à partir d’événements capturés en dehors de OneSignal. Plus de détails sur la segmentation par événements personnalisés sont disponibles sur la page Segmentation. Limitations de cette fonctionnalité pendant qu’elle est en Accès anticipé :
  • Ne peut pas être utilisée avec Email Warm Up et les tests A/B.
  • Les segments d’événements personnalisés ne peuvent pas être utilisés pour alimenter les Parcours.
  • Vous ne pouvez pas encore combiner les filtres d’événements personnalisés avec d’autres filtres de segmentation (comme les propriétés utilisateur ou les événements de message).

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

Les événements personnalisés sont disponibles sur tous les forfaits payants. Veuillez consulter la FAQ Facturation pour plus de détails.