Interroger l'IA sur vos données analytiques

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, et il interroge vos métriques à la demande.

Ce que vous pouvez demander

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
Rétention par cohorte	Combien de temps les abonnés d’une cohorte donnée continuent à payer	retrieveCohortData
Taux de conversion	Combien d’utilisateurs progressent d’une étape ou d’un canal au suivant	retrieveConversionData
Churn et entonnoir	Où les utilisateurs abandonnent et à quelle vitesse ils se désabonnent	retrieveFunnelData
Valeur vie (LTV)	Revenu moyen par segment d’utilisateurs dans le temps	retrieveLTVData
Rétention	Part des utilisateurs toujours actifs après un certain nombre de jours	retrieveRetentionData

Pour la liste complète des paramètres et filtres, consultez la référence API.

Avant de commencer

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, 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.

Page App settings General d'Adapty avec la clé API secrète dans le champ Secret key

Fournir la spécification API à votre agent

La spécification OpenAPI 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

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.

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.

Configurer une fois pour une utilisation répétée

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

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.