Интеграция Adapty в Android-приложение с помощью ИИ

Этот гайд проведёт вас через интеграцию Adapty в ваше Android-приложение шаг за шагом с помощью AI-инструмента для программирования — вы подаёте ему нужную документацию Adapty в правильном порядке.

Прежде чем начать: настройка дашборда

Adapty требует некоторой настройки в дашборде до написания кода SDK. Вы можете сделать это с помощью интерактивного LLM-скилла или вручную через дашборд.

Подход через skill (рекомендуется)

Skill Adapty CLI позволяет вашему LLM настраивать приложение, продукты, уровни доступа, пейволы и плейсменты напрямую — без необходимости открывать дашборд на каждом шаге. Вам нужно лишь подключить стор в дашборде.

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

После добавления skill запустите /adapty-cli в вашем агенте. Он проведёт вас через каждый шаг — в том числе укажет, когда нужно открыть дашборд для подключения стора.

Подход через дашборд

Если вы предпочитаете настраивать всё вручную, вот что нужно сделать до написания кода. LLM не может самостоятельно получить значения из дашборда — их нужно предоставить.

Подключите стор: В дашборде Adapty перейдите в App settings → General. Это обязательно для работы покупок. Подключить Google Play
Скопируйте публичный SDK-ключ: В дашборде Adapty перейдите в App settings → General и найдите раздел API keys. В коде это строка, которую вы передаёте в конфигуратор Adapty.
Создайте хотя бы один продукт: В дашборде Adapty перейдите на страницу Products. Вы не ссылаетесь на продукты напрямую в коде — Adapty доставляет их через пейволы. Добавить продукты
Создайте пейвол и плейсмент: В дашборде Adapty создайте пейвол на странице Paywalls, затем назначьте его на плейсмент на странице Placements. В коде ID плейсмента — это строка, которую вы передаёте в Adapty.getPaywall("YOUR_PLACEMENT_ID"). Создать пейвол
Настройте уровни доступа: В дашборде Adapty настройте каждый продукт на странице Products. В коде проверяйте строку profile.accessLevels["premium"]?.isActive. Уровень доступа premium по умолчанию подходит для большинства приложений. Если платящие пользователи получают доступ к разным функциям в зависимости от продукта (например, план basic и план pro), создайте дополнительные уровни доступа до начала разработки.

Как только у вас есть все пять, можно писать код. Скажите своему LLM: «Мой публичный SDK-ключ — X, мой ID плейсмента — Y», чтобы он сгенерировал корректный код инициализации и получения пейвола.

Настройте, когда будете готовы

Это не нужно для начала разработки, но пригодится по мере развития интеграции:

A/B-тесты: Настраиваются на странице Placements. Изменения в коде не нужны. A/B-тесты
Дополнительные пейволы и плейсменты: Добавьте больше вызовов getPaywall с разными идентификаторами плейсментов.
Интеграции аналитики: Настраиваются на странице Integrations. Процесс настройки зависит от интеграции. См. интеграции аналитики и интеграции атрибуции.

Загрузите документацию Adapty в свой LLM

Используйте Context7 (рекомендуется)

Context7 — это MCP-сервер, который даёт вашей LLM прямой доступ к актуальной документации Adapty. LLM автоматически подтягивает нужные docs на основе вашего запроса — никакого ручного копирования ссылок.

Context7 работает с Cursor, Claude Code, Windsurf и другими MCP-совместимыми инструментами. Чтобы настроить его, выполните:

npx ctx7 setup

Команда определит ваш редактор и настроит сервер Context7. Для ручной настройки смотрите репозиторий Context7 на GitHub. После настройки укажите библиотеку Adapty в своих промптах:

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

Несмотря на то что Context7 избавляет от необходимости вручную вставлять ссылки на документацию, порядок реализации имеет значение. Следуйте пошаговому руководству по реализации ниже строго по шагам, чтобы всё работало корректно.

Используйте документацию в виде обычного текста

Любой документ Adapty доступен в виде обычного текстового Markdown. Добавьте .md в конец URL или нажмите Copy for LLM под заголовком статьи. Например: adapty-cursor-android.md.

Каждый шаг в пошаговом руководстве по интеграции ниже содержит блок «Отправьте это в ваш LLM» со ссылками .md для вставки.

Чтобы получить сразу несколько документов, см. индексные файлы и платформенные подборки ниже.

Пошаговая реализация

Далее мы разберём интеграцию Adapty по порядку реализации. Каждый этап включает документы для передачи вашему LLM, то, что вы должны увидеть после завершения, и типичные проблемы.

Спланируйте интеграцию

Прежде чем переходить к коду, попросите LLM проанализировать ваш проект и составить план реализации. Если ваш AI-инструмент поддерживает режим планирования (например, режим плана в Cursor или Claude Code), используйте его — так LLM сможет изучить и структуру вашего проекта, и документацию Adapty перед написанием кода.

Сообщите LLM, какой подход к покупкам вы используете — от этого зависит, какими гайдами она должна руководствоваться:

Adapty Paywall Builder: Вы создаёте пейволы в визуальном редакторе Adapty, а SDK отображает их автоматически.
Пейволы, созданные вручную: Вы строите собственный UI пейвола в коде, но используете Adapty для получения продуктов и обработки покупок.
Режим Observer: Вы сохраняете существующую инфраструктуру покупок и используете Adapty только для аналитики и интеграций.

Не знаете, что выбрать? Прочитайте сравнительную таблицу в быстром старте.

Установка и настройка SDK

Добавьте зависимость Adapty SDK через Gradle в Android Studio и активируйте её с помощью вашего публичного ключа SDK. Это основа — без неё ничего не работает.

Гайд: Установка и настройка Adapty SDK

Отправьте это в ваш LLM:

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

Checkpoint

Ожидаемый результат: Приложение собирается и запускается. В Logcat отображается лог активации Adapty.
Возможная проблема: «Public API key is missing» → убедитесь, что заменили placeholder на реальный ключ из App settings.

Показывайте пейволы и обрабатывайте покупки

Получите пейвол по ID плейсмента, отобразите его и обработайте события покупок. Нужные гайды зависят от того, как вы обрабатываете покупки.

Тестируйте каждую покупку в песочнице по мере работы — не откладывайте на конец. Инструкции по настройке см. в разделе Тестирование покупок в песочнице.

Гайды:

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

Checkpoint

Ожидаемый результат: Пейвол отображается с настроенными продуктами. При нажатии на продукт появляется диалог покупки в песочнице.
Возможная проблема: Пустой пейвол или ошибка getPaywall → убедитесь, что ID плейсмента точно совпадает с тем, что указано в дашборде, и что плейсменту назначена аудитория.

Гайды:

Обзор Observer mode
Реализация Observer mode
Отчёт о транзакциях в Observer mode Отправьте это своему LLM:

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

Checkpoint

Ожидаемый результат: После покупки в песочнице через ваш существующий флоу покупки транзакция появляется в Event Feed дашборда Adapty.
Частая ошибка: Нет событий → убедитесь, что вы передаёте транзакции в Adapty и настроены Google Play Real-Time Developer Notifications.

Проверка статуса подписки

После покупки проверьте профиль пользователя на наличие активного уровня доступа, чтобы закрыть премиум-контент.

Гайд: Проверка статуса подписки

Отправьте это в свой LLM:

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

Checkpoint

Ожидаемый результат: После покупки в песочнице profile.accessLevels["premium"]?.isActive возвращает true.
Частая ошибка: Пустой accessLevels после покупки → убедитесь, что продукту назначен уровень доступа в дашборде.

Идентификация пользователей

Свяжите аккаунты пользователей вашего приложения с профилями Adapty, чтобы покупки сохранялись на всех устройствах.

Пропустите этот шаг, если в вашем приложении нет авторизации.

Гайд: Идентификация пользователей

Отправьте это своему LLM:

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

Checkpoint

Ожидаемый результат: После вызова Adapty.identify("your-user-id") в разделе Profiles дашборда Adapty появляется ваш пользовательский ID.
Важно: Вызывайте identify после активации, но до получения пейволов, чтобы избежать атрибуции профиля анонимному пользователю.

Подготовка к релизу

Когда интеграция заработает в песочнице, пройдитесь по чеклисту релиза и убедитесь, что всё готово к продакшену.

Гайд: Чеклист релиза

Отправьте это в свой LLM:

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

Checkpoint

Ожидается: Все пункты чеклиста подтверждены: подключение стора, серверные уведомления, флоу покупки, проверки уровня доступа и требования к конфиденциальности.
Важно: Если не настроены Google Play Real-Time Developer Notifications → настройте их в App settings → Android SDK, иначе события не будут отображаться в дашборде.

Индексные файлы документации в виде обычного текста

Если вы хотите дать вашему LLM более широкий контекст, выходящий за рамки отдельных страниц, мы предоставляем индексные файлы, которые перечисляют или объединяют всю документацию Adapty:

llms.txt: Список всех страниц со ссылками .md. Формирующийся стандарт для обеспечения доступности сайтов для LLM. Обратите внимание, что для некоторых ИИ-агентов (например, ChatGPT) потребуется скачать llms.txt и загрузить его в чат как файл.
llms-full.txt: Вся документация Adapty, объединённая в один файл. Очень большой объём — используйте только тогда, когда нужна полная картина.
Android-специфичные android-llms.txt и android-llms-full.txt: Подборки для конкретной платформы, позволяющие сэкономить токены по сравнению с полным сайтом.