> 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 [Tableaux de bord Analytics](/guides-monitoring/fr/monitor/les-tableaux-de-bord-analytics.md) affichent visuellement les données Wallet. 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 BI, effectuer des analyses ad hoc ou automatiser les rapports.

{% hint style="info" %}
Aucun code n'est requis pour exporter les données. Le [Rapport](/guides-monitoring/fr/monitor/report.md) page permet aux équipes d'exporter les données d'événements au format 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érationnelle suit les scans par magasin et surveille les tendances de désinstallation par programme.
* Une équipe BI intègre les événements Wallet dans Tableau, Looker ou Power BI pour les rapports hebdomadaires.

</details>

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

L'API Insights est une interface de requête pour les événements Wallet stockés dans la plateforme The Wallet Crew. Chaque événement suivi peut être interrogé, y compris les créations de cartes, 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:Créée`                | Lorsqu'un enregistrement de carte a été créé                                                                                          | Combien de cartes ont été émises ce mois-ci par magasin ?                     |
| `Carte:Installée`            | Lorsqu'une carte a été ajoutée à Apple Wallet ou Google Wallet, avec des données sources telles que `Medium`, `Tag`, `URL`, et `Hôte` | Quelle campagne e-mail a généré le plus d'installations la semaine dernière ? |
| `Carte:Désinstallée`         | Lorsqu'une carte a été entièrement supprimée de tous les Wallet                                                                       | Quel est le taux de désinstallation par programme ?                           |
| `Carte:Mise à jour`          | 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:Envoi de mise à jour` | Lorsqu'une mise à jour push a été envoyée à un appareil                                                                               | Les mises à jour atteignent-elles les appareils de manière fiable ?           |
| `Carte:Scannée`              | Lorsqu'un code-barres de carte a été scanné                                                                                           | Combien de scans par jour ont eu lieu dans chaque emplacement ?               |
| `Carte:Notification envoyée` | 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 `Hôte`.

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.

## En quoi cela se rapporte aux tableaux de bord Analytics

{% hint style="info" %}
Le **Analytics** les tableaux de bord sont construits sur l'API Insights. Tout ce qui est visible dans les tableaux de bord peut également être interrogé directement via l'API, avec plus de flexibilité sur les regroupements, les filtres et les plages de dates.
{% endhint %}

Pour une vue sans code de ces mêmes données, utilisez [Tableaux de bord Analytics](/guides-monitoring/fr/monitor/les-tableaux-de-bord-analytics.md). Pour envoyer les événements vers des outils externes en temps réel, voir [Envoyer les événements Wallet vers vos outils](/guides-monitoring/fr/monitor/sync-pass-installation-status-to-your-crm.md).

## Premiers pas

La voie la plus rapide consiste à s'authentifier, à examiner les points de terminaison disponibles et à exécuter une première requête agrégée.

{% stepper %}
{% step %}

### 1. S'authentifier

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

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

{% endstep %}

{% step %}

### 2. Explorer les points de terminaison disponibles

Utilisez le [API Insights](/developers-guides/fr/integration-guides/insights-api.md) pour examiner les points de terminaison, 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:Installée` é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 à Wallet pendant la période.

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

## Cas d'utilisation 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 décomptes d'installations et de désinstallations.
* Automatisez un rapport hebdomadaire des performances du programme par magasin ou par région.
* Construisez un tunnel d'activation personnalisé en corrélant `Carte:Créée` avec `Carte:Installée`.
* Interrogez les événements de scan pour créer une vue analytique des utilisations.
* Validez la diffusion de la campagne en comparant `Carte:Notification envoyée` avec les pics d'installation.

## FAQ

<details>

<summary>Quand faut-il utiliser l'API Insights plutôt que les tableaux de bord Analytics ?</summary>

Utilisez **Tableaux de bord Analytics** pour obtenir une lecture visuelle rapide des performances du programme. Utilisez le **API Insights** lorsque des filtres personnalisés, des regroupements personnalisés, une 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. Les tableaux de bord Analytics sont construits sur les mêmes données d'événements. L'API offre 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 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.