Guide de démarrage rapide pour le CLI développeur Adapty

L’Adapty CLI vous permet de configurer votre app entièrement depuis la ligne de commande. Utilisez-le comme alternative au démarrage rapide depuis le tableau de bord si vous préférez les outils en terminal ou les clients MCP.

À la fin, votre app, votre niveau d’accès, votre produit, votre flow ou paywall, et votre placement sont tous visibles dans l’Adapty Dashboard.

Si vous exécutez la CLI dans Claude Cowork, configurez-la d’abord dans Claude — voir Configurer la CLI Adapty dans Claude Cowork.

1. Installer la CLI

Nécessite Node.js 18 ou version ultérieure.

Pour installer la CLI, exécutez la commande :

npm install -g adapty

Ou, directement :

npx adapty auth login

2. S’authentifier

Lancez la commande de connexion pour relier le CLI à votre compte Adapty.

adapty auth login

Le CLI ouvre un onglet dans le navigateur. Vérifiez que le code affiché dans le terminal correspond à celui affiché dans le navigateur, puis cliquez sur Authorize. Le terminal confirme lorsque l’authentification est terminée.

3. Créez votre application

Une application dans Adapty représente votre application mobile. Une seule application Adapty se connecte à la fois à l’App Store et au Google Play — vous n’avez besoin d’en créer qu’une seule, quel que soit le nombre de stores sur lesquels vous publiez.

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

La commande retourne un <app-id>. Utilisez cet ID dans toutes les commandes suivantes.

4. Créer un niveau d’accès (facultatif)

Les niveaux d’accès contrôlent ce à quoi les utilisateurs peuvent accéder après un achat. Plutôt que de vérifier si un utilisateur a acheté un produit spécifique, votre application vérifie si l’utilisateur dispose d’un niveau d’accès donné. Cela découple la logique de votre application des identifiants de produits spécifiques.

Un niveau d’accès premium est automatiquement créé avec chaque nouvelle application. Pour la plupart des applications, vous pouvez passer cette étape. Utilisez premium comme identifiant de niveau d’accès à l’étape 5.

Only run this command if different products unlock different features for different user groups — for example, if a “Basic” subscriber and a “Pro” subscriber get access to different parts of the app.

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

• --sdk-id est l’identifiant que vous utiliserez dans le code de votre app pour vérifier si une fonctionnalité doit être accessible à l’utilisateur (par exemple, if user.hasAccessLevel("pro")). Si vous ignorez cette étape et utilisez le niveau d’accès par défaut, son --sdk-id est premium.
• --title est un libellé d’affichage pour votre propre référence dans l’Adapty Dashboard.

La commande renvoie un <access-level-id>.

5. Créer un produit

Dans Adapty, un produit représente tout ce que votre application vend — un abonnement ou un achat unique. Les articles d’App Store Connect et de Google Play peuvent être regroupés en un seul produit Adapty et gérés depuis un seul endroit.

Vous aurez besoin des identifiants de produit de chaque store : l’identifiant Apple depuis App Store Connect, et l’identifiant de produit Android ainsi que l’identifiant de plan de base depuis Google Play Console. Consultez Produits pour savoir où les trouver.

Si vous avez sauté l’étape 4, utilisez le default_access_level.id retourné par la commande apps create à l’étape 3 comme <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>

La commande retourne un <product-id>.

Si vous vendez également ce produit sur le web via Stripe ou Paddle, ajoutez ces IDs à la même commande. Voir products create dans la référence des commandes.

6. Créer un flow ou un paywall

Chaque produit doit être inclus dans un flow ou un paywall avant de pouvoir apparaître dans votre application. Choisissez l’une des options suivantes :

• Un flow est un écran, ou une séquence d’écrans, que vous concevez dans le Flow & Paywall Builder sans code, et que le SDK Adapty affiche nativement : un écran de paywall, un onboarding, un quiz. Choisissez un flow quand vous souhaitez qu’Adapty gère l’affichage de l’écran d’achat. Les flows nécessitent le SDK Adapty 4.0 ou version ultérieure.
• Un paywall est un ensemble de produits sans design associé. Choisissez un paywall quand vous affichez l’écran d’achat dans votre propre code applicatif et que vous avez uniquement besoin qu’Adapty fournisse les produits, éventuellement accompagnés d’un Remote Config.

Un placement ne sert qu’un seul type de contenu, alors décidez avant l’étape 7.

6a. Créer un flow

La CLI crée l’enregistrement du flow. Ses écrans sont définis dans une configuration de builder, un document JSON que la CLI ne génère pas. Pour créer cette configuration depuis le terminal, utilisez la skill flow-generator, qui pilote la CLI à votre place.

Créez le flow :

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

La commande retourne un <flow-id>.

Construisez ses écrans avec la skill flow-generator ou dans le Flow & Paywall Builder. Dans les deux cas, le résultat est un brouillon enregistré que vos utilisateurs ne verront pas encore.

Publiez le flow :

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

La commande demande une confirmation. La publication s’exécute en arrière-plan ; vérifiez le statut avec adapty flows get --app <app-id> <flow-id> jusqu’à ce qu’il affiche published. En cas de publication_failed, flows config get indique la cause de l’erreur. Un placement n’accepte qu’un flow publié.

6b. Créer un paywall

Un paywall est le conteneur qui regroupe vos produits.

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>

La commande retourne un <paywall-id>.

7. Créer un placement

Un placement est l’endroit dans votre application où vous affichez un flow ou un paywall. La seule chose que vous codez en dur dans votre application est l’identifiant du placement. Tout le reste — quel flow ou paywall afficher et à quels utilisateurs — est géré depuis le tableau de bord sans avoir à publier une nouvelle version de l’application.

--developer-id est la chaîne que vous référencerez plus tard dans le code de votre application lorsque vous demandez à Adapty ce qu’il doit afficher à cet endroit. Choisissez quelque chose qui décrit l’emplacement, comme "main", "onboarding" ou "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}]'

Le flag --audiences détermine quel flow ou paywall est affiché à quels utilisateurs. Les exemples ci-dessus définissent une seule audience par défaut : tous les utilisateurs de ce placement voient le même contenu. Un placement ne sert qu’un seul type de contenu, donc chaque entrée d’audience doit avoir le même content_type. Pour un ciblage par segment, consultez La structure des audiences dans la référence des commandes.

Et ensuite ?

Toutes les entités sont désormais visibles dans l’Adapty Dashboard. Prochaines étapes :

• Modifier un flow ultérieurement — décrivez la modification au skill flow-generator, ou ouvrez le flow dans le Flow & Paywall Builder.
• Afficher un paywall dans votre application — récupérez le paywall et ses produits avec le SDK et construisez l’écran dans votre propre code.
• Intégrer le SDK Adapty — ajoutez le SDK à votre application pour récupérer et afficher le placement.
• Router différents segments d’utilisateurs vers différents flows ou paywalls — consultez placements update et segments list dans la référence des commandes.