> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Aplicativo de exemplo: tags, eventos personalizados e Conversion Metrics

> Como o aplicativo de exemplo Clean Beans usa tags para o estado atual, eventos personalizados para ações e Conversion Metrics para medir o que as mensagens alcançam.

Esta página faz parte de [Aplicativo de exemplo: uma integração completa do OneSignal](https://documentation.onesignal.com/docs/pt-BR/example-full-integration-overview.md), 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.

| Dados | Descrevem | Usados para |
| - | - | - |
| **Tags** | O estado atual do usuário | Personalizar mensagens e criar segmentos |
| **Eventos personalizados** | Algo que o usuário acabou de fazer | Acionar Journeys e medir conversões |
| **Conversion Metrics** | Quais mensagens levaram a um evento | Relatar o que suas mensagens alcançam |

## 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.

```typescript src/lib/onesignalSync.ts theme={null}
// ── 5. Push tags to OneSignal ────────────────────────────
const tags: Record<string, string> = {
  user_name: profile.name || '',
  streak_count: String(profile.streak_count ?? 0),
  last_clean_ts: lastCleanTs,
  last_room_cleaned: lastRoomCleaned,
  avatar_filename: avatarFilename,
  household_name: householdName,
  weekly_leader: weeklyLeader,
};

OneSignal.User.addTags(tags);
```

| Tag | Exemplo | Uso típico |
| - | - | - |
| `user_name` | `George` | Saudação em mensagens in-app e emails |
| `streak_count` | `5` | Segmentos como "sequência em andamento" |
| `last_clean_ts` | `1720454400` | Segmentos como "inativo há 7 dias", usando [operadores de tempo](https://documentation.onesignal.com/docs/pt-BR/time-operators.md) |
| `last_room_cleaned` | `Kitchen` | Textos personalizados |
| `avatar_filename` | `baked_bean.png` | Mostrar o avatar do usuário em uma mensagem |
| `household_name` | `The Smiths` | Textos personalizados |
| `weekly_leader` | `George` | Mensagens de ranking |

> [!NOTE]
>
> 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.

```typescript src/lib/onesignalSync.ts theme={null}
OneSignal.User.trackEvent('cleaning_session_started', {
  external_id: ctx.external_id,
  user_name: ctx.user_name,
  household_name: ctx.household_name,
  room_name: roomName,
});
```

```typescript src/lib/onesignalSync.ts theme={null}
OneSignal.User.trackEvent('cleaning_session_completed', {
  external_id: ctx.external_id,
  user_name: ctx.user_name,
  household_name: ctx.household_name,
  room_name: roomName,
  tasks_completed: stats.tasksCompleted,
  minutes_cleaned: Math.round(stats.minutesCleaned),
});
```

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.

```typescript app/clean-session.tsx theme={null}
// Fire session completed custom event and sync updated tags to OneSignal
if (room) {
  trackSessionCompleted(room.name, { tasksCompleted: ids.length, minutesCleaned: mins }).catch(console.warn);
}
syncOneSignalTags();
```

## 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](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-conversion-metrics.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=fbb4363265a1b330198afdc0a37feefd)

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.

| Nome da métrica | Evento personalizado | Rastrear um valor | Propriedade |
| - | - | - | - |
| Cleaning sessions | `cleaning_session_completed` | Não | |
| Minutes cleaned | `cleaning_session_completed` | Sim | `minutes_cleaned` |
| Tasks completed | `cleaning_session_completed` | Sim | `tasks_completed` |

> [!WARNING]
>
> 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.

> [!NOTE]
>
> 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.

> [card] [Tags](https://documentation.onesignal.com/docs/pt-BR/add-user-data-tags.md)
>
> Adicione, remova e use tags.

> [card] [Eventos personalizados](https://documentation.onesignal.com/docs/pt-BR/custom-events.md)
>
> Envie eventos a partir do SDK ou do seu backend.

> [card] [Métricas de conversão](https://documentation.onesignal.com/docs/pt-BR/conversion-metrics.md)
>
> Janelas de atribuição e relatórios.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.