Personalização

​

Como funciona a personalização

• Data feeds: Dados em tempo real de suas APIs.
• Custom Events: Eventos de usuário em tempo real para personalizar mensagens de Journey.
• Properties & Tags: Valores integrados de usuário, Journey, mensagem, template, aplicativo ou organização.
• API: custom_data: Dados personalizados que você passa diretamente para nossa API Create Message.
• Dynamic content com CSV: Personalização baseada em CSV via uploads no painel.

​

Considerações principais

• Adicionar uma propriedade de usuário como nome ou ID
• Mostrar fatura ou OTP
• Enviar conteúdo dinâmico de um CSV

• Os dados estão armazenados no OneSignal como uma propriedade ou tag?
• Os dados estão armazenados no seu próprio banco de dados?
• Você precisa passar dados do seu backend para o OneSignal?

• Mensagens únicas: Enviar a mensagem do seu servidor ou através do painel OneSignal?
• Mensagens recorrentes: Usando Journeys ou outros fluxos de trabalho automatizados?

• Objetivo: Enviar uma senha de uso único para ajudar um usuário a fazer login.
• Dados:
  • OTP armazenado no seu backend.
  • Nome de usuário armazenado no OneSignal como uma tag.
  • External ID armazenado no OneSignal como uma propriedade.
• Envio:
  • Do seu servidor usando nossa API REST.
  • De um fluxo de trabalho automatizado usando Journeys.

​

Fontes de dados

​

Data feeds

​

Custom Events

• Journeys acionadas por evento armazenarão o evento que causou a entrada do usuário na Journey
• Qualquer Journey usando nós Wait Until armazenará Custom Events quando eles corresponderem a uma condição.

{% 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 %}

{
  "events": [
    {
      "external_id": "user_12345",
      "timestamp": "2025-10-21T19:09:32.263Z",
      "name": "purchase",
      "properties": {
        "item": "T-shirt",
        "size": "small",
        "color": "blue",
        "price": 24.99
      }
    }
  ]
}

{{ journey.first_event.name }}

{{ journey.event.purchase.properties.item }}

{{ journey.last_event.timestamp | default: "now" | date: "%Y-%m-%d %H:%M" }}

{{ journey.last_event.properties["order status"] }}

Confira {{ journey.first_event.properties.item }} novamente!

Ainda pensando nisso? Pegue seu {{ journey.first_event.properties.item }} hoje por ${{ journey.first_event.properties.price }}.

{% if journey.last_event.properties.color == "blue" %}
  Não se esqueça — ainda temos na sua cor favorita!
{% else %}
  Seu item está esperando por você.
{% endif %}

{{ journey.last_event.properties.item | default: "seu item" }}

{% for event in journey.all_events %}
  • {{ event.properties.item }} - ${{ event.properties.price }}
{% endfor %}

​

Properties

​

Properties de User & Subscription

Olá {{ first_name | default: "amigo" }}!
Parabéns por atingir o nível {{ level | default: "1" }}!

Seu ID de usuário é {{ subscription.external_id }}.

Obrigado por se inscrever com o e-mail {{ subscription.email }}.

Obrigado por se inscrever com o número de telefone {{ subscription.phone_number }}.

Idioma preferido: {{ subscription.language }}

Cancelar inscrição: https://your-domain.com/unsubscribe?token={{ subscription.unsubscribe_token }}

{
  "external_id": "{{ user.external_id }}"
}

{
  "onesignal_id": "{{ user.onesignal_id }}"
}

{
  "language": "{{ user.language }}"
}

{
  "tags": "{% for tag in user.tags %}{{ tag[0] }}: {{ tag[1] }}{% unless forloop.last %}, {% endunless %}{% endfor %}"
}

{
  "subscriptions": "{% for subscription in user.subscriptions %}{% if subscription.subscription_token %}{{ subscription.subscription_token }}: {{ subscription.id }}{% unless forloop.last %}, {% endunless %}{% endif %}{% endfor %}"
}

​

Properties de Journey

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

​

Properties de Message

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

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

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

​

Properties de Template

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

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

​

Properties do OneSignal

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

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

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

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

​

API custom_data

1. Criar um template
2. Usar sintaxe Liquid com formato {{ message.custom_data.key }}
3. Enviar requisição de API com o objeto custom_data e template_id

​

Exemplo: JSON plano

Sua fatura para {{message.custom_data.product_name}} está pronta.
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"
  }
}

​

Exemplo: Dados de array

Seu {{message.custom_data.cart_items[0].item_name}} está esperando por você!
Imagem: {{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"
      }
    ]
  }
}

​

Exemplo: Personalização em massa

{% assign eid = message.custom_data.users[subscription.external_id] %}
Olá {{ eid.first_name }}, você tem {{ eid.points }} pontos. Seu nível é {{ 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" }
    }
  }
}

​

Dynamic Content CSV

​

Tutoriais