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: 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

​

Dynamic Content

​

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

​

Properties

​

Propriedades de User & Subscription

Hi {{ first_name | default: "friend" }}!
Congrats on reaching level {{ level | default: "1" }}!

Your user ID is {{ subscription.external_id }}.

Thanks for subscribing with email {{ subscription.email }}.

Thanks for subscribing with phone number {{ subscription.phone_number }}.

Preferred language: {{ subscription.language }}

Unsubscribe: https://your-domain.com/unsubscribe?token={{ subscription.unsubscribe_token }}

​

Propriedades de Journey

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

​

Propriedades de Message

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

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

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

​

Propriedades de Template

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

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

​

Propriedades do OneSignal

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

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

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

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

​

API custom_data

1. Crie um template
2. Use Sintaxe Liquid com formato {{ message.custom_data.key }}
3. Envie solicitação de API com o objeto custom_data e template_id

​

Exemplo: JSON Plano

Your invoice for {{message.custom_data.product_name}} is ready.
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

Your {{message.custom_data.cart_items[0].item_name}} is waiting for you!
Image: {{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] %}
Hi {{ eid.first_name }}, you have {{ eid.points }} points. Your level is {{ 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" }
    }
  }
}

​

Tutoriais