Guía de inicio rápido para el CLI para desarrolladores de Adapty

El CLI de Adapty te permite configurar tu app completamente desde la línea de comandos. Úsalo como alternativa al inicio rápido del dashboard si prefieres herramientas de terminal o clientes MCP.

Al terminar, tu app, nivel de acceso, producto, flow o paywall y placement estarán visibles en el Adapty Dashboard.

Si ejecutas la CLI en Claude Cowork, configúrala primero en Claude — consulta Configurar la CLI de Adapty en Claude Cowork.

1. Instala el CLI

Requiere Node.js 18 o posterior.

Para instalar el CLI, ejecuta el comando:

npm install -g adapty

O directamente:

npx adapty auth login

2. Autentícate

Ejecuta el comando de inicio de sesión para conectar el CLI con tu cuenta de Adapty.

adapty auth login

El CLI abre una pestaña del navegador. Verifica que el código que aparece en la terminal coincida con el del navegador y haz clic en Authorize. La terminal confirmará cuando la autenticación se haya completado.

3. Crea tu app

Una app en Adapty representa tu aplicación móvil. Una misma app de Adapty se conecta tanto a App Store como a Google Play, por lo que solo necesitas crear una, independientemente de en cuántos stores publiques.

adapty apps create --title "My App" --platform ios --platform android --apple-bundle-id com.example.app --google-bundle-id com.example.app

adapty apps create --title "My App" --platform ios --apple-bundle-id com.example.app

adapty apps create --title "My App" --platform android --google-bundle-id com.example.app

El comando devuelve un <app-id>. Usa este ID en todos los comandos siguientes.

4. Crea un nivel de acceso (opcional)

Los niveles de acceso controlan a qué puede acceder el usuario tras una compra. En lugar de comprobar si un usuario compró un producto concreto, tu app verifica si el usuario tiene un determinado nivel de acceso. Esto desacopla la lógica de tu app de los IDs de producto específicos.

Con cada nueva app se crea automáticamente un nivel de acceso premium. Para la mayoría de las apps puedes saltarte este paso. Usa premium como ID de nivel de acceso en el paso 5.

Solo ejecuta este comando si distintos productos desbloquean distintas funciones para diferentes grupos de usuarios; por ejemplo, si un suscriptor “Basic” y uno “Pro” tienen acceso a partes diferentes de la app.

adapty access-levels create --app <app-id> --sdk-id "pro" --title "Pro"

• --sdk-id es el identificador que usarás en el código de tu app para comprobar si una función debe estar disponible para el usuario (por ejemplo, if user.hasAccessLevel("pro")). Si te saltas este paso y usas el nivel de acceso por defecto, su --sdk-id es premium.
• --title es una etiqueta de visualización para tu referencia en el Adapty Dashboard.

El comando devuelve un <access-level-id>.

5. Crea un producto

En Adapty, un producto representa cualquier cosa que tu app vende: una suscripción o una compra única. Los elementos de App Store Connect y Google Play se pueden agrupar en un único producto de Adapty y gestionarse desde un solo lugar.

Necesitarás los IDs de producto de cada store: el Apple product ID de App Store Connect, y el Android product ID y el base plan ID de Google Play Console. Consulta Productos para saber dónde encontrarlos.

Si omitiste el paso 4, usa el default_access_level.id que devolvió el comando apps create en el paso 3 como tu <access-level-id>.

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id> --android-product-id <your.google.id> --android-base-plan-id <your.base-plan.id>

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id>

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --android-product-id <your.google.id> --android-base-plan-id <your.base-plan.id>

El comando devuelve un <product-id>.

Si también vendes este producto en la web a través de Stripe o Paddle, añade esos IDs al mismo comando. Consulta products create en la referencia de comandos.

6. Crea un flow o un paywall

Todo producto debe estar dentro de un flow o un paywall antes de poder aparecer en tu app. Elige una opción:

• Un flow es una pantalla, o una secuencia de pantallas, que diseñas en el Flow & Paywall Builder sin código y el SDK de Adapty renderiza de forma nativa: una pantalla de paywall, un onboarding, un cuestionario. Elige un flow cuando quieras que Adapty se encargue de renderizar la pantalla de compra. Los flows requieren el SDK de Adapty 4.0 o posterior.
• Un paywall es un conjunto de productos sin diseño asociado. Elige un paywall cuando renderices la pantalla de compra en el código de tu propia app y solo necesites que Adapty entregue los productos, opcionalmente con un Remote Config.

Un placement sirve un único tipo de contenido, así que decide antes del paso 7.

6a. Crear un flow

El CLI crea el registro del flow. Sus pantallas viven en una configuración de builder, un documento JSON que el CLI no genera. Para crear la configuración desde el terminal, usa la skill flow-generator, que maneja el CLI por ti.

Crea el flow:

adapty flows create --app <app-id> --name "Onboarding"

El comando devuelve un <flow-id>.

Crea sus pantallas con la skill flow-generator o en el Flow & Paywall Builder. En cualquier caso, el resultado es un borrador guardado que tus usuarios aún no ven.

Publica el flow:

adapty flows publish --app <app-id> <flow-id>

El comando solicita confirmación. La publicación se ejecuta en segundo plano, así que comprueba el estado con adapty flows get --app <app-id> <flow-id> hasta que muestre published. Si aparece publication_failed, flows config get indica el motivo. Un placement solo acepta un flow publicado.

6b. Crea un paywall

Un paywall es el contenedor que agrupa tus productos.

adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id>

adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id-1> --product-id <product-id-2>

El comando devuelve un <paywall-id>.

7. Crea un placement

Un placement es el punto de tu app donde muestras un flow o paywall. Lo único que escribes directamente en el código de tu app es el ID del placement. Todo lo demás — qué flow o paywall mostrar y a qué usuarios — se gestiona desde el dashboard sin necesidad de publicar una nueva versión de la app.

--developer-id es la cadena que usarás más adelante en el código de tu app cuando le preguntes a Adapty qué mostrar en ese punto. Elige algo que describa la ubicación, como "main", "onboarding" o "settings".

adapty placements create --app <app-id> --title "Onboarding" --developer-id "onboarding" --audiences '[{"content_type":"flow","segment_ids":[],"flow_id":"<flow-id>","priority":0}]'

adapty placements create --app <app-id> --title "Main" --developer-id "main" --audiences '[{"content_type":"paywall","segment_ids":[],"paywall_id":"<paywall-id>","priority":0}]'

La opción --audiences controla qué flow o paywall se muestra a cada usuario. Los ejemplos anteriores definen una única audiencia predeterminada: todos los usuarios en este placement ven el mismo contenido. Un placement sirve un único tipo de contenido, por lo que cada entrada de audiencia debe tener el mismo content_type. Para segmentar por segmento, consulta Estructura de audiencias en la referencia de comandos.

¿Qué hacer a continuación?

Todas las entidades ya son visibles en el Adapty Dashboard. A continuación:

• Cambia un flow más adelante: describe el cambio al skill flow-generator o abre el flow en el Flow & Paywall Builder.
• Renderiza un paywall en tu app: obtén el paywall y sus productos con el SDK y construye la pantalla con tu propio código.
• Integra el SDK de Adapty: añade el SDK a tu app para obtener y mostrar el placement.
• Dirige distintos segmentos de usuarios a diferentes flows o paywalls: consulta placements update y segments list en la referencia de comandos.