> 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/interrogez-vos-donnees-api-insights.md).

# Interrogez vos données — API Insights

Le [tableau de bord des statistiques](broken://spaces/tJnneV8b22BGeGPcyzLG/pages/f6867ac1354ba3babf518fe33153a493bbd2663f) affiche visuellement les données du portefeuille. Le **API Insights** donne un accès programmatique à ces mêmes données, afin que les équipes puissent créer des tableaux de bord personnalisés, alimenter des outils de BI, lancer des analyses ad hoc ou automatiser le reporting.

{% hint style="info" %}
Aucun code n’est requis pour exporter les données. Le [Rapport](/guides-monitoring/fr/monitor/report.md) la page permet aux équipes d’exporter les données d’événements en CSV depuis le back office.
{% endhint %}

<details>

<summary><strong>Exemples concrets</strong></summary>

* Une équipe marketing compare le volume d’installations par `Medium` après une campagne CRM.
* Une équipe opérations suit les scans par magasin et surveille les tendances de désinstallation par programme.
* Une équipe BI importe les événements du portefeuille dans Tableau, Looker ou Power BI pour des rapports hebdomadaires.

</details>

## Qu’est-ce que l’API Insights ?

L’API Insights est une interface de requête pour les événements du portefeuille stockés sur la plateforme The Wallet Crew. Chaque événement suivi peut être interrogé, y compris les créations de Carte, les installations, les désinstallations, les scans, les notifications et les mises à jour. C’est le bon choix lorsque le tableau de bord du back office ne suffit pas, par exemple pour des plages de dates personnalisées, des regroupements personnalisés, l’ingestion BI ou des rapports automatisés.

## Ce que vous pouvez interroger

L’API Insights couvre les mêmes événements opérationnels utilisés pour le suivi et le reporting. Chaque événement répond à une question métier différente.

| Événement                | Ce qu’il capture                                                                                                                    | Exemple de question à laquelle vous pouvez répondre                           |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| `Carte:Created`          | Quand un enregistrement de Carte a été créé                                                                                         | Combien de cartes ont été émises ce mois-ci par magasin ?                     |
| `Carte:Installed`        | Lorsqu’un Carte a été ajouté à Apple Wallet ou Google Wallet, avec des données sources telles que `Medium`, `Tag`, `URL`, et `Host` | Quelle campagne e-mail a généré le plus d’installations la semaine dernière ? |
| `Carte:Uninstalled`      | Lorsqu’une Carte a été entièrement supprimée de tous les portefeuilles                                                              | Quel est le taux de désinstallation par programme ?                           |
| `Carte:Updated`          | Lorsque les données de la Carte ont été modifiées                                                                                   | Combien de cartes ont été mises à jour après la dernière campagne ?           |
| `Carte:UpdateSent`       | Lorsqu’une mise à jour push a été envoyée à un appareil                                                                             | Les mises à jour atteignent-elles les appareils de manière fiable ?           |
| `Carte:Scanned`          | Lorsqu’un code-barres de Carte a été scanné                                                                                         | Combien de scans par jour ont eu lieu dans chaque emplacement ?               |
| `Carte:NotificationSent` | Lorsqu’une notification push a été envoyée                                                                                          | Combien de notifications ont été envoyées par programme ce mois-ci ?          |

## Filtres disponibles

Toutes les requêtes prennent en charge le filtrage par plage de dates, modèle de carte, type d’événement et source d’installation. Les filtres de source incluent `Medium`, `Tag`, `URL`, et `Host`.

Tout champ de métadonnées de Carte peut également être utilisé comme filtre. Cela inclut des champs métier tels que `storeId`, `programmeId`, la région ou toute métadonnée personnalisée stockée sur la Carte.

## Son lien avec le tableau de bord des statistiques

{% hint style="info" %}
Le **Statistiques** le tableau de bord est construit sur l’API Insights. Tout ce qui est visible dans le tableau de bord peut aussi être interrogé directement via l’API, avec davantage de flexibilité sur les regroupements, les filtres et les plages de dates.
{% endhint %}

Pour une vue sans code des mêmes données, utilisez la [tableau de bord des statistiques](broken://spaces/tJnneV8b22BGeGPcyzLG/pages/f6867ac1354ba3babf518fe33153a493bbd2663f). Pour envoyer des événements vers des outils externes en temps réel, consultez [Envoyer les événements du portefeuille vers vos outils](/guides-monitoring/fr/monitor/sync-pass-installation-status-to-your-crm.md).

## Prise en main

La façon la plus rapide est de s’authentifier, d’examiner les endpoints disponibles et d’exécuter une première requête d’agrégation.

{% stepper %}
{% step %}

### 1. Authentifiez-vous

Utilisez la clé API dans le `X-API-KEY` en-tête.

```http
X-API-KEY: <API_KEY>
```

{% endstep %}

{% step %}

### 2. Explorez les endpoints disponibles

Utilisez la [référence de l’API Insights](https://github.com/TheWalletCrew/docs/blob/main/guides/develop/guides/insights-api.md) pour examiner les endpoints, les paramètres et les structures de réponse.
{% endstep %}

{% step %}

### 3. Commencez par une requête simple

Commencez par un décompte des `Carte:Installed` événements sur les 30 derniers jours. Regroupez le résultat par `Medium` pour voir quelle source d’acquisition a généré le plus d’ajouts au portefeuille pendant la période.

Cette première requête permet de valider rapidement que l’authentification fonctionne et que les données source sont disponibles sur le programme.
{% endstep %}
{% endstepper %}

## Cas d’usage courants

La plupart des équipes commencent par un besoin de reporting récurrent, puis approfondissent l’analyse. Le même flux d’événements peut prendre en charge à la fois le suivi opérationnel et les workflows BI.

* Alimentez Tableau, Looker ou Power BI avec les comptes d’installations et de désinstallations.
* Automatisez un rapport hebdomadaire des performances du programme par magasin ou région.
* Construisez un entonnoir d’activation personnalisé en corrélant `Carte:Created` avec `Carte:Installed`.
* Interrogez les événements de scan pour construire une vue analytique des redemptions.
* Validez la diffusion de la campagne en comparant `Carte:NotificationSent` avec les pics d’installation.

## FAQ

<details>

<summary>Quand faut-il utiliser l’API Insights plutôt que Statistiques ?</summary>

Utilisez **Statistiques** pour une lecture visuelle rapide des performances du programme. Utilisez la **API Insights** lorsque des filtres personnalisés, des regroupements personnalisés, l’ingestion BI ou des rapports automatisés sont nécessaires.

</details>

<details>

<summary>L’API Insights expose-t-elle les mêmes données que le tableau de bord ?</summary>

Oui. Le tableau de bord des statistiques est construit sur les mêmes données d’événements. L’API apporte davantage de flexibilité pour la forme des requêtes, la plage temporelle et l’utilisation en aval.

</details>

<details>

<summary>Du code est-il nécessaire pour accéder aux données d’événements du wallet ?</summary>

Non. La [Rapport](/guides-monitoring/fr/monitor/report.md) page prend en charge l’export CSV depuis le back office. L’API Insights est utile lorsqu’un workflow programmable est nécessaire.

</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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/interrogez-vos-donnees-api-insights.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.