Personalización

​

Cómo funciona la personalización

• Feeds de datos: Datos en tiempo real desde tus APIs.
• Eventos personalizados: Eventos de usuario en tiempo real para personalizar mensajes de Journey.
• Propiedades y etiquetas: Valores integrados de usuario, journey, mensaje, plantilla, app u organización.
• API: custom_data: Datos personalizados que pasas directamente a nuestra API de Create Message.
• Contenido dinámico: Personalización basada en CSV a través de cargas del panel.

​

Consideraciones clave

• Agregar una propiedad de usuario como nombre o ID
• Mostrar factura o OTP
• Enviar contenido dinámico desde un CSV

• ¿Los datos están almacenados en OneSignal como una propiedad o una etiqueta?
• ¿Los datos están almacenados en tu propia base de datos?
• ¿Necesitas pasar datos desde tu backend a OneSignal?

• Mensajes únicos: ¿Enviar el mensaje desde tu servidor o a través del panel de OneSignal?
• Mensajes recurrentes: ¿Usando Journeys u otros flujos de trabajo automatizados?

• Objetivo: Enviar una contraseña de un solo uso para ayudar a un usuario a iniciar sesión.
• Datos:
  • OTP almacenado en tu backend.
  • Nombre de usuario almacenado en OneSignal como una etiqueta.
  • ID externo almacenado en OneSignal como una propiedad.
• Envío:
  • Desde tu servidor usando nuestra API REST.
  • Desde un flujo de trabajo automatizado usando Journeys.

​

Fuentes de datos

​

Contenido dinámico

​

Feeds de datos

​

Eventos personalizados

• Los Journeys activados por eventos almacenarán el evento que causó que el usuario entrara al Journey
• Cualquier Journey que use nodos Wait Until almacenará eventos personalizados cuando coincidan con una condición.

{% assign event = journey.first_event %}

{% assign event = journey.last_event %}

{% assign event = journey.event.purchase %}

{% assign event = journey.event["order status"] %}

{% for event in journey.all_events %}
  {{ event.name }}
{% endfor %}

​

Propiedades

​

Propiedades de usuario y suscripción

¡Hola {{ first_name | default: "amigo" }}!
¡Felicidades por alcanzar el nivel {{ level | default: "1" }}!

Tu ID de usuario es {{ subscription.external_id }}.

Gracias por suscribirte con el correo electrónico {{ subscription.email }}.

Gracias por suscribirte con el número de teléfono {{ subscription.phone_number }}.

Idioma preferido: {{ subscription.language }}

Cancelar suscripción: https://your-domain.com/unsubscribe?token={{ subscription.unsubscribe_token }}

​

Propiedades de Journey

{
  "journey.name": "{{ journey.name }}"
}

​

Propiedades de mensaje

{
  "message.id": "{{ message.id }}"
}

{
  "message.name": "{{ message.name }}"
}

{
  "message.template_id": "{{ message.template_id }}"
}

​

Propiedades de plantilla

{
  "template.id": "{{ template.id }}"
}

{
  "template.name": "{{ template.name }}"
}

​

Propiedades de OneSignal

{
  "app.id": "{{ app.id }}"
}

{
  "app.name": "{{ app.name }}"
}

{
  "org.id": "{{ org.id }}"
}

{
  "org.name": "{{ org.name }}"
}

​

API custom_data

1. Crea una plantilla
2. Usa sintaxis Liquid con el formato {{ message.custom_data.key }}
3. Envía una solicitud API con el objeto custom_data y template_id

​

Ejemplo: JSON plano

Tu factura para {{message.custom_data.product_name}} está lista.
URL: https://your-domain.com/invoice={{message.custom_data.invoice_id}}

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_TEMPLATE_ID",
  "include_email_tokens": ["THE_USER_EMAIL"],
  "custom_data": {
    "invoice_id": "463246732",
    "product_name": "Widget"
  }
}

​

Ejemplo: Datos de array

¡Tu {{message.custom_data.cart_items[0].item_name}} te está esperando!
Imagen: {{message.custom_data.cart_items[0].image_url}}

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_TEMPLATE_ID",
  "include_email_tokens": ["THE_USER_EMAIL"],
  "custom_data": {
    "cart_items": [
      {
        "item_name": "sweater",
        "img_url": "https://.../sweater.png"
      },{
        "item_name": "socks",
        "img_url": "https://.../socks.png"
      }
    ]
  }
}

​

Ejemplo: Personalización masiva

{% assign eid = message.custom_data.users[subscription.external_id] %}
Hola {{ eid.first_name }}, tienes {{ eid.points }} puntos. Tu nivel es {{ eid.level }}.

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user123", "user456"]
  },
  "custom_data": {
    "users": {
      "user123": { "first_name": "John", "points": "150", "level": "Gold" },
      "user456": { "first_name": "Sarah", "points": "200", "level": "Platinum" }
    }
  }
}

​

Tutoriales