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

# App de ejemplo: etiquetas, eventos personalizados y Conversion Metrics

> Cómo la app de ejemplo Clean Beans usa etiquetas para el estado actual, eventos personalizados para las acciones y Conversion Metrics para medir lo que logran los mensajes.

Esta página forma parte de [App de ejemplo: una integración completa de OneSignal](https://documentation.onesignal.com/docs/es/example-full-integration-overview.md), que sigue una app real de principio a fin. La app es **Clean Beans**, un turno de limpieza para hogares compartidos, creada con Expo (React Native) y un backend de Supabase.

La identidad le dice a OneSignal quién es alguien. Las etiquetas y los eventos le dicen cómo es y qué hace. Clean Beans usa tres tipos de datos, cada uno para una tarea distinta.

| Datos | Describen | Se usan para |
| - | - | - |
| **Etiquetas** | El estado actual del usuario | Personalizar mensajes y crear segmentos |
| **Eventos personalizados** | Algo que el usuario acaba de hacer | Activar Journeys y medir conversiones |
| **Conversion Metrics** | Qué mensajes llevaron a un evento | Informar de lo que logran tus mensajes |

## Etiquetas: el estado actual del usuario \\

Después de iniciar sesión, después de cada sesión de limpieza y después de editar el perfil, la app recopila algunos datos de Supabase y los escribe como etiquetas.

```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);
```

| Etiqueta | Ejemplo | Uso habitual |
| - | - | - |
| `user_name` | `George` | Saludo en mensajes in-app y emails |
| `streak_count` | `5` | Segmentos como "racha en curso" |
| `last_clean_ts` | `1720454400` | Segmentos como "inactivo durante 7 días", usando [operadores de tiempo](https://documentation.onesignal.com/docs/es/time-operators.md) |
| `last_room_cleaned` | `Kitchen` | Textos personalizados |
| `avatar_filename` | `baked_bean.png` | Mostrar el avatar del usuario en un mensaje |
| `household_name` | `The Smiths` | Textos personalizados |
| `weekly_leader` | `George` | Mensajes de clasificación |

> [!NOTE]
>
> Los valores de las etiquetas son cadenas. Guarda las marcas de tiempo como segundos Unix para que los operadores de tiempo de OneSignal puedan compararlas.

## Eventos personalizados: lo que acaba de pasar \\

La app registra un evento cuando empieza una sesión de limpieza y otro cuando 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),
});
```

El evento de sesión completada lleva dos números, `tasks_completed` y `minutes_cleaned`. Se envían como números, no como cadenas, porque Conversion Metrics solo puede sumar una propiedad que OneSignal haya visto como número.

La pantalla de sesión dispara el evento y actualiza las etiquetas en el momento en que el usuario confirma lo que ha limpiado.

```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: lo que lograron tus mensajes \\

Una métrica de conversión cuenta un evento personalizado y se lo atribuye a los mensajes que lo precedieron. Con el evento anterior, Clean Beans puede ver cuántas sesiones de limpieza generó cada recordatorio y cuántos minutos de limpieza sumaron.

![Un informe de mensaje de OneSignal que muestra métricas de conversión de sesiones de limpieza](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-conversion-metrics.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=fbb4363265a1b330198afdc0a37feefd)

Un informe de mensaje push que muestra las sesiones de limpieza y los minutos atribuidos a él.

**Configuración del panel.** Ve a **Configuración > Analíticas > Métricas de conversión** y crea una métrica por fila.

| Nombre de la métrica | Evento personalizado | Registrar un valor | Propiedad |
| - | - | - | - |
| Cleaning sessions | `cleaning_session_completed` | No | |
| Minutes cleaned | `cleaning_session_completed` | Sí | `minutes_cleaned` |
| Tasks completed | `cleaning_session_completed` | Sí | `tasks_completed` |

> [!WARNING]
>
> La opción "Track a value for each event" solo aparece una vez que el evento ha llegado con una propiedad de tipo numérico, y solo se puede activar al crear la métrica. Envía primero el evento desde una sesión real, comprueba que ha llegado en **Datos > Eventos y conversiones** y después crea las dos métricas de valor.

> [!NOTE]
>
> Conversion Metrics sustituye a Custom Outcomes (`OneSignal.Session.addOutcome()`), que están en proceso de retirada. Clean Beans planeaba usar Outcomes y cambió antes de construirlo. Las métricas personalizadas requieren un plan de pago. Los clics y las sesiones de la app se registran en todos los planes.

> [card] [Etiquetas](https://documentation.onesignal.com/docs/es/add-user-data-tags.md)
>
> Añade, elimina y usa etiquetas.

> [card] [Eventos personalizados](https://documentation.onesignal.com/docs/es/custom-events.md)
>
> Envía eventos desde el SDK o tu backend.

> [card] [Métricas de conversión](https://documentation.onesignal.com/docs/es/conversion-metrics.md)
>
> Ventanas de atribución e informes.


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