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

¿Usas un asistente de IA? Hay una skill del CLI de Adapty disponible para ayudar a los LLMs a trabajar con el CLI.

El CLI de Adapty te permite configurar tu app por completo desde la línea de comandos. Úsalo como alternativa al inicio rápido desde el dashboard si prefieres trabajar en la terminal o con clientes MCP.

Conectar Adapty a App Store Connect y Google Play todavía requiere una configuración puntual en el dashboard, que se explica en el paso 3.

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

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.

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

Antes de continuar, conecta tu app a App Store Connect y Google Play en el Adapty Dashboard. Los IDs de producto de ambos stores son necesarios en el paso 5.

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 te saltaste el paso 4, usa el default_access_level.id que devolvió el comando apps create en el paso 3 como tu <access-level-id>.

Los IDs de producto del store que vinculas aquí (--ios-product-id, --android-product-id) no pueden modificarse una vez creados. Para usar IDs de producto del store diferentes, crea un nuevo producto.

El comando devuelve un <product-id>.

6. Crea un paywall

Un paywall es el contenedor que alberga tus productos. En Adapty, los paywalls son la única forma de entregar productos a los usuarios. Todo producto debe estar en un paywall antes de poder aparecer en tu app.

Una vez que un paywall está vinculado a un placement, sus productos no se pueden cambiar. Para usar productos diferentes, crea un nuevo paywall y actualiza el placement para que apunte a él.

El comando devuelve un <paywall-id>.

7. Crea un placement

Un placement es el punto de tu app donde muestras un paywall. Lo único que tienes que escribir directamente en el código de tu app es el ID del placement. Todo lo demás —qué paywall mostrar y a qué usuarios— se gestiona desde el dashboard sin 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 pidas a Adapty qué paywall mostrar en ese punto. Elige algo que describa la ubicación, como "main", "onboarding" o "settings".

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

El flag --audiences controla qué paywall se muestra a qué usuarios. El ejemplo anterior establece una audiencia por defecto única: todos los usuarios en este placement ven el mismo paywall.

¿Qué viene ahora?

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