Intégrer Adapty dans votre application iOS avec l'aide de l'IA

Ce guide vous explique étape par étape comment intégrer Adapty dans votre application iOS à l’aide d’un outil de codage IA — vous lui fournissez la bonne documentation Adapty dans le bon ordre.

Avant de commencer : configuration du tableau de bord

Adapty nécessite une configuration du tableau de bord avant d’écrire le moindre code SDK. Vous pouvez le faire via un outil LLM interactif ou manuellement depuis le Dashboard.

Approche par skill (recommandée)

Le skill Adapty CLI permet à votre LLM de configurer votre app, vos produits, vos niveaux d’accès, vos paywalls et vos placements directement — sans ouvrir le Dashboard à chaque étape. Il vous suffit de connecter votre store dans le Dashboard.

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

Une fois le skill ajouté, lancez /adapty-cli dans votre agent. Il vous guidera à travers chaque étape — y compris quand ouvrir le Dashboard pour connecter votre store.

Approche via le tableau de bord

Si vous préférez tout configurer manuellement, voici ce dont vous avez besoin avant d’écrire du code. Votre LLM ne peut pas rechercher les valeurs du tableau de bord à votre place — vous devrez les fournir vous-même.

Connectez votre store : Dans l’Adapty Dashboard, allez dans App settings → General. C’est indispensable pour que les achats fonctionnent. Connecter l’App Store
Copiez votre clé SDK publique : Dans l’Adapty Dashboard, allez dans App settings → General, puis trouvez la section API keys. Dans le code, c’est la chaîne que vous passez à Adapty.activate("YOUR_PUBLIC_SDK_KEY").
Créez au moins un produit : Dans l’Adapty Dashboard, rendez-vous sur la page Products. Vous ne référencez pas les produits directement dans le code — Adapty les fournit via des flows ou des paywalls. Ajouter des produits
Créez un flow ou un paywall et un placement : Dans l’Adapty Dashboard, créez un flow (ou un paywall si vous construisez l’interface vous-même), puis assignez-le à un placement sur la page Placements. Dans le code, l’identifiant du placement est la chaîne que vous passez à Adapty.getFlow("YOUR_PLACEMENT_ID"). Créer un flow
Configurez les niveaux d’accès : Dans l’Adapty Dashboard, configurez chaque produit sur la page Products. Dans le code, la chaîne vérifiée est profile.accessLevels["premium"]. Le niveau d’accès premium par défaut convient à la plupart des applications. Si les utilisateurs payants ont accès à des fonctionnalités différentes selon le produit (par exemple, un plan basic et un plan pro), créez des niveaux d’accès supplémentaires avant de commencer à coder.

Tip

Une fois que vous avez les cinq, vous êtes prêt à écrire du code. Dites à votre LLM : « Ma clé SDK publique est X, mon ID de placement est Y » afin qu’il puisse générer le code d’initialisation et de récupération du paywall correctement.

À configurer quand vous êtes prêt

Ces éléments ne sont pas nécessaires pour commencer à coder, mais vous en aurez besoin au fil de l’évolution de votre intégration :

Tests A/B : à configurer dans la page Placements. Aucun changement de code requis. Tests A/B
Flows et placements supplémentaires : ajoutez d’autres appels getFlow avec différents identifiants de placement.
Intégrations analytiques : à configurer dans la page Integrations. La configuration varie selon l’intégration. Consultez les intégrations analytiques et les intégrations d’attribution.

Alimentez votre LLM avec la documentation Adapty

Utiliser Context7 (recommandé)

Context7 est un serveur MCP qui donne à votre LLM un accès direct à la documentation Adapty à jour. Votre LLM récupère automatiquement les bonnes docs en fonction de ce que vous demandez — plus besoin de coller des URL manuellement.

Context7 fonctionne avec Cursor, Claude Code, Windsurf et d’autres outils compatibles MCP. Pour le configurer, exécutez :

npx ctx7 setup

Cela détecte votre éditeur et configure le serveur Context7. Pour une configuration manuelle, consultez le dépôt GitHub de Context7.

Une fois configurée, référencez la bibliothèque Adapty dans vos prompts :

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

Warning

Même si Context7 supprime la nécessité de coller des liens vers la documentation manuellement, l’ordre de mise en œuvre est important. Suivez le guide de mise en œuvre ci-dessous étape par étape pour vous assurer que tout fonctionne correctement.

Utiliser la documentation en texte brut

Vous pouvez accéder à n’importe quelle documentation Adapty en texte brut Markdown. Ajoutez .md à la fin de l’URL, ou cliquez sur Copy for LLM sous le titre de l’article. Par exemple : adapty-cursor.md.

Chaque étape du guide d’implémentation ci-dessous inclut un bloc « Envoyer ceci à votre LLM » avec des liens .md à coller.

Pour accéder à davantage de documentation en une seule fois, consultez les fichiers d’index et les sous-ensembles par plateforme ci-dessous.

Présentation de l’implémentation

La suite de ce guide vous accompagne à travers l’intégration d’Adapty dans l’ordre d’implémentation. Chaque étape indique la documentation à fournir à votre LLM, ce que vous devriez observer une fois terminé, et les problèmes courants.

Planifiez votre intégration

Avant de vous lancer dans le code, demandez à votre LLM d’analyser votre projet et de créer un plan d’implémentation. Si votre outil IA propose un mode de planification (comme le mode plan de Cursor ou Claude Code), utilisez-le afin que le LLM puisse lire à la fois la structure de votre projet et la documentation Adapty avant d’écrire du code.

Indiquez à votre LLM quelle approche vous utilisez pour les achats — cela détermine les guides qu’il devra suivre :

Adapty Flow & Paywall Builder : vous créez des flows dans l’éditeur no-code d’Adapty, et le SDK les affiche automatiquement.
Paywalls créées manuellement : vous construisez votre propre interface de paywall dans le code, mais utilisez toujours Adapty pour récupérer les produits et gérer les achats.
Mode observateur : vous conservez votre infrastructure d’achats existante et utilisez Adapty uniquement pour l’analytique et les intégrations.

Vous ne savez pas lequel choisir ? Consultez le tableau comparatif dans le guide de démarrage rapide.

Installer et configurer le SDK

Installez le package Adapty SDK via Swift Package Manager dans Xcode et activez-le avec votre clé SDK publique. C’est la base — rien d’autre ne fonctionne sans elle.

Guide : Installer et configurer le SDK Adapty

Envoyez ceci à votre LLM :

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

Tip

Checkpoint

Attendu : L’application se compile et s’exécute. La console Xcode affiche le journal d’activation d’Adapty.
Piège fréquent : “Public API key is missing” → vérifiez que vous avez bien remplacé l’espace réservé par votre vraie clé depuis App settings.

Afficher des flows ou des paywalls et gérer les achats

Récupérez un flow ou un paywall via l’identifiant de placement, affichez-le et gérez les événements d’achat. Les guides dont vous avez besoin dépendent de la façon dont vous gérez les achats.

Testez chaque achat en sandbox au fur et à mesure — n’attendez pas la fin. Consultez Tester les achats en sandbox pour les instructions de configuration.

Guides :

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

Tip

Checkpoint

Résultat attendu : Le flow s’affiche avec vos produits configurés. Appuyer sur un produit déclenche la boîte de dialogue d’achat sandbox.
Point d’attention : Flow vide ou erreur getFlow → vérifiez que l’identifiant de placement correspond exactement à celui du tableau de bord et qu’une audience lui est bien assignée.

Guides :

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

Tip

Checkpoint

Expected: Votre paywall personnalisé affiche les produits récupérés depuis Adapty. Appuyer sur un produit déclenche la boîte de dialogue d’achat sandbox.
Gotcha: Tableau de produits vide → vérifiez que le paywall a des produits assignés dans le tableau de bord et que le placement a une audience.

Guides :

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

Tip

Checkpoint

Attendu : Après un achat sandbox via votre flow d’achat existant, la transaction apparaît dans Event Feed du tableau de bord Adapty.
Attention : Aucun événement → vérifiez que vous signalez les transactions à Adapty et que les App Store Server Notifications sont configurées.

Vérifier le statut de l’abonnement

Après un achat, vérifiez le profil utilisateur pour détecter un niveau d’accès actif et conditionner l’accès au contenu premium.

Guide : Vérifier le statut de l’abonnement

Envoyez ceci à votre LLM :

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

Tip

Checkpoint

Attendu : Après un achat en sandbox, profile.accessLevels["premium"]?.isActive retourne true.
Problème fréquent : accessLevels vide après l’achat → vérifiez que le produit a bien un niveau d’accès assigné dans le tableau de bord.

Identifier les utilisateurs

Associez les comptes utilisateurs de votre application aux profils Adapty pour que les achats persistent sur tous les appareils.

Important

Ignorez cette étape si votre application ne dispose pas d’authentification.

Guide : Identifier les utilisateurs

Envoyez ceci à votre LLM :

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

Tip

Checkpoint

Attendu : Après avoir appelé Adapty.identify("your-user-id"), la section Profiles du tableau de bord affiche votre identifiant utilisateur personnalisé.
À surveiller : Appelez identify après l’activation mais avant de récupérer les paywalls pour éviter une attribution de profil anonyme.

Préparer la mise en production

Une fois votre intégration fonctionnelle en sandbox, parcourez la liste de contrôle de mise en production pour vous assurer que tout est prêt.

Guide : Liste de contrôle de mise en production

Envoyez ceci à votre LLM :

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

Tip

Checkpoint

Attendu : Tous les éléments de la checklist sont confirmés : connexion au store, notifications serveur, flux d’achat, vérifications du niveau d’accès et exigences de confidentialité.
Point de vigilance : Notifications serveur App Store manquantes → configurez-les dans App settings → iOS SDK, sinon les événements n’apparaîtront pas dans le tableau de bord.

Fichiers d’index de documentation en texte brut

Si vous avez besoin de fournir à votre LLM un contexte plus large au-delà des pages individuelles, nous hébergeons des fichiers d’index qui listent ou regroupent toute la documentation Adapty :

llms.txt : Liste toutes les pages avec des liens .md. Un standard émergent pour rendre les sites web accessibles aux LLMs. Notez que pour certains agents IA (par exemple, ChatGPT) vous devrez télécharger llms.txt et le joindre à la conversation comme fichier.
llms-full.txt : L’intégralité de la documentation Adapty regroupée en un seul fichier. Très volumineux — à utiliser uniquement lorsque vous avez besoin d’une vue d’ensemble complète.
ios-llms.txt et ios-llms-full.txt spécifiques à iOS : Des sous-ensembles propres à cette plateforme qui permettent d’économiser des tokens par rapport au site complet.