> 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/what-the-wallet-crew-tracks.md).

# Ce que The Wallet Crew suit

Comprenez quels événements Apple Wallet et Google Wallet The Wallet Crew suit, comment les installations de Carte sont comptabilisées, et où Apple et Google fixent des limites.

The Wallet Crew suit l’activité des Cartes via les événements générés à chaque moment significatif du cycle de vie de la Carte. Cette page explique ce qui est suivi, comment fonctionne le comptage des installations, et ce qui ne peut pas être suivi, ainsi que les règles des plateformes Apple et Google qui se cachent derrière ces limites.

## Ce qui est suivi

The Wallet Crew enregistre les événements du cycle de vie que les plateformes wallet exposent et que le flux de Carte peut générer de manière fiable. Certains événements décrivent la Carte elle-même, tandis que d'autres décrivent ce qui s'est passé sur un wallet ou un appareil.

### Création de Carte

Un enregistrement de Carte est créé dans The Wallet Crew lorsqu'une Carte est émise. Cela peut se produire via l'API, après la création du compte, lorsqu'une page de téléchargement crée la Carte pour un visiteur qui n'en a pas (`passCreation.flow`), ou via un connecteur.

Une Carte créée existe sur la plateforme même si personne ne l'a encore ajoutée à un wallet. La création montre l'émission. Elle ne confirme pas l'adoption.

### Installation de la Carte

La plateforme suit quand une Carte est ajoutée à un wallet. Le comptage des installations fonctionne différemment dans Apple Wallet et Google Wallet, car chaque fournisseur définit l'installation à sa manière.

* **Apple Wallet** suit chaque appareil individuellement. L'ajout de la même Carte à un iPhone et à une Apple Watch compte pour deux installations. Le passage à un nouveau téléphone crée aussi une nouvelle installation.
* **Google Wallet** suit l'installation par compte Google. Plusieurs appareils Android connectés au même compte comptent pour une seule installation.

Deux compteurs existent pour chaque Carte :

* **Installations actives** (`registrationInformation.activeRegistrationCount`) — diminue lorsque la Carte est retirée d'un wallet
* **Installations totales** (`registrationInformation.totalRegistrationCount`) — cumulatif et ne diminue jamais

Ces compteurs servent à des fins différentes. Les installations actives montrent combien de présences valides dans le wallet existent encore. Les installations totales montrent combien de fois la Carte a déjà été installée. Par exemple, une Carte qui est installée, retirée puis installée à nouveau a un total de 1, puis 1, puis 2, et un compteur actif de 1, puis 0, puis 1.

### Source d'installation

Lorsqu'un client appuie sur un **Ajouter au Wallet** bouton, The Wallet Crew capture le contexte source de cette action. Cela aide à relier l'adoption du wallet à la campagne ou à la page qui l'a déclenchée.

* **Média** — le canal de distribution (affiché comme **Canal** dans les tableaux de bord), comme l'e-mail, l'e-commerce ou le magasin
* **Tag** — tags personnalisés de campagne ou de segment
* **URL** — la page exacte où le bouton a été affiché
* **Hôte** — le domaine de cette page

Les données source ne sont pas disponibles lorsqu'une Carte est installée via un transfert d'appareil, un partage de téléphone ou d'autres mécanismes au niveau du système. Dans ces cas, la plateforme wallet termine l'installation sans renvoyer le contexte d'acquisition d'origine.

### Retrait de la Carte

The Wallet Crew suit quand une Carte est retirée d'un wallet. Chaque retrait diminue le nombre d'installations actives. Un `Carte:Uninstalled` événement est enregistré lorsque la Carte quitte son dernier appareil sur Apple Wallet ou Google Wallet, et son `registrationInformation.activeRegistrationCount` indique si la Carte est encore installée quelque part.

Lorsque le nombre d'installations actives atteint zéro dans les deux wallets, la Carte est entièrement désinstallée. Cela compte pour l'analyse du churn, car une Carte retirée d'un appareil peut encore rester active sur un autre. Voir `Carte:Uninstalled` dans la [référence des événements](#event-reference).

### Mises à jour envoyées

Chaque mise à jour push livrée à un appareil est enregistrée. Cela permet de consulter l'activité des mises à jour dans le temps et de comprendre à quelle fréquence le contenu de la Carte est rafraîchi.

### Scans

Chaque scan de code-barres est enregistré, y compris les données scannées et le type de scan. Cela rend l'historique des scans utile pour l'utilisation et la vérification opérationnelle.

### Notifications push envoyées

Chaque notification push envoyée à un appareil est enregistrée, y compris son contenu et le fournisseur de wallet. Cela confirme que la notification a été envoyée via la plateforme.

### Clics sur les liens

Les appuis sur les liens suivis à l'intérieur d'une Carte sont enregistrés avec la position du lien, le wallet, la langue et la destination. Voir [Mesurer les clics sur les liens dans les Cartes](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/measure-link-clicks.md).

## Référence des événements

Chaque événement est enregistré avec la Carte à laquelle il appartient. L'onglet Historique d'une Carte les répertorie (voir [Détails de la Carte](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/pass-details.md#history)), et les webhooks ainsi que l'API Insights les transmettent.

| Événement                                                                              | Ce que cela signifie                                                                                                                                                                                                                                             |
| -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Carte:Created`                                                                        | La Carte a été créée.                                                                                                                                                                                                                                            |
| `Carte:Updated`                                                                        | La Carte a été mise à jour.                                                                                                                                                                                                                                      |
| `Carte:Installed`                                                                      | La Carte a été ajoutée à un wallet.                                                                                                                                                                                                                              |
| `Carte:Uninstalled`                                                                    | La Carte a été retirée de son dernier appareil sur un wallet (Apple Wallet ou Google Wallet). Elle peut encore être installée sur l'autre wallet : `registrationInformation.activeRegistrationCount` est `0` uniquement lorsqu'aucun wallet ne la contient plus. |
| `Carte:UpdateSent`                                                                     | Une mise à jour de la Carte a été envoyée à Apple ou Google pour un appareil.                                                                                                                                                                                    |
| `Carte:NotificationSent`                                                               | Une notification a été envoyée à une Carte installée.                                                                                                                                                                                                            |
| `Carte:Scanned`                                                                        | La Carte a été scannée.                                                                                                                                                                                                                                          |
| `Carte:LinkOpened`                                                                     | Le titulaire a appuyé sur un lien suivi de la Carte.                                                                                                                                                                                                             |
| `Carte:IdentifiersChanged`                                                             | Une mise à jour a ajouté, modifié ou supprimé un identifiant.                                                                                                                                                                                                    |
| `Carte:MetadataChanged`                                                                | La valeur d'au moins une clé de métadonnées a changé.                                                                                                                                                                                                            |
| `Carte:CarteTypeChanged`                                                               | Une mise à jour a déplacé la Carte vers un autre modèle.                                                                                                                                                                                                         |
| `Carte:ThemeChanged`                                                                   | Une mise à jour a déplacé la Carte vers un autre thème, ou a supprimé son thème.                                                                                                                                                                                 |
| `Carte:StampApplied`, `Carte:GoalReached`, `Carte:StampsReset`                         | Mouvements de la carte de tampons.                                                                                                                                                                                                                               |
| `Avantage:Created`, `Avantage:Updated`, `Avantage:Deleted`, `Avantage:MovementApplied` | Avantages accordés à la Carte, modifiés, supprimés ou utilisés.                                                                                                                                                                                                  |

## Ce qui ne peut pas être suivi

{% hint style="warning" %}
Ce sont des décisions de confidentialité prises par Apple et Google pour protéger les clients, et non des limites de The Wallet Crew. Toutes les plateformes wallet sont confrontées aux mêmes contraintes.
{% endhint %}

Certains signaux semblent naturels à attendre, mais les fournisseurs de wallet ne les exposent pas. Lorsque la plateforme ne reçoit pas les données, elle ne peut pas les signaler ultérieurement.

| Ce à quoi l'on pourrait s'attendre             | Pourquoi ce n'est pas disponible                                                                                                                   |
| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| Ouvertures ou vues de Carte                    | Apple et Google ne signalent pas si un client a vu une Carte. Il n'existe pas d'équivalent du taux d'ouverture d'un e-mail pour les Cartes wallet. |
| Taux de clic des notifications push            | La livraison peut être confirmée. Le fait que le client ait appuyé sur la notification n'est signalé par aucune des deux plateformes.              |
| Activations déclenchées par la géolocalisation | Les déclencheurs de localisation s'exécutent sur l'appareil. L'appareil ne renvoie pas cette information à l'émetteur lorsque cela se produit.     |
| Nombre par appareil sur Google                 | Google suit l'installation par compte. Trois appareils Android sur un même compte comptent toujours pour une seule installation.                   |

## État de la Carte

L'état de la Carte (utilisée, expirée) est défini par le modèle : voir [Modèle d'état de la Carte](https://docs.thewalletcrew.io/developers-guides/fr/integration-guides/wallet/pass-lifecycle.md#pass-state-model).

## Utilisation de ces données

Les événements wallet suivis sont utiles pour le marketing, les opérations et les workflows CRM. Ils aident les équipes à agir sur des signaux réels du cycle de vie plutôt que sur des hypothèses.

* Déclenchez une mise à jour CRM lorsqu'une Carte est installée pour la première fois afin de confirmer l'opt-in wallet
* Identifiez les clients dont la Carte n'est plus installée (`activeRegistrationCount` est `0`) comme signal de churn
* Attribuez les installations au canal source avec **Média** et **Tag**
* Utilisez les événements de scan pour confirmer l'utilisation au point de vente
* Comparez quels liens à l'intérieur de la Carte sont appuyés, et suivez ce trafic jusqu'au site de destination

Pour les usages en aval, voir [Insights API](https://docs.thewalletcrew.io/developers-guides/fr/integration-guides/insights-api.md) pour les requêtes programmatiques et [Envoyer des événements wallet à vos outils](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/send-wallet-events-to-your-tools.md) pour une livraison en temps réel.


---

# 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/what-the-wallet-crew-tracks.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.
