Passer au contenu principal
La personnalisation vous permet d’envoyer des messages contenant des données dynamiques, telles que le nom d’un utilisateur, les articles du panier, le solde du compte, les détails d’une réservation ou un mot de passe à usage unique. Ce guide vous aide à choisir la bonne méthode de personnalisation en fonction de :
  • L’emplacement de vos données
  • Si elles doivent persister ou non
  • Comment le message est déclenché

​
Comment fonctionne la personnalisation

La personnalisation dans OneSignal comporte deux parties :
  1. La syntaxe Liquid : définit comment les valeurs s’affichent dans votre message
  2. Une source de données : détermine d’où provient la valeur
Au moment de l’envoi, OneSignal résout vos variables Liquid en utilisant la source de données sélectionnée.
Liquid contrôle le formatage et la logique (variables, boucles, conditions). La source de données détermine quelles valeurs sont disponibles.
Exemple :
Liquid
Hi {{ user.tags.first_name }},

Your verification code is {{ message.custom_data.otp }}.
  • user.tags.first_name est une propriété stockée
  • message.custom_data.otp est transmis via le champ API custom_data

​
Champs pris en charge par type de message

  • Objet, Répondre à et Pré-en-tête
  • Corps du message
  • Substitution d’image dans les blocs HTML. Exemple : <img src="{{image_url}}"/>
  • Actions de bloc de bouton comme les URL, Mail to et d’autres champs.

​
Sources de données

OneSignal prend en charge cinq sources de données pour la personnalisation. Utilisez le tableau ci-dessous pour identifier la source adaptée à votre cas d’utilisation, puis lisez la section détaillée pour obtenir des conseils d’implémentation.
Source de donnéesCe que c’estQuand l’utiliserPersistanteDisponible dans les Journeys
PropriétésTags, External ID, données de Subscription, champs d’applicationValeurs réutilisables stockées dans OneSignal (nom, plan, préférences)OuiOui
Custom EventsPropriétés d’événements capturées à l’entrée du Journey ou Wait UntilPersonnalisation comportementale dans les JourneysPar événementJourney uniquement
API custom_dataPaires clé-valeur transmises dans l’API Create MessageValeurs à usage unique ou sensibles (OTP, liens sécurisés, articles du panier)NonNon
Data FeedsAppel API en direct effectué au moment de l’envoiValeurs qui changent fréquemment (prix, inventaire, solde de compte)NonOui
Dynamic Content CSVCSV importé dans le tableau de bordCampagnes en masse avec contenu par destinatairePar envoiNon
Erreurs courantes à éviter
  • Utiliser les propriétés (Tags) pour des valeurs à usage unique comme les OTP ou les codes de vérification — utilisez plutôt custom_data
  • S’attendre à ce que custom_data soit disponible dans les Journeys ou les messages futurs — il n’existe que pour la requête API en cours
  • Supposer que les propriétés des Custom Events sont disponibles en dehors de l’entrée dans le Journey déclenchée par l’événement ou d’une étape Wait Until
  • Utiliser les Data Feeds pour des données statiques qui changent rarement — utilisez plutôt les propriétés

​
Propriétés

Les propriétés incluent les Tags utilisateur, l’External ID, les données de Subscription et les champs au niveau de l’application. Elles sont : Utilisez les propriétés quand :
  • La valeur existe dans OneSignal
  • La valeur est persistante
  • Vous la réutilisez à travers les campagnes

Personnaliser avec les propriétés

Apprenez à référencer les données de propriétés persistantes stockées.

​
Custom Events

Les Custom Events peuvent personnaliser les messages à l’intérieur des Journeys en utilisant les propriétés d’événements. Lorsqu’un événement démarre un Journey ou correspond à une condition Wait Until, OneSignal stocke cet événement afin que ses propriétés puissent être référencées dans les modèles de messages en utilisant Liquid. Quand utiliser les Custom Events :
  • Messages déclenchés par événement avec les Journeys
  • Le message doit refléter des données spécifiques à l’événement
Seuls les événements qui déclenchent l’entrée dans un Journey ou une étape Wait Until sont stockés pour la personnalisation. Les événements envoyés en dehors de ces moments ne sont pas disponibles pour les messages de Journey.

Personnalisation avec les Custom Events

Guide complet pour utiliser les propriétés d’événements dans les Journeys.

​
API custom_data

Le champ custom_data dans l’API Create Message vous permet d’envoyer des valeurs spécifiques au message depuis votre backend. Ces données :
  • N’existent que pour la requête en cours
  • Ne sont pas stockées dans OneSignal
  • Ne sont pas disponibles dans les Journeys
Utilisez custom_data quand :
  • Vous envoyez des valeurs à usage unique ou sensibles (OTP, liens sécurisés)
  • Vous transmettez des tableaux (articles du panier, lignes de commande, classements)
  • Vous envoyez des messages transactionnels ou déclenchés par API

Personnaliser avec l'API custom_data

Apprenez à transmettre des données de personnalisation transitoires.

​
Data Feeds

Les Data Feeds appellent votre API au moment de l’envoi et injectent la réponse dans votre message. Quand utiliser les Data Feeds :
  • Vous avez besoin de la valeur la plus récente à la livraison
  • Les données se trouvent dans votre backend
  • La valeur peut changer entre les envois

Data Feeds

Extrayez des données backend en temps réel dans les messages au moment de l’envoi.

​
Dynamic Content CSV

Téléchargez un fichier CSV dans le tableau de bord OneSignal et référencez ses valeurs en utilisant Liquid. Utilisez le CSV quand :
  • Vous personnalisez différentes sections d’une campagne en masse pour chaque destinataire
  • Les traductions ou données personnalisées pour chaque destinataire sont exportables dans un fichier CSV
  • Vous ne souhaitez pas utiliser l’API

Dynamic Content CSV

Personnalisez les campagnes depuis le tableau de bord en utilisant des imports CSV.

​
Guides détaillés

Utilisez les guides ci-dessous pour des détails d’implémentation pas à pas et des exemples avancés.

Utiliser la syntaxe Liquid

Apprenez à insérer des données dynamiques dans les messages en utilisant Liquid. Couvre les variables, les conditions, les boucles, les filtres, le formatage et les modèles de personnalisation courants.

Data Feeds

Extrayez des données en temps réel de vos propres API au moment de l’envoi. Utilisez les Data Feeds lorsque le contenu du message dépend de valeurs backend en direct comme les soldes, la disponibilité ou les tarifs.

Personnalisation avec les Custom Events

Personnalisez les messages de Journey en utilisant les propriétés d’événements capturées lorsque les utilisateurs entrent ou progressent dans un Journey. Idéal pour les workflows comportementaux et déclenchés par événement.

Propriétés et Tags

Utilisez les propriétés stockées des utilisateurs, des Subscriptions, des messages et des applications pour personnaliser le contenu à travers les messages, les Templates, les Journey Webhooks et les Event Streams.

API custom_data

Transmettez des données par message et transitoires depuis votre backend en utilisant l’API Create Message. Idéal pour les OTP, paniers, tableaux et la personnalisation transactionnelle en masse.

Dynamic Content CSV

Téléchargez des fichiers CSV dans le tableau de bord pour personnaliser les campagnes à grande échelle. Chaque ligne correspond à un destinataire et peut être référencée en utilisant Liquid.

​
Tutoriels

Ces guides montrent comment implémenter la personnalisation en pratique.

Vérification, lien magique et OTP

Envoyez des messages de vérification sécurisés en utilisant des mots de passe à usage unique, des liens magiques ou des URL personnalisées avec la personnalisation pilotée par API.

Journey de panier abandonné

Construisez un Journey automatisé qui détecte l’activité du panier, attend l’inactivité, envoie un rappel personnalisé et fait sortir les utilisateurs immédiatement après l’achat.

Confirmations de réservation

Envoyez des messages de confirmation et de relance de réservation en utilisant les Custom Events, les Journeys et les Data Feeds basés sur le statut de réservation en temps réel.

Messages transactionnels

Apprenez à envoyer des reçus, des alertes, des confirmations et d’autres messages transactionnels sur tous les canaux en utilisant les API et l’automatisation.

Exemples de personnalisation in-app

Découvrez des exemples pratiques d’utilisation des Tags et des propriétés pour personnaliser les messages in-app pour différents utilisateurs et segments.