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

# Application d'exemple : tags, événements personnalisés et Conversion Metrics

> Comment l'application d'exemple Clean Beans utilise les tags pour l'état actuel, les événements personnalisés pour les actions et les Conversion Metrics pour mesurer l'effet des messages.

Cette page fait partie de [Application d'exemple : une intégration OneSignal complète](https://documentation.onesignal.com/docs/fr/example-full-integration-overview.md), qui suit une application réelle de bout en bout. L'application s'appelle **Clean Beans**, un planning de ménage pour les logements partagés, construite avec Expo (React Native) et un backend Supabase.

L'identité indique à OneSignal qui est une personne. Les tags et les événements lui indiquent comment elle est et ce qu'elle fait. Clean Beans utilise trois types de données, chacun pour une tâche différente.

| Données | Décrivent | Servent à |
| - | - | - |
| **Tags** | L'état actuel de l'utilisateur | Personnaliser les messages et créer des segments |
| **Événements personnalisés** | Une action que l'utilisateur vient d'effectuer | Déclencher des Journeys et mesurer les conversions |
| **Conversion Metrics** | Les messages qui ont mené à un événement | Rendre compte de ce que vos messages accomplissent |

## Tags : l'état actuel de l'utilisateur \\

Après la connexion, après chaque session de ménage et après une modification du profil, l'application récupère quelques informations dans Supabase et les écrit sous forme de 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 | Exemple | Usage courant |
| - | - | - |
| `user_name` | `George` | Salutation dans les messages in-app et les e-mails |
| `streak_count` | `5` | Segments comme « série en cours » |
| `last_clean_ts` | `1720454400` | Segments comme « inactif depuis 7 jours », avec les [opérateurs temporels](https://documentation.onesignal.com/docs/fr/time-operators.md) |
| `last_room_cleaned` | `Kitchen` | Textes personnalisés |
| `avatar_filename` | `baked_bean.png` | Afficher l'avatar de l'utilisateur dans un message |
| `household_name` | `The Smiths` | Textes personnalisés |
| `weekly_leader` | `George` | Messages de classement |

> [!NOTE]
>
> Les valeurs des tags sont des chaînes. Stockez les horodatages en secondes Unix afin que les opérateurs temporels de OneSignal puissent les comparer.

## Événements personnalisés : ce qui vient de se passer \\

L'application enregistre un événement au début d'une session de ménage et un autre à la fin.

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

L'événement de fin contient deux nombres, `tasks_completed` et `minutes_cleaned`. Ils sont envoyés sous forme de nombres et non de chaînes, car les Conversion Metrics ne peuvent additionner qu'une propriété que OneSignal a reçue comme nombre.

L'écran de session déclenche l'événement et actualise les tags au moment où l'utilisateur confirme ce qu'il a nettoyé.

```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 : ce que vos messages ont accompli \\

Une Conversion Metric compte un événement personnalisé et l'attribue aux messages qui l'ont précédé. Avec l'événement ci-dessus, Clean Beans peut voir combien de sessions de ménage chaque rappel a générées et combien de minutes de ménage cela représente.

![Un rapport de message OneSignal montrant les métriques de conversion des sessions de ménage](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-conversion-metrics.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=fbb4363265a1b330198afdc0a37feefd)

Un rapport de message push montrant les sessions de ménage et les minutes qui lui sont attribuées.

**Configuration du tableau de bord.** Accédez à **Settings > Analytics > Conversion Metrics** et créez une métrique par ligne.

| Nom de la métrique | Événement personnalisé | Suivre une valeur | Propriété |
| - | - | - | - |
| Cleaning sessions | `cleaning_session_completed` | Non | |
| Minutes cleaned | `cleaning_session_completed` | Oui | `minutes_cleaned` |
| Tasks completed | `cleaning_session_completed` | Oui | `tasks_completed` |

> [!WARNING]
>
> L'option « Track a value for each event » n'apparaît qu'une fois que l'événement est arrivé avec une propriété de type nombre, et elle ne peut être activée qu'à la création de la métrique. Envoyez d'abord l'événement depuis une vraie session, vérifiez qu'il est arrivé dans **Data > Events & Conversions**, puis créez les deux métriques de valeur.

> [!NOTE]
>
> Les Conversion Metrics remplacent les Custom Outcomes (`OneSignal.Session.addOutcome()`), qui sont en cours d'abandon. Clean Beans prévoyait au départ d'utiliser les Outcomes et a changé avant de les mettre en place. Les métriques personnalisées nécessitent une offre payante. Les clics et les sessions d'application sont suivis sur toutes les offres.

> [card] [Tags](https://documentation.onesignal.com/docs/fr/add-user-data-tags.md)
>
> Ajouter, supprimer et utiliser des tags.

> [card] [Événements personnalisés](https://documentation.onesignal.com/docs/fr/custom-events.md)
>
> Envoyer des événements depuis le SDK ou votre backend.

> [card] [Métriques de conversion](https://documentation.onesignal.com/docs/fr/conversion-metrics.md)
>
> Fenêtres d'attribution et rapports.


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