Pular para o conteúdo principal
Esta página faz parte de Aplicativo de exemplo: uma integração completa do OneSignal, que acompanha um aplicativo real do início ao fim. O aplicativo é o Clean Beans, uma escala de limpeza para casas compartilhadas, construído com Expo (React Native) e um backend Supabase. A identidade diz ao OneSignal quem é uma pessoa. Tags e eventos dizem como ela é e o que ela faz. O Clean Beans usa três tipos de dados, cada um para uma tarefa diferente.

Tags: o estado atual do usuário \

Após o login, após cada sessão de limpeza e após uma edição de perfil, o aplicativo coleta alguns dados do Supabase e os grava como tags.
src/lib/onesignalSync.ts
Os valores de tags são strings. Armazene timestamps em segundos Unix para que os operadores de tempo do OneSignal possam compará-los.

Eventos personalizados: o que acabou de acontecer \

O aplicativo registra um evento quando uma sessão de limpeza começa e outro quando termina.
src/lib/onesignalSync.ts
src/lib/onesignalSync.ts
O evento de conclusão carrega dois números, tasks_completed e minutes_cleaned. Eles são enviados como números, não como strings, porque o Conversion Metrics só consegue somar uma propriedade que o OneSignal recebeu como número. A tela da sessão dispara o evento e atualiza as tags no momento em que o usuário confirma o que limpou.
app/clean-session.tsx

Conversion Metrics: o que suas mensagens alcançaram \

Uma Conversion Metric conta um evento personalizado e o atribui às mensagens que vieram antes dele. Com o evento acima, o Clean Beans consegue ver quantas sessões de limpeza cada lembrete gerou e quantos minutos de limpeza isso somou.
Um relatório de mensagem do OneSignal mostrando métricas de conversão de sessões de limpeza

Um relatório de mensagem push mostrando as sessões de limpeza e os minutos atribuídos a ela.

Configuração do painel. Acesse Settings > Analytics > Conversion Metrics e crie uma métrica por linha.
A opção “Track a value for each event” só aparece depois que o evento chega com uma propriedade do tipo número, e ela só pode ser ativada quando a métrica é criada. Envie primeiro o evento a partir de uma sessão real, verifique se ele chegou em Data > Events & Conversions e depois crie as duas métricas de valor.
O Conversion Metrics substitui os Custom Outcomes (OneSignal.Session.addOutcome()), que estão sendo descontinuados. O Clean Beans planejava originalmente usar Outcomes e mudou antes de implementar. Métricas personalizadas exigem um plano pago. Cliques e sessões do aplicativo são rastreados em todos os planos.

Tags

Adicione, remova e use tags.

Eventos personalizados

Envie eventos a partir do SDK ou do seu backend.

Métricas de conversão

Janelas de atribuição e relatórios.