Personnalisez les messages OneSignal en utilisant des propriétés prédéfinies et des Tags de données personnalisés. Accédez aux données au niveau utilisateur, abonnement, Journey, message, template, application et organisation avec la syntaxe Liquid dans les e-mails, les notifications push, les SMS et les webhooks.
Use this file to discover all available pages before exploring further.
Utilisez les propriétés (telles que les Tags utilisateur et les identifiants comme l’External ID) pour personnaliser les messages et les charges utiles de livraison avec la syntaxe Liquid.OneSignal résout les espaces réservés Liquid au moment de l’envoi, en utilisant les données déjà stockées sur l’utilisateur, la Subscription, le Journey, le message, le template, l’application ou l’organisation. Vous pouvez utiliser ces données pour personnaliser les messages, les webhooks de Journey et les Event Streams.
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.
Seule la substitution de Tags est prise en charge. Les propriétés, les Custom Events et les autres sources de données ne sont pas disponibles pour le moment.
Les Tags doivent être définis avant que l’utilisateur ne démarre une nouvelle session de l’application.
La substitution de Tags peut ne pas apparaître lors de l’utilisation des flux d’envoi test.
Éditeur de blocs : Blocs Texte, Bouton et Image
Éditeur HTML : Éléments texte et attributs (src, href, action, data)
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
Hi {{ first_name | default: "friend" }}!Congrats on reaching level {{ level | default: "1" }}!
Si un utilisateur a les Tags first_name: Jon et level: 5, il verra :
Utilisez user 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.
L’objet message 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.
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 :
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
{% assign item_count = cart_items_count | plus: 0 %}{% if item_count == 1 %}You left {{product_name}} in your cart.{% endif %}{% if item_count == 2 %}You left {{product_name}} and {{item_count | minus: 1}} more item in your cart.{% endif %}{% if item_count > 2 %}You left {{product_name}} and {{item_count | minus: 1}} more items in your cart.{% endif %}