Pular para o conteúdo principal
Acesse os dados do event stream usando sintaxe Liquid. Envolva qualquer campo em {{ }} para incluí-lo no corpo do Event Stream. Veja Exemplos.
Dados de mensagens para Jornadas e envios via API são retidos por 30 dias. Eventos de interação (cliques, aberturas, cancelamentos de inscrição) que ocorram após 30 dias podem ter propriedades de mensagem em branco. Para recuperar os dados, correlacione o message.id do evento de interação com o evento sent original, que contém os dados completos da mensagem.

​
Propriedades de event

Cada evento inclui os campos principais abaixo. Os campos específicos de canal em event.data.* são incluídos apenas quando aplicável — veja Campos específicos de canal.
​
event.kind
string
O tipo de evento, combinando canal e ação (ex.: message.push.clicked, message.email.bounced). Veja a lista completa de valores na referência de event kind abaixo. Liquid: {{ event.kind }}
​
event.id
UUID
Um identificador único gerado pelo OneSignal para cada evento individual no formato UUID v4. Use este ID para rastreamento de entrega idempotente. Para o identificador de mensagem ou template, use message.id ou message.template_id. Liquid: {{ event.id }}
​
event.timestamp
integer
Timestamp UNIX do evento. Liquid: {{ event.timestamp }}
​
event.datetime
string
Horário legível do evento em UTC como string ISO 8601 (ex.: “2024-02-21T23:45:15.228Z”). Liquid: {{ event.datetime }}
​
event.app_id
UUID
O App ID do OneSignal. Liquid: {{ event.app_id }}
​
event.subscription_device_type
string
O tipo de assinatura (ex.: iOS, Android, Chrome, Email, SMS). Liquid: {{ event.subscription_device_type }}
​
event.subscription_id
UUID
O Subscription ID do OneSignal. Liquid: {{ event.subscription_id }}
​
event.onesignal_id
UUID
O User ID do OneSignal. Liquid: {{ event.onesignal_id }}
​
event.external_id
string
Seu User ID definido como o alias de External ID do OneSignal. Pode estar vazio se não definido. Liquid: {{ event.external_id }}

​
Campos específicos de canal

Esses campos event.data.* estão presentes apenas para determinados tipos de evento.

​
Eventos de mensagem in-app

Incluídos com eventos message.iam.*. Veja Event Streams de mensagens in-app para detalhes.
​
event.data.page_name
string
O nome da página ou cartão da mensagem in-app exibido. Liquid: {{ event.data.page_name }}
​
event.data.page_id
string
Identificador único para a página ou cartão da mensagem in-app exibido. Liquid: {{ event.data.page_id }}
​
event.data.target_name
string
O nome do botão ou elemento de bloco de imagem clicado. O elemento deve conter uma ação de clique in-app. Liquid: {{ event.data.target_name }}
​
event.data.target_id
string
Identificador único para o botão ou elemento de bloco de imagem clicado. Liquid: {{ event.data.target_id }}

​
Eventos de Live Activity

Incluídos com eventos message.live_activity.*.
​
event.data.live_activity_id
string
Identificador único para uma Live Activity específica (ex.: “Knicks vs Cavs - Oct 22 7PM”). Liquid: {{ event.data.live_activity_id }}
​
event.data.live_activity_type
string
Rótulo de agrupamento para categorias de Live Activity (ex.: “Knicks_games”). Liquid: {{ event.data.live_activity_type }}

​
Eventos de falha

Incluídos com eventos message.push.failed e message.email.failed.
​
event.data.failure_reason
string
O motivo pelo qual a mensagem falhou ao ser enviada. Veja Relatórios de Mensagens Push ou Relatórios de Mensagens de Email para motivos comuns. Liquid: {{ event.data.failure_reason }}

​
Referência de event kind

Para definições detalhadas de cada métrica, veja o Glossário de Métricas.
Tipo de Evento de Mensagem (OneSignal)Nome do evento (no conjunto de dados)Descrição do Evento
Push Enviadomessage.push.sentNotificação push enviada com sucesso para os serviços push (FCM, APNS, etc).
Push Recebidomessage.push.receivedNotificação push recebida pelo destinatário. Não disponível em todas as plataformas. Veja Entrega Confirmada para mais detalhes.
Push Clicadomessage.push.clickedUsuário tocou na notificação push para abrir o aplicativo no dispositivo.
Push Falhoumessage.push.failedPush falhou ao ser enviado. Veja os Relatórios de Mensagens Push para detalhes.
Push Canceladomessage.push.unsubscribedUsuário cancelou inscrição de push assinatura. Veja Quando os status de assinatura push são atualizados?.
Impressão In-Appmessage.iam.impressionMensagem In-App exibida com sucesso no dispositivo.
In-App Clicadomessage.iam.clickedUsuário tocou em um elemento na Mensagem In-App.
Página In-App Exibidamessage.iam.page_displayedPágina da Mensagem In-App foi exibida. Útil para rastrear carrosséis.
Email Enviadomessage.email.sentEmail enviado com sucesso.
Email Recebidomessage.email.receivedEmail recebido pelo destinatário.
Email Abertomessage.email.openedEmail foi aberto pelo destinatário. Veja Relatórios de Mensagens de Email para detalhes.
Link de Email Clicadomessage.email.clickedUsuário tocou em um link no email.
Email Canceladomessage.email.unsubscribedUsuário cancelou inscrição de email via link de cancelamento de inscrição.
Email Reportado Como Spammessage.email.reported_as_spamUsuário reportou o email como spam. Gmail requer Google Postmaster Tools para rastrear. Veja Entregabilidade de email para mais detalhes.
Email Rejeitadomessage.email.bouncedEmail retornou ao remetente devido a erro permanente. Veja Relatórios de Mensagens de Email para detalhes.
Email Falhoumessage.email.failedEmail não pôde ser entregue. Veja Relatórios de Mensagens de Email para detalhes.
Email Suprimidomessage.email.suppressedEmail não pôde ser enviado porque o endereço de email está na Lista de supressão.
SMS Enviadomessage.sms.sentSMS enviado para destinatário.
SMS Falhoumessage.sms.failedSMS falhou ao enviar. Veja Relatórios de Mensagens SMS para detalhes.
SMS Entreguemessage.sms.deliveredSMS entregue com sucesso.
SMS Não Entreguemessage.sms.undeliveredSMS não pôde ser enviado. Veja Relatórios de Mensagens SMS para detalhes.
Live Activity Enviadamessage.live_activity.sentLive Activity enviada com sucesso para FCM/APNS.
Live Activity Entreguemessage.live_activity.deliveredLive Activity recebida pelo destinatário.
Live Activity Canceladamessage.live_activity.unsubscribedUsuário cancelou inscrição de Live Activities.
Live Activity Falhoumessage.live_activity.failedLive Activity falhou ao enviar.
Live Activity Clicadamessage.live_activity.clickedLive Activity clicada pelo usuário.

​
Exemplo de objeto de evento

Copie este template Liquid no corpo do seu Event Stream para capturar todos os campos de evento:
JSON
{
  "event.kind": "{{ event.kind }}",
  "event.id": "{{ event.id }}",
  "event.timestamp": "{{ event.timestamp }}",
  "event.datetime": "{{ event.datetime }}",
  "event.app_id": "{{ event.app_id }}",
  "event.subscription_device_type": "{{ event.subscription_device_type }}",
  "event.subscription_id": "{{ event.subscription_id }}",
  "event.onesignal_id": "{{ event.onesignal_id }}",
  "event.external_id": "{{ event.external_id }}",
  "event.data.page_name": "{{ event.data.page_name }}",
  "event.data.page_id": "{{ event.data.page_id }}",
  "event.data.target_name": "{{ event.data.target_name }}",
  "event.data.target_id": "{{ event.data.target_id }}",
  "event.data.failure_reason": "{{ event.data.failure_reason }}"
}
Como um evento de clique em push fica após a renderização Liquid:
JSON
{
  "event.kind": "message.push.clicked",
  "event.id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "event.timestamp": 1708559115,
  "event.datetime": "2024-02-21T23:45:15.228Z",
  "event.app_id": "your-onesignal-app-id",
  "event.subscription_device_type": "iOS",
  "event.subscription_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "event.onesignal_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "event.external_id": "user_12345",
  "event.data.page_name": "",
  "event.data.page_id": "",
  "event.data.target_name": "",
  "event.data.target_id": "",
  "event.data.failure_reason": ""
}
Campos específicos de canal como event.data.page_name ficam vazios para tipos de evento que não os incluem.

​
Propriedades de message

O objeto message descreve a mensagem enviada ao usuário final, incluindo seu ID, template, conteúdo e URLs.
​
message.id
UUID
O ID da mensagem gerado pelo OneSignal. Liquid: {{ message.id }}
​
message.name
string
O nome da mensagem conforme definido no dashboard ou usando a propriedade name da API. Liquid: {{ message.name }}
​
message.title
object
O título da mensagem push ou assunto do email. Para push, retorna um objeto localizado como {'en':'Your title'}. Para email, retorna a linha de assunto como string simples. Definido via dashboard ou propriedades headings / email_subject da API. Liquid: {{ message.title }}
​
message.contents
object
O conteúdo da mensagem push ou SMS (cortado em 50 caracteres). O conteúdo de email (email_body) não é fornecido. Definido via dashboard ou propriedade contents da API. Liquid: {{ message.contents }}
​
message.template_id
UUID
O ID do template para uma mensagem enviada via Jornadas ou a propriedade template_id da API. Liquid: {{ message.template_id }}
​
message.url
string
A URL de lançamento da mensagem ao usar uma única URL agnóstica de web e app. Veja URLs, Links e Deep Links. Liquid: {{ message.url }}
​
message.app_url
string
A URL de lançamento específica do app ao usar URLs separadas de web e app. Veja URLs, Links e Deep Links. Liquid: {{ message.app_url }}
​
message.web_url
string
A URL de lançamento específica da web ao usar URLs separadas de web e app. Veja URLs, Links e Deep Links. Liquid: {{ message.web_url }}
​
message.live_activity_event_kind
string
O tipo de ação da Live Activity: start, update ou end. Presente apenas para eventos message.live_activity.*. Liquid: {{ message.live_activity_event_kind }}

​
Exemplo de objeto de mensagem

Copie este template Liquid no corpo do seu Event Stream para capturar todos os campos de mensagem:
JSON
{
  "message.id": "{{ message.id }}",
  "message.name": "{{ message.name }}",
  "message.title": "{{ message.title }}",
  "message.contents": "{{ message.contents }}",
  "message.template_id": "{{ message.template_id }}",
  "message.url": "{{ message.url }}",
  "message.app_url": "{{ message.app_url }}",
  "message.web_url": "{{ message.web_url }}"
}
Uma mensagem de notificação push:
JSON
{
  "message.id": "f3c9cd09-10d7-4f59-b9bc-66e16607f1d5",
  "message.name": "weekly-promo-push",
  "message.title": "{'en':'Flash Sale: 50% Off Today'}",
  "message.contents": "{'en':'Shop now and save on select items'}",
  "message.template_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message.url": "https://example.com/sale",
  "message.app_url": "",
  "message.web_url": ""
}
Uma mensagem de email — message.title é a linha de assunto como string simples, e message.contents está vazio pois o conteúdo do corpo do email não é incluído nos dados do Event Stream:
JSON
{
  "message.id": "e2d3c4b5-a6f7-8901-bcde-f12345678901",
  "message.name": "onboarding-welcome-email",
  "message.title": "Welcome to Acme — here's how to get started",
  "message.contents": "",
  "message.template_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "message.url": "",
  "message.app_url": "",
  "message.web_url": ""
}

​
Propriedades de user

O objeto user contém dados em nível de perfil do usuário que recebeu a mensagem.
​
user.onesignal_id
string
O OneSignal ID do usuário. Liquid: {{ user.onesignal_id }}
​
user.external_id
string
O External ID do usuário. Liquid: {{ user.external_id }}
​
user.tags
object
As tags do usuário. Acesse o objeto completo com {{ user.tags }} ou uma tag específica com {{ user.tags.your_tag }}. Use um padrão para lidar com tags ausentes: {{ user.tags.your_tag | default: '' }}.
​
user.language
string
O código de idioma do usuário. Liquid: {{ user.language }}

​
Propriedades de subscription

Essas propriedades descrevem a assinatura que recebeu a mensagem.
​
user.subscription.id
string
O OneSignal ID da assinatura. Liquid: {{ user.subscription.id }}
​
user.subscription.app_id
string
O OneSignal App ID. Liquid: {{ user.subscription.app_id }}
​
user.subscription.subscription_token
string
O token específico de plataforma da assinatura. Para Email, é o endereço de email. Para SMS, um número de telefone no formato E.164. Para Push, o token de push. Liquid: {{ user.subscription.subscription_token }}
​
user.subscription.session_count
number
Total de sessões registradas para esta assinatura. Liquid: {{ user.subscription.session_count }}
​
user.subscription.language
string
O código de idioma definido na assinatura. Liquid: {{ user.subscription.language }}
​
user.subscription.game_version
string
A versão do app ou jogo reportada pela assinatura. Liquid: {{ user.subscription.game_version }}
​
user.subscription.last_active
number
Timestamp UNIX da sessão mais recente da assinatura. Liquid: {{ user.subscription.last_active }}
​
user.subscription.play_time
number
Tempo total de jogo registrado para esta assinatura, em segundos. Liquid: {{ user.subscription.play_time }}
​
user.subscription.amount_spent
number
Valor total de compras in-app registrado para esta assinatura. Liquid: {{ user.subscription.amount_spent }}
​
user.subscription.created_at
number
Timestamp UNIX de quando a assinatura foi criada. Liquid: {{ user.subscription.created_at }}
​
user.subscription.subscribed
boolean
Se a assinatura está atualmente optada. Liquid: {{ user.subscription.subscribed }}
​
user.subscription.sdk
string
A versão do OneSignal SDK no dispositivo da assinatura. Liquid: {{ user.subscription.sdk }}
​
user.subscription.device_model
string
O modelo de hardware do dispositivo (ex.: “iPhone14,2”, “Pixel 7”). Liquid: {{ user.subscription.device_model }}
​
user.subscription.device_os
string
O sistema operacional e versão do dispositivo (ex.: “iOS 17.2”, “Android 14”). Liquid: {{ user.subscription.device_os }}

​
Páginas relacionadas

Event Streams

Configure o Event Streams, incluindo setup, templates de corpo e depuração.

Usando sintaxe Liquid

Referência da sintaxe Liquid usada para personalizar corpos de Event Stream.

Event Streams de mensagens in-app

Detalhes sobre dados de eventos de mensagens in-app e rastreamento de carrossel.

Glossário de Métricas

Definições de todas as métricas de eventos de mensagem entre canais.

​
FAQ

​
Por que alguns dados de evento estão ausentes ou em branco?

Dados de mensagens para Jornadas e envios via API são retidos por 30 dias. Se um usuário interagir com uma mensagem (clique, abertura, cancelamento de inscrição) mais de 30 dias após o envio, as propriedades de mensagem associadas podem estar em branco. Para contornar isso, correlacione o message.id do evento de interação com o evento sent original, que contém os dados completos da mensagem.

​
Qual é a diferença entre event.id e message.id?

event.id é um identificador único para o evento individual (ex.: um clique específico). message.id é o identificador da mensagem que foi enviada — múltiplos eventos podem compartilhar o mesmo message.id (por exemplo, um evento sent e um evento clicked para a mesma notificação push).

​
Qual é o formato de message.title para push vs email?

Para notificações push, message.title retorna um objeto localizado como {'en':'Your title'}. Para email, retorna a linha de assunto como string simples. O formato depende do canal.

​
Eventos Personalizados são incluídos no Event Streams?

Não. O Event Streams contém eventos de mensagem (enviado, clicado, aberto, rejeitado, etc.) — não Eventos Personalizados. Eventos Personalizados são ações do usuário que você envia para o OneSignal. O Event Streams exporta dados de entrega e engajamento de mensagens do OneSignal.

​
Como faço referência a uma tag específica no corpo do meu Event Stream?

Use {{ user.tags.your_tag_key }} com a chave de tag exata. Para evitar erros quando uma tag não está definida, adicione um padrão: {{ user.tags.your_tag_key | default: '' }}. Veja Usando sintaxe Liquid para mais detalhes.