> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/kpi-definitions.md).

# Définitions des KPI

Définitions des KPI Wallet affichés dans les tableaux de bord Analytics de The Wallet Crew, comment chaque métrique est calculée et comment l’interpréter dans le temps.

Cette page définit chaque métrique utilisée dans les tableaux de bord Analytics afin que les données puissent être interprétées avec précision et comparées dans le temps.

## Métriques principales

Les métriques ci-dessous sont les principaux repères utilisés dans [tableaux de bord Analytics](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/analytics-dashboards.md).

| Métrique          | Formule                                                                                             | Où la trouver                                                                                                                           |
| ----------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| Cartes créées     | Cartes distinctes avec un `Carte:Créée` événement sur la période sélectionnée                       | [tableaux de bord Analytics](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/analytics-dashboards.md) tuiles de synthèse     |
| Cartes ajoutées   | Cartes distinctes dont le premier `Carte:Installée` se situe dans la période sélectionnée           | [tableaux de bord Analytics](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/analytics-dashboards.md) tuiles de synthèse     |
| Cartes retirées   | Cartes distinctes dont le nombre d'installations actives a atteint `0` dans la période sélectionnée | [tableaux de bord Analytics](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/analytics-dashboards.md) tuiles de synthèse     |
| Taux d'activation | `(Cartes ajoutées ÷ Cartes créées) × 100`                                                           | [tableaux de bord Analytics](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/analytics-dashboards.md) tableau de répartition |
| Taux d'attrition  | `(Cartes retirées ÷ Installations actives au début de la période) × 100`                            | Non affiché dans les tableaux de bord : calculez-le à partir des données exportées                                                      |

### Cartes créées

**Cartes créées** est le nombre total d'enregistrements de cartes créés dans la plateforme pendant la période sélectionnée.

Cette métrique mesure le volume de distribution. Comparez-la à **Cartes ajoutées** pour comprendre quelle part des cartes émises a atteint un Wallet.

### Cartes ajoutées

**Cartes ajoutées** est le nombre de cartes ajoutées pour la première fois à Apple Wallet ou Google Wallet pendant la période sélectionnée.

La formule correspond au nombre de cartes distinctes dont le tout premier `Carte:Installée` événement (`registrationInformation.totalRegistrationCount` est égal à `1`) se situe dans la période. Les réinstallations et les deuxièmes appareils ne sont pas comptés à nouveau. Pour le modèle de suivi complet, voir [Ce que The Wallet Crew suit](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/what-the-wallet-crew-tracks.md).

C’est le principal signal d’adoption. Une carte dans un Wallet peut recevoir des notifications, être scannée et apporter une valeur continue.

### Cartes retirées

**Cartes retirées** est le nombre de cartes entièrement retirées de tous les Wallets pendant la période sélectionnée.

La formule correspond au nombre de cartes distinctes dont le nombre d'installations actives (`registrationInformation.activeRegistrationCount`) a atteint `0` pendant la période.

Le retrait d’une carte d’un appareil ne compte pas comme un retrait si elle reste sur un autre appareil.

C’est le principal signal d’attrition. Suivez-le avec **Cartes ajoutées** pour comprendre l’évolution nette de la base de Wallet.

### Taux d'activation

**Taux d'activation** est la part des cartes créées qui ont été installées au moins une fois.

Exemple : `23 500 installées ÷ 28 400 créées = 82,7 % de taux d’activation`.

Cette métrique mesure l’efficacité de la distribution. Un taux faible signifie que des cartes sont créées mais n’atteignent pas les Wallets. Examinez le canal de distribution et les frictions dans le **Ajouter à Wallet** parcours.

### Taux d'attrition

**Taux d'attrition** est la part des détenteurs de cartes actives qui ont retiré leur carte pendant la période.

La formule est `(Cartes retirées ÷ Installations actives au début de la période) × 100`. Aucune tuile du tableau de bord n’affiche ce taux : calculez-le à partir des données exportées.

Une attrition élevée suit souvent une campagne au contenu non pertinent, ou l’expiration de la carte sans renouvellement. Analysez les pics en les confrontant au calendrier des campagnes.

## Autres tuiles

Autres tuiles (**Cartes mises à jour**, **Notifications envoyées**, **Liens ouverts**, **Codes QR scannés**, les **Inscriptions** tuiles) sont décrites dans [tableaux de bord Analytics](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/analytics-dashboards.md).

## Comprendre l’indicateur de variation

Chaque tuile KPI compare la période sélectionnée à la période équivalente précédente. Une **30 derniers jours** vue est comparée aux 30 jours précédents.

* Flèche verte vers le haut = amélioration par rapport à la période précédente
* Flèche rouge vers le bas = baisse par rapport à la période précédente

Pour **Cartes retirées**, une hausse est affichée en rouge, car une attrition plus élevée est un résultat moins favorable.

## FAQ

<details>

<summary><strong>Pourquoi le nombre de Cartes ajoutées n’augmente-t-il pas lorsqu’un client ajoute la carte à un deuxième téléphone ?</strong></summary>

**Cartes ajoutées** compte chaque carte une seule fois, lors de sa première installation. Un deuxième appareil, un nouveau téléphone ou une réinstallation génère un `Carte:Installée` événement mais ne compte pas à nouveau.

</details>

<details>

<summary><strong>Pourquoi le nombre de Cartes retirées ne correspond-il pas toujours aux simples événements de retrait ?</strong></summary>

Une carte n’est comptée comme retirée que lorsque son nombre d’installations actives atteint zéro. Si elle existe encore sur un autre appareil, elle n’est pas encore complètement désinstallée.

</details>

<details>

<summary><strong>Que signifie généralement un faible taux d’activation ?</strong></summary>

Cela signifie généralement que des cartes sont émises, mais que pas assez de personnes terminent l’ **Ajouter à Wallet** étape. Les premiers points à examiner sont la qualité du canal, la visibilité et les frictions dans le parcours d’installation.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/kpi-definitions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
