Cuándo usar la personalización con propiedades
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.Compatibilidad de canales
Cada canal admite tipos de propiedades y campos específicos.- Correo electrónico
- Push
- SMS
- Mensajes in-app
- Live Activities
Admite Propiedades de usuario y suscripción en:
- Asunto, Responder a y Pre-encabezado
- Cuerpo del mensaje
- Atributos HTML (por ejemplo:
<img src="{{ image_url }}" />) - Acciones de botón (URLs, mailto, etc.)
Cómo funciona la personalización con propiedades
OneSignal reemplaza los marcadores Liquid con los valores de propiedad correspondientes para el usuario y la suscripción que recibe el mensaje.Liquid
first_name: Jon y level: 5, verá:
Text
Si un usuario no tiene tags configurados, verá los valores predeterminados en su lugar.
Referencia de objetos Liquid de propiedades
Usa esta sección para consultar los nombres exactos de objetos y campos disponibles en Liquid.Propiedades de usuario y suscripción
Usauser 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.
user.tags
Los Tags del usuario. Puedes hacer referencia a los tags de varias maneras:
- Usa la
keydirectamente o coloca la clave después detags - Tags de ejemplo configurados:
first_name: Jon, level: 5
Liquid
- Itera sobre los tags con sintaxis de bucle for. Este ejemplo muestra pares clave:valor separados por comas.
Liquid
user.external_id
El External ID del usuario.
Liquid
user.onesignal_id
El OneSignal ID del usuario.
Liquid
subscription.email
La dirección de correo electrónico de la suscripción de correo electrónico que recibe el mensaje.
Liquid
subscription.phone_number
El número de teléfono de la suscripción SMS que recibe el mensaje.
Liquid
user.language
El código de idioma del usuario.
Liquid
user.subscriptions
Las Subscriptions del usuario.
- Itera sobre las suscripciones con sintaxis de bucle for.
- Este ejemplo muestra el token y el ID de cada suscripción separados por comas.
JSON
subscription.unsubscribe_token
El token utilizado con la API para cancelar suscripción de correo electrónico con token.
Propiedades de Journey
El objetojourney te permite hacer referencia al nombre del Journey o acceder a la personalización con Custom Events para el Journey.
journey.name
El nombre del Journey.
JSON
Propiedades de mensaje
El objetomessage 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.
message.id
El ID del mensaje establecido por OneSignal.
message.name
El nombre del mensaje establecido por ti, el remitente.
message.template_id
El ID de la plantilla establecido por OneSignal.
Propiedades de plantilla
El objetotemplate proporciona acceso al ID y nombre de la plantilla utilizada para enviar el mensaje. Esto puede ser útil para Event Streams.
template.id
El ID de la plantilla establecido por OneSignal.
template.name
El nombre de la plantilla establecido por ti, el remitente.
Propiedades de aplicación y organización
Los objetosapp y org proporcionan detalles sobre la aplicación y organización que envió el mensaje. Esto puede ser útil para Event Streams.
app.id
El ID de la aplicación establecido por OneSignal.
app.name
El nombre de la aplicación establecido por ti, el propietario de la aplicación.
org.id
El ID de la organización establecido por OneSignal.
org.name
El nombre de la organización establecido por ti, el propietario de la organización.
Ejemplo: Carrito abandonado con Tags
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:JSON
Plantilla de correo electrónico
Crear una nueva plantilla de correo electrónico
Navega a Mensajes > Templates > Nueva plantilla de correo electrónico y abre el editor de arrastrar y soltar.
Agregar la estructura de diseño
Crea cinco filas:
- Filas 1, 2 y 4: una columna con un bloque de Párrafo
- Fila 3: cuatro columnas con HTML | Párrafo | Párrafo | Párrafo
- Fila 5: una columna con un bloque de Botón

Agregar liquid a los bloques de párrafo
En la fila 1, agrega:En la fila 2, agrega una descripción de lo que el usuario está viendo:En la fila 4, agrega otra llamada a la acción:
Liquid
Text
Text
Mostrar el artículo más reciente
En la fila 3, configura las cuatro columnas:Columna 1 (bloque HTML):Columnas 2-4 (bloques de texto):
HTML
- Columna 2:
{{product_name}} - Columna 3:
{{product_quantity}} - Columna 4:
{{product_price}}
Agregar la URL del carrito al botón
En el bloque de Botón de la fila 5, establece la URL de acción a:

Probar y previsualizar la plantilla
Envía un correo electrónico de prueba a ti mismo usando el botón Probar y previsualizar.
- Asegúrate de que los tags estén configurados en tu suscripción de correo electrónico.

Aplicar estilos a la plantilla
Ahora puedes aplicar tus propios estilos a la plantilla. Consulta Diseñar correos electrónicos con arrastrar y soltar.
Plantilla push
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
Liquid

Ahora puedes crear más plantillas y usarlas en el Journey de carrito abandonado.
Páginas relacionadas
Personalización de mensajes
Resumen de todas las opciones de personalización en OneSignal, incluyendo cuándo usar Custom Events frente a otros métodos.
Tags
Aprende cómo configurar Tags en usuarios a través de SDK, API o importación CSV.
Uso de sintaxis Liquid
Referencia completa de Liquid con filtros, condicionales, bucles y manipulación de cadenas.
Templates
Crea y gestiona plantillas de mensajes reutilizables para usar en Journeys.
Ejemplos de mensajes in-app
Muestra mensajes in-app personalizados basados en Tags.
Tutorial de carrito abandonado
Construye un Journey de carrito abandonado usando Tags y propiedades.
¿Necesita ayuda?Chatee con nuestro equipo de Soporte o envíe un correo electrónico a
support@onesignal.comPor favor incluya:- Detalles del problema que está experimentando y pasos para reproducir si están disponibles
- Su ID de aplicación de OneSignal
- El ID externo o ID de suscripción si corresponde
- La URL del mensaje que probó en el panel de OneSignal si corresponde
- Cualquier registro o mensaje de error relevante