Integra Adapty en tu app iOS con ayuda de IA

Esta guía te lleva paso a paso por la integración de Adapty en tu app iOS con una herramienta de codificación con IA — le proporcionas la documentación correcta de Adapty en el orden correcto.

Antes de empezar: configuración del dashboard

Adapty requiere algo de configuración en el dashboard antes de escribir cualquier código del SDK. Puedes hacerlo con una skill de LLM interactiva o manualmente desde el Dashboard.

Enfoque con skill (recomendado)

La skill de la CLI de Adapty permite que tu LLM configure tu app, productos, niveles de acceso, paywalls y placements directamente, sin necesidad de abrir el Dashboard en cada paso. Solo necesitas conectar tu store en el Dashboard.

npx skills add adaptyteam/adapty-cli --skill adapty-cli

Una vez añadida la skill, ejecuta /adapty-cli en tu agente. Te guiará por cada paso, incluido cuándo abrir el Dashboard para conectar tu store.

Enfoque desde el dashboard

Si prefieres configurarlo todo manualmente, esto es lo que necesitas antes de escribir código. Tu LLM no puede buscar valores del dashboard por ti — tendrás que proporcionarlos tú mismo.

Conecta tu store: En el Adapty Dashboard, ve a App settings → General. Esto es necesario para que las compras funcionen. Conectar App Store
Copia tu clave pública del SDK: En el Adapty Dashboard, ve a App settings → General y busca la sección API keys. En el código, esta es la cadena que pasas a Adapty.activate("YOUR_PUBLIC_SDK_KEY").
Crea al menos un producto: En el Adapty Dashboard, ve a la página Products. No haces referencia a los productos directamente en el código — Adapty los entrega a través de flows o paywalls. Añadir productos
Crea un flow o paywall y un placement: En el Adapty Dashboard, crea un flow (o un paywall si vas a construir la interfaz tú mismo), luego asígnalo a un placement en la página Placements. En el código, el ID del placement es el string que pasas a Adapty.getFlow("YOUR_PLACEMENT_ID"). Crear flow
Configura los niveles de acceso: En el Adapty Dashboard, configúralos por producto en la página Products. En el código, la cadena que se comprueba es profile.accessLevels["premium"]. El nivel de acceso premium predeterminado funciona para la mayoría de las apps. Si los usuarios de pago acceden a funciones distintas según el producto (por ejemplo, un plan basic frente a un plan pro), crea niveles de acceso adicionales antes de empezar a programar.

Una vez que tengas los cinco, estarás listo para escribir código. Dile a tu LLM: “Mi clave SDK pública es X, mi placement ID es Y” para que pueda generar el código correcto de inicialización y obtención del paywall.

Configura cuando estés listo

Esto no es obligatorio para empezar a programar, pero lo necesitarás a medida que tu integración madure:

Pruebas A/B: Configúralas en la página Placements. No requieren cambios en el código. Pruebas A/B
Paywalls y placements adicionales: Añade más llamadas a getPaywall con diferentes IDs de placement.
Integraciones de analíticas: Configúralas en la página Integrations. La configuración varía según la integración. Consulta las integraciones de analíticas y las integraciones de atribución.

Proporciona documentación de Adapty a tu LLM

Usa Context7 (recomendado)

Context7 es un servidor MCP que da a tu LLM acceso directo a la documentación actualizada de Adapty. Tu LLM obtiene automáticamente la documentación adecuada según lo que preguntes, sin necesidad de pegar URLs manualmente.

Context7 funciona con Cursor, Claude Code, Windsurf y otras herramientas compatibles con MCP. Para configurarlo, ejecuta:

npx ctx7 setup

Esto detecta tu editor y configura el servidor de Context7. Para la configuración manual, consulta el repositorio de Context7 en GitHub. Una vez configurado, referencia la librería de Adapty en tus prompts:

Use the adaptyteam/adapty-docs library to look up how to install the iOS SDK

Aunque Context7 elimina la necesidad de pegar enlaces a la documentación manualmente, el orden de implementación es importante. Sigue el tutorial de implementación paso a paso para asegurarte de que todo funciona.

Usa la documentación en texto plano

Puedes acceder a cualquier página de la documentación de Adapty como Markdown en texto plano. Añade .md al final de su URL o haz clic en Copy for LLM bajo el título del artículo. Por ejemplo: adapty-cursor.md.

Cada etapa del tutorial de implementación incluye un bloque “Envía esto a tu LLM” con enlaces .md para pegar.

Para obtener más documentación a la vez, consulta los archivos índice y los subconjuntos por plataforma más abajo.

Tutorial de implementación

El resto de esta guía recorre la integración de Adapty en orden de implementación. Cada etapa incluye la documentación que debes enviar a tu LLM, qué deberías ver al terminar y los problemas más frecuentes.

Planifica tu integración

Antes de escribir código, pide a tu LLM que analice tu proyecto y cree un plan de implementación. Si tu herramienta de IA admite un modo de planificación (como el modo plan de Cursor o Claude Code), úsalo para que el LLM pueda leer tanto la estructura de tu proyecto como la documentación de Adapty antes de generar ningún código.

Indica a tu LLM qué enfoque usas para las compras, ya que esto determina qué guías debe seguir:

Adapty Flow Builder: Creas flows en el editor no-code de Adapty y el SDK los renderiza automáticamente.
Paywalls creados manualmente: Construyes tu propia UI de paywall en código, pero sigues usando Adapty para obtener productos y gestionar compras.
Modo Observer: Mantienes tu infraestructura de compras existente y usas Adapty solo para analíticas e integraciones.

¿No sabes cuál elegir? Lee la tabla comparativa en la guía de inicio rápido.

Instalar y configurar el SDK

Instala el paquete del SDK de Adapty mediante Swift Package Manager en Xcode y actívalo con tu clave pública del SDK. Esta es la base: sin ella, nada más funciona.

Guía: Instalar y configurar el SDK de Adapty

Envía esto a tu LLM:

Read these Adapty docs before writing code:
- https://adapty.io/docs/es/sdk-installation-ios.md

Checkpoint

Expected: La app compila y se ejecuta. La consola de Xcode muestra el log de activación de Adapty.
Gotcha: “Public API key is missing” → comprueba que reemplazaste el placeholder con tu clave real de App settings.

Mostrar flows o paywalls y gestionar compras

Obtén un flow o paywall por ID de placement, muéstralo y gestiona los eventos de compra. Las guías que necesitas dependen de cómo gestiones las compras.

Prueba cada compra en el sandbox a medida que avanzas — no esperes hasta el final. Consulta Pruebas de compra en sandbox para ver las instrucciones de configuración.

Guías:

Envía esto a tu LLM:

Read these Adapty docs before writing code:
- https://adapty.io/docs/es/ios-quickstart-paywalls.md
- https://adapty.io/docs/es/get-pb-paywalls.md
- https://adapty.io/docs/es/ios-present-paywalls.md
- https://adapty.io/docs/es/ios-handling-events.md
- https://adapty.io/docs/es/handle-paywall-actions.md

Punto de control

Resultado esperado: El flow aparece con los productos configurados. Al pulsar un producto se muestra el diálogo de compra en sandbox.
Problema frecuente: Flow vacío o error en getFlow → verifica que el ID del placement coincida exactamente con el del dashboard y que el placement tenga una audiencia asignada.

Guías:

Envía esto a tu LLM:

Read these Adapty docs before writing code:
- https://adapty.io/docs/es/ios-quickstart-manual.md
- https://adapty.io/docs/es/fetch-paywalls-and-products.md
- https://adapty.io/docs/es/present-remote-config-paywalls.md
- https://adapty.io/docs/es/making-purchases.md
- https://adapty.io/docs/es/restore-purchase.md

Checkpoint

Esperado: Tu paywall personalizado muestra los productos obtenidos desde Adapty. Al pulsar un producto, se activa el diálogo de compra en sandbox.
Problema frecuente: Array de productos vacío → verifica que el paywall tenga productos asignados en el dashboard y que el placement tenga una audiencia.

Guías:

Envía esto a tu LLM:

Read these Adapty docs before writing code:
- https://adapty.io/docs/es/observer-vs-full-mode.md
- https://adapty.io/docs/es/implement-observer-mode.md
- https://adapty.io/docs/es/report-transactions-observer-mode.md

Checkpoint

Esperado: Tras una compra en sandbox usando tu flujo de compra existente, la transacción aparece en el Event Feed del Adapty Dashboard.
Problema frecuente: Sin eventos → verifica que estás reportando las transacciones a Adapty y que las App Store Server Notifications están configuradas.

Comprueba el estado de la suscripción

Tras una compra, comprueba el perfil del usuario para detectar un nivel de acceso activo y restringir el contenido premium.

Guía: Comprobar el estado de la suscripción

Envía esto a tu LLM:

Read these Adapty docs before writing code:
- https://adapty.io/docs/es/ios-check-subscription-status.md

Punto de control

Resultado esperado: Tras una compra en sandbox, profile.accessLevels["premium"]?.isActive devuelve true.
Problema frecuente: accessLevels vacío tras la compra → comprueba que el producto tiene un nivel de acceso asignado en el dashboard.

Identificar usuarios

Vincula las cuentas de usuario de tu app a los perfiles de Adapty para que las compras persistan entre dispositivos.

Omite este paso si tu app no tiene autenticación.

Guía: Identificar usuarios

Envía esto a tu LLM:

Read these Adapty docs before writing code:
- https://adapty.io/docs/es/ios-quickstart-identify.md

Checkpoint

Esperado: Después de llamar a Adapty.identify("your-user-id"), la sección Profiles del dashboard muestra tu ID de usuario personalizado.
Problema frecuente: Llama a identify después de la activación pero antes de obtener los paywalls para evitar una atribución de perfil anónima.

Prepararse para el lanzamiento

Cuando tu integración funcione en el sandbox, repasa el checklist de lanzamiento para asegurarte de que todo está listo para producción.

Guía: Checklist de lanzamiento

Envía esto a tu LLM:

Read these Adapty docs before releasing:
- https://adapty.io/docs/es/release-checklist.md

Checkpoint

Expected: Todos los elementos del checklist confirmados: conexión al store, notificaciones del servidor, flujo de compra, verificaciones de nivel de acceso y requisitos de privacidad.
Gotcha: Si faltan las notificaciones del servidor de App Store → configúralas en App settings → iOS SDK o los eventos no aparecerán en el dashboard.

Archivos de índice de documentación en texto plano

Si necesitas dar a tu LLM un contexto más amplio que el de páginas individuales, ofrecemos archivos de índice que listan o combinan toda la documentación de Adapty:

llms.txt: Lista todas las páginas con enlaces .md. Es un estándar emergente para hacer los sitios web accesibles a los LLM. Ten en cuenta que para algunos agentes de IA (p. ej., ChatGPT) tendrás que descargar llms.txt y subirlo al chat como archivo.
llms-full.txt: Toda la documentación de Adapty combinada en un único archivo. Es muy grande: úsalo solo cuando necesites una visión completa.
ios-llms.txt e ios-llms-full.txt específicos de iOS: subconjuntos por plataforma que ahorran tokens en comparación con el sitio completo.