Saltar al contenido principal
La personalización te permite enviar mensajes que incluyen datos dinámicos, como el nombre de un usuario, artículos del carrito, saldo de cuenta, detalles de reserva o una contraseña de un solo uso. Esta guía te ayuda a elegir el método de personalización adecuado según:
  • Dónde residen tus datos
  • Si deben persistir
  • Cómo se activa el mensaje

​
Cómo funciona la personalización

La personalización en OneSignal tiene dos partes:
  1. Sintaxis Liquid — define cómo se renderizan los valores en tu mensaje
  2. Una fuente de datos — determina de dónde proviene el valor
En el momento del envío, OneSignal resuelve tus variables Liquid usando la fuente de datos seleccionada.
Liquid controla el formato y la lógica (variables, bucles, condicionales). La fuente de datos determina qué valores están disponibles.
Ejemplo:
Liquid
Hi {{ user.tags.first_name }},

Your verification code is {{ message.custom_data.otp }}.
  • user.tags.first_name es una propiedad almacenada
  • message.custom_data.otp se pasa a través del campo custom_data de la API

​
Comparación de fuentes de datos

Si necesitas…
  • Reutilizar datos de usuario almacenados -> Properties
  • Personalizar dentro de un Journey basado en comportamiento -> Custom Events
  • Enviar valores únicos o sensibles -> API custom_data
  • Obtener datos en vivo del backend en el momento de la entrega -> Data Feeds
  • Cargar personalización masiva desde el panel de control -> Dynamic Content CSV
Errores comunes a evitar
  • Usar Properties (Tags) para valores de un solo uso como OTPs o códigos de verificación
  • Esperar que custom_data esté disponible en Journeys o mensajes futuros
  • Asumir que las propiedades de Custom Events están disponibles fuera de la entrada al Journey activada por el evento o un paso Wait Until
  • Usar Data Feeds para datos estáticos que rara vez cambian

​
Fuentes de datos

​
Data Feeds

Los Data Feeds llaman a tu API en el momento del envío e inyectan la respuesta en tu mensaje. Cuándo usar Data Feeds:
  • Necesitas el valor más reciente en el momento de la entrega
  • Los datos residen en tu backend
  • El valor puede cambiar entre envíos

Data Feeds

Obtén datos en tiempo real del backend en los mensajes en el momento del envío.

​
Custom Events

Los Custom Events pueden personalizar mensajes dentro de Journeys usando propiedades de eventos. Cuando un evento inicia un Journey o coincide con una condición Wait Until, OneSignal almacena ese evento para que sus propiedades puedan ser referenciadas en las plantillas de mensajes usando Liquid. Cuándo usar Custom Events:
  • Mensajes activados por eventos con Journeys
  • El mensaje debe reflejar datos específicos del evento
Solo los eventos que activan la entrada al Journey o un paso Wait Until se almacenan para personalización. Los eventos enviados fuera de esos momentos no están disponibles para los mensajes del Journey.

Personalización con Custom Events

Guía completa para usar propiedades de eventos en Journeys.

​
Properties

Las Properties incluyen Tags de usuario, External ID, datos de subscription y campos a nivel de app. Son: Usa Properties cuando:
  • El valor existe en OneSignal
  • El valor es persistente
  • Lo reutilizas en distintas campañas

Personalizar con Properties

Aprende a referenciar datos de propiedades persistentes almacenados.

​
API custom_data

El campo custom_data en la API de Create Message te permite enviar valores específicos por mensaje desde tu backend. Estos datos:
  • Existen solo para la solicitud actual
  • No se almacenan en OneSignal
  • No están disponibles en Journeys
Usa custom_data cuando:
  • Envías valores de un solo uso o sensibles (OTP, enlaces seguros)
  • Pasas arrays (artículos del carrito, líneas de pedido, puntuaciones de tabla de clasificación)
  • Envías mensajes transaccionales o activados por API

Personalizar con API custom_data

Aprende a pasar datos de personalización transitorios.

​
Dynamic Content CSV

Carga un archivo CSV en el panel de control de OneSignal y referencia sus valores usando Liquid. Usa CSV cuando:
  • Personalizas diferentes secciones de una campaña masiva para cada destinatario
  • Las traducciones o datos personalizados para cada destinatario son exportables a un archivo CSV
  • No quieres usar la API

Dynamic Content CSV

Personaliza campañas del panel de control usando cargas de CSV.

​
Guías detalladas

Usa las guías a continuación para obtener detalles de implementación paso a paso y ejemplos avanzados.

Uso de la sintaxis Liquid

Aprende a insertar datos dinámicos en los mensajes usando Liquid. Cubre variables, condicionales, bucles, filtros, formato y patrones comunes de personalización.

Data Feeds

Obtén datos en tiempo real de tus propias APIs en el momento del envío. Usa Data Feeds cuando el contenido del mensaje dependa de valores en vivo del backend como saldos, disponibilidad o precios.

Personalización con Custom Events

Personaliza mensajes de Journey usando propiedades de eventos capturadas cuando los usuarios entran o avanzan a través de un Journey. Ideal para flujos de trabajo basados en comportamiento y eventos.

Properties y Tags

Usa propiedades almacenadas de usuario, subscription, mensaje y app para personalizar contenido en mensajes, plantillas, Journey webhooks y Event Streams.

API custom_data

Pasa datos por mensaje y transitorios desde tu backend usando la API de Create Message. Ideal para OTPs, carritos, arrays y personalización transaccional masiva.

Dynamic Content CSV

Carga archivos CSV en el panel de control para personalizar campañas a escala. Cada fila se asigna a un destinatario y puede referenciarse usando Liquid.

​
Tutoriales

Estas guías muestran cómo implementar la personalización en la práctica.

Verificación, Magic Link y OTP

Envía mensajes de verificación seguros usando contraseñas de un solo uso, magic links o URLs personalizadas con personalización basada en API.

Journey de carrito abandonado

Crea un Journey automatizado que detecta actividad del carrito, espera inactividad, envía un recordatorio personalizado y retira al usuario inmediatamente después de la compra.

Confirmaciones de reserva

Envía mensajes de confirmación y recuperación de reservas usando Custom Events, Journeys y Data Feeds basados en el estado de la reserva en tiempo real.

Mensajes transaccionales

Aprende a enviar recibos, alertas, confirmaciones y otros mensajes transaccionales a través de canales usando APIs y automatización.

Ejemplos de personalización in-app

Consulta ejemplos prácticos del uso de tags y propiedades para personalizar mensajes in-app para diferentes usuarios y segmentos.