Pregunta a la IA sobre tus datos de analíticas

Pregunta a un agente de codificación con IA sobre tus analíticas de Adapty en lenguaje natural — ingresos, conversiones, retención, LTV — y deja que obtenga los datos por ti. Apunta una herramienta que pueda hacer llamadas a la API hacia la Export Analytics API, y consultará tus métricas bajo demanda.

Qué puedes consultar

La Export Analytics API devuelve las mismas métricas que ves en los gráficos del Adapty Dashboard. Cada métrica tiene su propia operación:

Métrica	Qué cubre	Operación
Ingresos, MRR, ARR, ARPU	Dinero generado a lo largo del tiempo, agrupado por período, país o campaña	retrieveAnalyticsData
Retención de cohortes	Cuánto tiempo siguen pagando los suscriptores de una cohorte determinada	retrieveCohortData
Tasas de conversión	Cuántos usuarios avanzan de un paso o canal al siguiente	retrieveConversionData
Churn y embudo	Dónde abandonan los usuarios y con qué rapidez se dan de baja	retrieveFunnelData
Valor del ciclo de vida (LTV)	Ingresos medios por segmento de usuarios a lo largo del tiempo	retrieveLTVData
Retención	Porcentaje de usuarios que siguen activos tras un número determinado de días	retrieveRetentionData
Para la lista completa de parámetros y filtros, consulta la referencia de la API.

Antes de empezar

Necesitas tres cosas:

Una cuenta de Adapty con datos: La API devuelve las mismas métricas que los gráficos del dashboard, así que tu app ya debe recopilar analíticas.
Una clave de API secreta: Encuéntrala en App settings → General, en el campo Secret key. Las claves son específicas por app, así que usa una clave distinta para cada una. Guárdala en una variable de entorno (por ejemplo, ADAPTY_SECRET_KEY) para que tu agente pueda leerla sin que tengas que pegarla en el chat.
Una herramienta de IA capaz de llamar APIs: Por ejemplo, Claude Code, Cursor o Claude Desktop con una herramienta de fetch. Las herramientas de chat básicas como claude.ai o ChatGPT no pueden llamar a la API directamente.

export-analytics-secret-key.webp

Dale a tu agente la especificación de la API

La especificación OpenAPI describe cada endpoint, la cabecera de autenticación, el cuerpo de la solicitud y ejemplos de respuesta. Una vez que tu agente tenga la especificación, construye solicitudes correctas sin que tengas que escribir ningún código.

Dale a tu agente la especificación mediante la URL:

Pega la URL: Si tu agente puede obtener URLs, dale https://adapty.io/docs/es/api-specs/export-analytics-api.yaml y pídele que lea la especificación.
Usa una herramienta de fetch: Si tu agente tiene una herramienta para recuperar URLs (por ejemplo, un servidor MCP de fetch), apúntala a la misma URL.

La especificación establece la URL base en https://api-admin.adapty.io, así que tu agente tiene todo lo que necesita una vez que tu clave esté en el entorno.

Pregunta sobre tus datos

Con la especificación cargada y tu clave en una variable de entorno, describe en lenguaje natural la métrica que necesitas.

Ejemplos de prompts:

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.

El agente mapea tu solicitud a la operación correcta, lee la clave del entorno y devuelve los datos. Las respuestas son JSON por defecto. Pide CSV si quieres un archivo listo para hojas de cálculo — el agente establece format como csv en el cuerpo de la solicitud.

Guarda tu clave secreta en una variable de entorno, no la pegues en el chat ni la incluyas en un archivo de reglas. Las claves son específicas de cada app, así que rota la tuya en Settings → General si se filtra. Consulta rotar claves de API.

Configura una vez para reutilizar

Para no repetir la configuración en cada sesión, guarda la especificación y la clave donde tu agente pueda reutilizarlas:

Guarda el enlace de la spec: Añade la URL de la spec a las reglas o al archivo de memoria de tu agente (por ejemplo, un archivo CLAUDE.md o las reglas de Cursor) para que se cargue en cada sesión.
Guarda la clave en tu entorno: Mantén ADAPTY_SECRET_KEY en el perfil de tu shell o en el almacén de secretos de la herramienta para no tener que pegarla nunca más.
Guarda prompts reutilizables o crea una skill personalizada: Conserva tus preguntas habituales como prompts guardados, o envuélvelas en una skill personalizada o en un slash command para que tu agente genere un informe cuando lo necesites.

Límites

Ten en cuenta estas restricciones:

Límite de velocidad: La API permite 2 solicitudes por segundo por clave de API. Si se supera, devuelve un error 429 Too Many Requests. Indica a tu agente que espere y reintente en caso de 429.
Claves por aplicación: Cada clave funciona para una sola aplicación. Para obtener datos de varias aplicaciones, proporciona la clave correspondiente a cada una.
Formato de salida: Las respuestas son JSON por defecto. Establece format como csv en el cuerpo de la solicitud para exportar en CSV.

Para consultar las reglas completas de autenticación y formato de solicitud, consulta Autorización y formato de solicitud.