--- title: "Intégrer Adapty dans votre application Android avec l'aide de l'IA" description: "Un guide étape par étape pour intégrer Adapty dans votre application Android avec Cursor, Context7, ChatGPT, Claude ou d'autres outils IA." --- Ce guide vous accompagne pas à pas dans l'intégration d'Adapty dans votre application Android à l'aide d'un outil IA — vous lui fournissez la bonne documentation Adapty dans le bon ordre. For a fully automated integration, use the [adapty-sdk-integration skill](https://github.com/adaptyteam/adapty-sdk-integration-skill): it runs the whole integration from your AI coding tool in one command. ## Avant de commencer : configuration du tableau de bord \{#before-you-start-dashboard-setup\} Adapty nécessite une configuration dans le tableau de bord avant d'écrire le moindre code SDK. Vous pouvez le faire avec un skill LLM interactif, ou manuellement via le Dashboard. ### Approche par skill (recommandée) \{#skill-approach-recommended\} Le skill Adapty CLI permet à votre LLM de configurer votre application, vos produits, niveaux d'accès, paywalls et placements directement — sans ouvrir le Dashboard à chaque étape. Vous avez uniquement besoin de [connecter votre store](integrate-payments) 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 à chaque étape — y compris quand ouvrir le Dashboard pour connecter votre store. ### Approche manuelle \{#dashboard-approach\} Si vous préférez tout configurer manuellement, voici ce dont vous avez besoin avant d'écrire du code. Votre LLM ne peut pas récupérer les valeurs du tableau de bord à votre place — vous devrez les lui fournir. 1. **Connectez votre store** : dans l'Adapty Dashboard, allez dans **App settings → General**. C'est indispensable pour que les achats fonctionnent. [Connecter Google Play](integrate-payments) 2. **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 au builder de configuration Adapty. 3. **Créez au moins un produit** : dans l'Adapty Dashboard, allez sur la page **Products**. Vous ne référencez pas les produits directement dans le code — Adapty les livre via les paywalls. [Ajouter des produits](quickstart-products) 4. **Créez un paywall et un placement** : dans l'Adapty Dashboard, créez un paywall sur la page **Paywalls**, puis assignez-le à un placement sur la page **Placements**. Dans le code, l'ID de placement est la chaîne que vous passez à `Adapty.getPaywall("YOUR_PLACEMENT_ID")`. [Créer un paywall](quickstart-paywalls) 5. **Configurez les niveaux d'accès** : dans l'Adapty Dashboard, configurez-les par produit sur la page **Products**. Dans le code, la chaîne vérifiée dans `profile.accessLevels["premium"]?.isActive`. 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](assigning-access-level-to-a-product) avant de commencer à coder. :::tip Une fois ces cinq éléments en place, vous êtes prêt à écrire du code. Dites à votre LLM : "Ma clé SDK publique est X, mon ID de placement est Y" pour qu'il génère un code d'initialisation et de récupération de paywall correct. ::: ### À configurer quand vous serez prêt \{#set-up-when-ready\} Ces éléments ne sont pas nécessaires pour commencer à coder, mais vous en aurez besoin à mesure que votre intégration se développe : - **Tests A/B** : à configurer sur la page **Placements**. Aucun changement de code nécessaire. [Tests A/B](ab-tests) - **Paywalls et placements supplémentaires** : ajoutez d'autres appels `getPaywall` avec des ID de placement différents. - **Intégrations analytiques** : à configurer sur la page **Integrations**. La configuration varie selon l'intégration. Voir [intégrations analytiques](analytics-integration) et [intégrations d'attribution](attribution-integration). ## Fournir la documentation Adapty à votre LLM \{#feed-adapty-docs-to-your-llm\} ### Utiliser Context7 (recommandé) \{#use-context7-recommended\} [Context7](https://context7.com) est un serveur MCP qui donne à votre LLM un accès direct à la documentation Adapty à jour. Votre LLM récupère automatiquement les bons documents en fonction de vos questions — pas 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 Context7](https://github.com/upstash/context7). Une fois configuré, référencez la bibliothèque Adapty dans vos prompts : ``` Use the adaptyteam/adapty-docs library to look up how to install the Android SDK ``` :::warning Même si Context7 évite de coller des liens vers la documentation manuellement, l'ordre d'implémentation est important. Suivez le [guide d'implémentation](#implementation-walkthrough) ci-dessous étape par étape pour vous assurer que tout fonctionne. ::: ### Utiliser la documentation en texte brut \{#use-plain-text-docs\} Vous pouvez accéder à n'importe quel article de la documentation Adapty en Markdown. Ajoutez `.md` à la fin de son URL, ou cliquez sur **Copy for LLM** sous le titre de l'article. Par exemple : [adapty-cursor-android.md](https://adapty.io/docs/fr/adapty-cursor-android.md). Chaque étape du [guide d'implémentation](#implementation-walkthrough) ci-dessous inclut un bloc "À envoyer à votre LLM" avec des liens `.md` à coller. Pour obtenir davantage de documentation en une fois, consultez les [fichiers d'index et sous-ensembles par plateforme](#plain-text-doc-index-files) ci-dessous. ## Guide d'implémentation \{#implementation-walkthrough\} La suite de ce guide parcourt l'intégration d'Adapty dans l'ordre d'implémentation. Chaque étape inclut les documents à envoyer à votre LLM, ce que vous devriez observer une fois terminé, et les problèmes courants. ### Planifier votre intégration \{#plan-your-integration\} 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 l'approche que vous utilisez pour les achats — cela influe sur les guides à suivre : - [**Adapty Paywall Builder**](adapty-paywall-builder) : vous créez des paywalls dans l'éditeur no-code d'Adapty, et le SDK les affiche automatiquement. - [**Paywalls créés manuellement**](android-making-purchases) : vous construisez votre propre interface de paywall dans le code, mais utilisez quand même Adapty pour récupérer les produits et gérer les achats. - [**Mode Observer**](observer-vs-full-mode) : vous conservez votre infrastructure d'achat existante et utilisez Adapty uniquement pour l'analytique et les intégrations. Vous ne savez pas lequel choisir ? Lisez le [tableau comparatif dans le guide de démarrage rapide](android-quickstart-paywalls). ### Installer et configurer le SDK \{#install-and-configure-the-sdk\} Ajoutez la dépendance du SDK Adapty via Gradle dans Android Studio et activez-le avec votre clé SDK publique. C'est la base — rien d'autre ne fonctionne sans ça. **Guide :** [Installer et configurer le SDK Adapty](sdk-installation-android) À envoyer à votre LLM : ``` Read these Adapty docs before writing code: - https://adapty.io/docs/fr/sdk-installation-android.md ``` :::tip[Point de contrôle] - **Attendu :** l'application se compile et s'exécute. Logcat affiche le log d'activation Adapty. - **Problème courant :** "Public API key is missing" → vérifiez que vous avez remplacé le placeholder par votre vraie clé depuis App settings. ::: ### Afficher les paywalls et gérer les achats \{#show-paywalls-and-handle-purchases\} Récupérez un paywall par ID 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](test-purchases-in-sandbox) pour les instructions de configuration. **Guides :** - [Activer les achats avec les paywalls (guide de démarrage rapide)](android-quickstart-paywalls) - [Récupérer les paywalls du Paywall Builder et leur configuration](android-get-pb-paywalls) - [Afficher les paywalls](android-present-paywalls) - [Gérer les événements de paywall](android-handling-events) - [Répondre aux actions des boutons](android-handle-paywall-actions) À envoyer à votre LLM : ``` Read these Adapty docs before writing code: - https://adapty.io/docs/fr/android-quickstart-paywalls.md - https://adapty.io/docs/fr/android-get-pb-paywalls.md - https://adapty.io/docs/fr/android-present-paywalls.md - https://adapty.io/docs/fr/android-handling-events.md - https://adapty.io/docs/fr/android-handle-paywall-actions.md ``` :::tip[Point de contrôle] - **Attendu :** le paywall s'affiche avec vos produits configurés. Appuyer sur un produit déclenche la boîte de dialogue d'achat sandbox. - **Problème courant :** paywall vide ou erreur `getPaywall` → vérifiez que l'ID de placement correspond exactement à celui du tableau de bord et que le placement a une audience assignée. ::: **Guides :** - [Activer les achats dans votre paywall personnalisé (guide de démarrage rapide)](android-quickstart-manual) - [Récupérer les paywalls et les produits](fetch-paywalls-and-products-android) - [Afficher un paywall conçu via Remote Config](present-remote-config-paywalls-android) - [Effectuer des achats](android-making-purchases) - [Restaurer des achats](android-restore-purchase) À envoyer à votre LLM : ``` Read these Adapty docs before writing code: - https://adapty.io/docs/fr/android-quickstart-manual.md - https://adapty.io/docs/fr/fetch-paywalls-and-products-android.md - https://adapty.io/docs/fr/present-remote-config-paywalls-android.md - https://adapty.io/docs/fr/android-making-purchases.md - https://adapty.io/docs/fr/android-restore-purchase.md ``` :::tip[Point de contrôle] - **Attendu :** 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. - **Problème courant :** 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 :** - [Présentation du mode Observer](observer-vs-full-mode) - [Implémenter le mode Observer](implement-observer-mode-android) - [Signaler les transactions en mode Observer](report-transactions-observer-mode-android) À envoyer à votre LLM : ``` 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-android.md - https://adapty.io/docs/fr/report-transactions-observer-mode-android.md ``` :::tip[Point de contrôle] - **Attendu :** après un achat sandbox via votre flux d'achat existant, la transaction apparaît dans le **Event Feed** du tableau de bord Adapty. - **Problème courant :** aucun événement → vérifiez que vous signalez les transactions à Adapty et que les notifications Google Play Real-Time Developer Notifications sont configurées. ::: ### Vérifier le statut de l'abonnement \{#check-subscription-status\} Après un achat, vérifiez dans le profil utilisateur la présence d'un niveau d'accès actif pour restreindre le contenu premium. **Guide :** [Vérifier le statut de l'abonnement](android-check-subscription-status) À envoyer à votre LLM : ``` Read these Adapty docs before writing code: - https://adapty.io/docs/fr/android-check-subscription-status.md ``` :::tip[Point de contrôle] - **Attendu :** après un achat sandbox, `profile.accessLevels["premium"]?.isActive` renvoie `true`. - **Problème courant :** `accessLevels` vide après l'achat → vérifiez que le produit a un niveau d'accès assigné dans le tableau de bord. ::: ### Identifier les utilisateurs \{#identify-users\} Liez 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 n'a pas d'authentification. ::: **Guide :** [Identifier les utilisateurs](android-quickstart-identify) À envoyer à votre LLM : ``` Read these Adapty docs before writing code: - https://adapty.io/docs/fr/android-quickstart-identify.md ``` :::tip[Point de contrôle] - **Attendu :** après avoir appelé `Adapty.identify("your-user-id")`, la section **Profiles** du tableau de bord affiche votre ID utilisateur personnalisé. - **Problème courant :** appelez `identify` après l'activation mais avant de récupérer les paywalls pour éviter l'attribution à un profil anonyme. ::: ### Se préparer pour la mise en production \{#prepare-for-release\} Une fois votre intégration fonctionnelle en sandbox, parcourez la checklist de mise en production pour vous assurer que tout est prêt pour la production. **Guide :** [Checklist de mise en production](release-checklist) À envoyer à votre LLM : ``` Read these Adapty docs before releasing: - https://adapty.io/docs/fr/release-checklist.md ``` :::tip[Point de contrôle] - **Attendu :** tous les éléments de la checklist confirmés : connexion au store, notifications serveur, flux d'achat, vérifications du niveau d'accès et exigences de confidentialité. - **Problème courant :** notifications Google Play Real-Time Developer Notifications manquantes → configurez-les dans **App settings → Android SDK**, sinon les événements n'apparaîtront pas dans le tableau de bord. ::: ## Fichiers d'index de documentation en texte brut \{#plain-text-doc-index-files\} Si vous avez besoin de fournir à votre LLM un contexte plus large que des pages individuelles, nous hébergeons des fichiers d'index qui listent ou regroupent toute la documentation Adapty : - [`llms.txt`](https://adapty.io/docs/fr/llms.txt) : liste toutes les pages avec des liens `.md`. Un [standard émergent](https://llmstxt.org/) 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 en pièce jointe dans la conversation. - [`llms-full.txt`](https://adapty.io/docs/fr/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. - [`android-llms.txt`](https://adapty.io/docs/fr/android-llms.txt) et [`android-llms-full.txt`](https://adapty.io/docs/fr/android-llms-full.txt) spécifiques à Android : des sous-ensembles par plateforme qui économisent des tokens par rapport au site complet.