Personaliza los mensajes de OneSignal usando propiedades predefinidas y Tags de datos personalizados. Accede a datos a nivel de usuario, suscripción, Journey, mensaje, plantilla y aplicación con sintaxis Liquid en correo electrónico, push, SMS y webhooks.
Usa propiedades (como Tags de usuario e identificadores como External ID) para personalizar mensajes y cargas de entrega con sintaxis Liquid.OneSignal renderiza los marcadores Liquid en el momento del envío, usando datos ya almacenados en el usuario, suscripción, Journey, mensaje, plantilla, aplicación u organización. Puedes usar estos datos para personalizar mensajes, webhooks de Journey y Event Streams.
Usa la personalización con propiedades para renderizar contenido en el momento del envío utilizando datos que ya existen en OneSignal, más comúnmente Tags de usuario, External ID y campos de suscripción como correo electrónico o número de teléfono.Este es el enfoque correcto cuando:
Los datos ya están almacenados en OneSignal
Quieres que los marcadores Liquid se reemplacen automáticamente cuando se envía el mensaje
No necesitas obtener o calcular datos nuevos en el momento de la entrega
Si el valor debe obtenerse o calcularse en el momento del envío (por ejemplo, precios en tiempo real o inventario), usa Data Feeds o nuestra API con custom_data.Si el valor proviene del evento que causó que un usuario ingresara o avanzara en un Journey, usa la personalización con Custom Events.
Usa user para datos a nivel de usuario. Usa subscription cuando necesites valores específicos del canal como dirección de correo electrónico o número de teléfono.
El objeto message proporciona acceso al ID del mensaje, nombre e ID de plantilla que pueden ser útiles para Event Streams, junto con acceso a custom_data para personalizar mensajes enviados desde tu backend.
Este ejemplo muestra cómo personalizar mensajes de carrito abandonado usando Tags de usuario. Se basa en el tutorial de carrito abandonado.Tags de ejemplo configurados:
Las notificaciones push tienen espacio limitado, así que muestra un artículo y menciona la cantidad total.Campo de mensaje:Muestra el artículo y la cantidad con gramática correcta usando declaraciones condicionales.
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 %}
Este ejemplo muestra un mensaje in-app de recompensa personalizado con Tags. El mensaje in-app sustituye los valores de Tag en varios tipos de bloques.En el mensaje configurado:
Bloque de texto — muestra el nivel completado y la recompensa para ese nivel
Bloque de imagen — muestra la imagen para esa recompensa, con una imagen predeterminada como respaldo
Texto del botón 2 — muestra el valor de la recompensa, con un valor predeterminado de 100
Imagen de fondo — establecida desde un valor de Tag
Editor de mensajes in-app con sustitución de Tags configurada en bloques de texto, imagen y botón
El mensaje se renderiza al inicio de la sesión usando los valores de Tag actuales del usuario:
Mensaje in-app mostrado al usuario con valores sustituidos desde Tags
Consulta la pestaña Mensajes in-app en Compatibilidad de canales más arriba para conocer los bloques, atributos y reglas de temporización compatibles. Dos recordatorios que vale la pena reforzar:
Las Tags deben configurarse antes de que el usuario inicie una nueva sesión de la app. Las Tags actualizadas a mitad de sesión no se renderizan en los mensajes in-app mostrados en esa sesión.
La sustitución de Tags no se renderiza en los envíos de prueba “Send Test Message”. Activa el mensaje desde una sesión real para verificar la sustitución.
