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

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

Скопируйте всю эту страницу в формате Markdown и вставьте в LLM, чтобы начать работу — нажмите Copy for LLM вверху страницы или откройте версию .md. LLM будет использовать ссылки из гайда и контрольные точки для пошагового прохождения каждого этапа.

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

Перед написанием кода Adapty требует определённой настройки дашборда. Это можно сделать с помощью интерактивного скилла для LLM или вручную через дашборд.

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

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

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

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

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

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

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

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

Настройте позже

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

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

Передайте документацию Adapty в LLM

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

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

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 проанализировать ваш проект и составить план реализации. Если ваш ИИ-инструмент поддерживает режим планирования (как в Cursor или Claude Code), используйте его — это позволит LLM изучить структуру проекта и документацию Adapty до написания кода.

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

Adapty Paywall Builder: Вы создаёте пейволы в визуальном конструкторе Adapty, и SDK отображает их автоматически.
Пейволы, созданные вручную: Вы строите собственный UI пейвола в коде, но по-прежнему используете Adapty для получения продуктов и обработки покупок.
Observer mode: Вы сохраняете существующую инфраструктуру покупок и используете 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

Контрольная точка

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

Отображение пейволов и обработка покупок

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

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

Гайды:

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

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

Контрольная точка

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

Гайды:

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

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

Контрольная точка

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

Гайды:

Отправьте это 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

Контрольная точка

Ожидаемый результат: После покупки в песочнице через существующий флоу покупок транзакция появляется в 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

Контрольная точка

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

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

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

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

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

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

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

Контрольная точка

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

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

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

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

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

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

Контрольная точка

Ожидаемый результат: Все пункты чеклиста подтверждены: подключение стора, серверные уведомления, флоу покупок, проверки уровней доступа и требования к конфиденциальности.
Частая проблема: Не настроены 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: Платформозависимые подборки, которые экономят токены по сравнению с полным сайтом.