Quand utiliser la personnalisation par propriétés
Utilisez la personnalisation par propriétés pour générer le contenu au moment de l’envoi en utilisant des données déjà existantes dans OneSignal — le plus souvent les Tags utilisateur, l’External ID et les champs d’abonnement comme l’adresse e-mail ou le numéro de téléphone. Cette approche est adaptée lorsque :- Les données sont déjà stockées dans OneSignal
- Vous souhaitez que les espaces réservés Liquid soient automatiquement remplacés lors de l’envoi du message
- Vous n’avez pas besoin de récupérer ou de calculer des données fraîches au moment de la livraison
Si la valeur doit être récupérée ou calculée au moment de l’envoi (par exemple, des prix en temps réel ou un état de stock), utilisez les Data Feeds ou notre API avec
custom_data.Si la valeur provient de l’événement qui a fait entrer ou progresser un utilisateur dans un Journey, utilisez la personnalisation par Custom Events.Prise en charge des canaux
Chaque canal prend en charge des types de propriétés et des champs spécifiques.- E-mail
- Push
- SMS
- Messages in-app
- Live Activities
Prend en charge les propriétés utilisateur et d’abonnement dans :
- Objet, Répondre à et Pré-en-tête
- Corps du message
- Attributs HTML (par exemple :
<img src="{{ image_url }}" />) - Actions des boutons (URL, mailto, etc.)
Fonctionnement de la personnalisation par propriétés
OneSignal remplace les espaces réservés Liquid par les valeurs de propriété correspondantes pour l’utilisateur et la Subscription auxquels le message est envoyé.Liquid
first_name: Jon et level: 5, il verra :
Text
Si un utilisateur n’a aucun tag défini, il verra les valeurs par défaut à la place.
Référence des objets Liquid de propriétés
Utilisez cette section pour consulter les noms exacts des objets et des champs disponibles en Liquid.Propriétés utilisateur et d’abonnement
Utilisezuser pour les données au niveau utilisateur. Utilisez subscription lorsque vous avez besoin de valeurs spécifiques au canal, comme l’adresse e-mail ou le numéro de téléphone.
user.tags
Les Tags de l’utilisateur. Vous pouvez référencer les Tags de plusieurs manières :
- Utilisez la
keydirectement ou placez la clé aprèstags - Exemple de Tags définis :
first_name: Jon, level: 5
Liquid
- Itérez sur les Tags avec la syntaxe de boucle for. Cet exemple affiche les paires clé:valeur séparées par des virgules.
Liquid
user.external_id
L’External ID de l’utilisateur.
Liquid
user.onesignal_id
L’identifiant OneSignal de l’utilisateur.
Liquid
subscription.email
L’adresse e-mail de la Subscription e-mail à laquelle le message est envoyé.
Liquid
subscription.phone_number
Le numéro de téléphone de la Subscription SMS à laquelle le message est envoyé.
Liquid
user.language
Le code de langue de l’utilisateur.
Liquid
user.subscriptions
Les Subscriptions de l’utilisateur.
- Itérez sur les Subscriptions avec la syntaxe de boucle for.
- Cet exemple affiche le token et l’identifiant de chaque Subscription, séparés par des virgules.
JSON
subscription.unsubscribe_token
Le token utilisé avec l’API de désabonnement par e-mail avec token.
Propriétés de Journey
L’objetjourney vous permet de référencer le nom du Journey ou d’accéder à la personnalisation par Custom Events pour le Journey.
journey.name
Le nom du Journey.
JSON
Propriétés de message
L’objetmessage donne accès à l’identifiant du message, au nom et à l’identifiant du template, ce qui peut être utile pour les Event Streams, ainsi qu’à l’accès aux custom_data pour personnaliser les messages envoyés depuis votre backend.
message.id
L’identifiant du message défini par OneSignal.
message.name
Le nom du message défini par vous, l’expéditeur.
message.template_id
L’identifiant du template défini par OneSignal.
Propriétés de template
L’objettemplate donne accès à l’identifiant et au nom du Template utilisé pour envoyer le message. Cela peut être utile pour les Event Streams.
template.id
L’identifiant du template défini par OneSignal.
template.name
Le nom du template défini par vous, l’expéditeur.
Propriétés d’application et d’organisation
Les objetsapp et org fournissent des détails sur l’application et l’organisation qui ont envoyé le message. Cela peut être utile pour les Event Streams.
app.id
L’identifiant de l’application défini par OneSignal.
app.name
Le nom de l’application défini par vous, le propriétaire de l’application.
org.id
L’identifiant de l’organisation défini par OneSignal.
org.name
Le nom de l’organisation défini par vous, le propriétaire de l’organisation.
Exemple : Panier abandonné avec des Tags
Cet exemple montre comment personnaliser les messages de panier abandonné en utilisant les Tags utilisateur. Il s’appuie sur le tutoriel Panier abandonné. Exemple de Tags définis :JSON
Template e-mail
Créer un nouveau template e-mail
Naviguez vers Messages > Templates > New Email Template et ouvrez l’éditeur glisser-déposer.
Ajouter la structure de mise en page
Créez cinq lignes :
- Lignes 1, 2 et 4 : une colonne avec un bloc Paragraphe
- Ligne 3 : quatre colonnes avec HTML | Paragraphe | Paragraphe | Paragraphe
- Ligne 5 : une colonne avec un bloc Bouton

Ajouter du Liquid aux blocs de paragraphe
Dans la ligne 1, ajoutez :Dans la ligne 2, ajoutez une description de ce que l’utilisateur regarde :Dans la ligne 4, ajoutez un autre appel à l’action :
Liquid
Text
Text
Afficher l'article le plus récent
Dans la ligne 3, configurez les quatre colonnes :Colonne 1 (bloc HTML) :Colonnes 2 à 4 (blocs Texte) :
HTML
- Colonne 2 :
{{product_name}} - Colonne 3 :
{{product_quantity}} - Colonne 4 :
{{product_price}}
Ajouter l'URL du panier au bouton
Dans le bloc Bouton de la ligne 5, définissez l’URL d’action sur :

Tester et prévisualiser le template
Envoyez un e-mail test à vous-même en utilisant le bouton Test & preview.
- Assurez-vous que les Tags sont définis sur votre Subscription e-mail.

Styliser le template
Succès ! Vous pouvez maintenant appliquer votre propre mise en forme au template. Consultez Concevoir des e-mails avec le glisser-déposer.
Template push
Les notifications push ont un espace limité, affichez donc un seul article et mentionnez le nombre total. Champ du message : Affichez l’article et le nombre avec une grammaire correcte en utilisant les instructions conditionnelles.Liquid
Liquid

Succès ! Vous pouvez maintenant créer d’autres templates et les utiliser dans le Journey de panier abandonné.
Pages associées
Personnalisation des messages
Aperçu de toutes les options de personnalisation dans OneSignal, y compris quand utiliser les Custom Events par rapport aux autres méthodes.
Tags
Découvrez comment définir des Tags sur les utilisateurs via le SDK, l’API ou l’import CSV.
Utiliser la syntaxe Liquid
Référence complète de Liquid avec les filtres, les conditions, les boucles et la manipulation de chaînes.
Templates
Créez et gérez des Templates de messages réutilisables pour les utiliser dans les Journeys.
Exemples de messages in-app
Affichez des messages in-app personnalisés basés sur les Tags.
Tutoriel panier abandonné
Construisez un Journey de panier abandonné en utilisant les Tags et les propriétés.
Besoin d’aide ?Discutez avec notre équipe d’assistance ou envoyez un e-mail à
support@onesignal.comVeuillez inclure :- Les détails du problème que vous rencontrez et les étapes de reproduction si disponibles
- Votre OneSignal App ID
- L’External ID ou le Subscription ID le cas échéant
- L’URL du message que vous avez testé dans le OneSignal Dashboard le cas échéant
- Tous les journaux ou messages d’erreur pertinents