---
title: "Interroger l'IA sur vos données analytiques"
description: "Interrogez vos données analytiques Adapty en langage naturel avec un agent IA, via l'API Export Analytics."
---

Posez des questions à un agent IA sur vos données analytiques Adapty en langage naturel — revenus, conversions, rétention, LTV — et laissez-le récupérer les chiffres pour vous. Connectez un outil capable d'effectuer des appels API à l'[API Export Analytics](https://adapty.io/docs/fr/export-analytics-api.md), et il interroge vos métriques à la demande.

## Ce que vous pouvez demander \{#what-you-can-ask-about\}

L'API Export Analytics retourne les mêmes métriques que celles affichées dans les graphiques du tableau de bord Adapty. Chaque métrique possède sa propre opération :

| Métrique | Ce qu'elle couvre | Opération |
| --- | --- | --- |
| Revenus, MRR, ARR, ARPU | Argent généré dans le temps, groupé par période, pays ou campagne | [retrieveAnalyticsData](https://adapty.io/docs/fr/api-export-analytics/operations/retrieveAnalyticsData.md) |
| Rétention par cohorte | Combien de temps les abonnés d'une cohorte donnée continuent à payer | [retrieveCohortData](https://adapty.io/docs/fr/api-export-analytics/operations/retrieveCohortData.md) |
| Taux de conversion | Combien d'utilisateurs progressent d'une étape ou d'un canal au suivant | [retrieveConversionData](https://adapty.io/docs/fr/api-export-analytics/operations/retrieveConversionData.md) |
| Churn et entonnoir | Où les utilisateurs abandonnent et à quelle vitesse ils se désabonnent | [retrieveFunnelData](https://adapty.io/docs/fr/api-export-analytics/operations/retrieveFunnelData.md) |
| Valeur vie (LTV) | Revenu moyen par segment d'utilisateurs dans le temps | [retrieveLTVData](https://adapty.io/docs/fr/api-export-analytics/operations/retrieveLTVData.md) |
| Rétention | Part des utilisateurs toujours actifs après un certain nombre de jours | [retrieveRetentionData](https://adapty.io/docs/fr/api-export-analytics/operations/retrieveRetentionData.md) |

Pour la liste complète des paramètres et filtres, consultez la [référence API](https://adapty.io/docs/fr/api-export-analytics.md).

## Avant de commencer \{#before-you-start\}

Il vous faut trois éléments :

- **Un compte Adapty avec des données** : L'API retourne les mêmes métriques que les graphiques de votre tableau de bord, donc votre application doit déjà collecter des données analytiques.
- **Une clé API secrète** : Trouvez-la dans [App settings → General](https://app.adapty.io/settings/general), dans le champ **Secret key**. Les clés sont spécifiques à chaque application, utilisez donc une clé distincte pour chacune. Stockez-la dans une variable d'environnement (par exemple, `ADAPTY_SECRET_KEY`) pour que votre agent puisse la lire sans que vous ayez à la coller dans le chat.
- **Un outil IA capable d'appeler des API** : Par exemple, Claude Code, Cursor, ou Claude Desktop avec un outil fetch. Les outils de chat classiques comme claude.ai ou ChatGPT ne peuvent pas appeler l'API directement.

## Fournir la spécification API à votre agent \{#give-your-agent-the-api-spec\}

La [spécification OpenAPI](https://adapty.io/docs/fr/api-specs/export-analytics-api.yaml) décrit chaque endpoint, l'en-tête d'authentification, le corps de la requête et des exemples de réponses. Une fois que votre agent dispose de la spec, il construit des requêtes correctes sans que vous ayez à écrire le moindre code.

Fournissez la spec à votre agent par URL :

- **Collez l'URL** : Si votre agent peut récupérer des URLs, donnez-lui `https://adapty.io/docs/fr/api-specs/export-analytics-api.yaml` et demandez-lui de lire la spec.
- **Utilisez un outil fetch** : Si votre agent dispose d'un outil qui récupère des URLs (par exemple, un serveur MCP fetch), pointez-le vers la même URL.

La spec définit l'URL de base sur `https://api-admin.adapty.io`, donc votre agent a tout ce dont il a besoin dès que votre clé est dans l'environnement.

## Interroger vos données \{#ask-about-your-data\}

Une fois la spec chargée et votre clé dans une variable d'environnement, décrivez la métrique souhaitée en langage naturel.

Exemples de questions :

```
What was my MRR at the end of each month this year, and how does it compare to last year?

Show my trial-to-paid conversion rate for the last 90 days, broken down by product.

Which countries drive the most revenue from my yearly subscription? Top 10.

How is week-1 retention trending for subscribers who started in the last 6 months?

What's the refund rate on my annual plan since launch, by month?

Compare LTV for paid-campaign users vs. organic over the last year, and export it as CSV.
```

L'agent associe votre demande à la bonne opération, lit la clé depuis l'environnement et retourne les données. Les réponses sont en JSON par défaut. Demandez un CSV si vous voulez un fichier prêt à utiliser dans un tableur — l'agent définit alors `format` sur `csv` dans le corps de la requête.

:::warning
Gardez votre clé secrète dans une variable d'environnement — ne la collez pas dans le chat et ne la commitez pas dans un fichier de règles. Les clés sont spécifiques à chaque application, donc renouvelez la vôtre dans **Settings → General** si elle est compromise. Consultez [rotation des clés API](https://adapty.io/docs/fr/export-analytics-api-authorization.md).
:::

## Configurer une fois pour une utilisation répétée \{#set-up-once-for-repeated-use\}

Pour éviter de refaire la configuration à chaque session, enregistrez la spec et la clé là où votre agent peut les réutiliser :

- **Sauvegardez le lien de la spec** : Ajoutez l'URL de la spec aux règles ou au fichier mémoire de votre agent (par exemple, un fichier `CLAUDE.md` ou un fichier de règles Cursor) pour qu'elle se charge à chaque session.
- **Stockez la clé dans votre environnement** : Conservez `ADAPTY_SECRET_KEY` dans votre profil shell ou le gestionnaire de secrets de l'outil, pour ne plus jamais avoir à la coller.
- **Sauvegardez des prompts réutilisables ou créez une compétence personnalisée** : Gardez vos questions courantes comme prompts enregistrés, ou encapsulez-les dans une compétence personnalisée ou une commande slash pour que votre agent génère un rapport à la demande.

## Limites \{#limits\}

Gardez ces contraintes à l'esprit :

- **Limite de débit** : L'API autorise 2 requêtes par seconde par clé API. En cas de dépassement, une erreur `429 Too Many Requests` est retournée. Indiquez à votre agent d'attendre et de réessayer en cas de `429`.
- **Clés spécifiques à chaque application** : Chaque clé fonctionne pour une seule application. Pour récupérer des données de plusieurs applications, fournissez la clé correspondante pour chacune.
- **Format de sortie** : Les réponses sont en JSON par défaut. Définissez `format` sur `csv` dans le corps de la requête pour un export CSV.

Pour les règles complètes d'authentification et de format des requêtes, consultez [Autorisation et format des requêtes](https://adapty.io/docs/fr/export-analytics-api-authorization.md).