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

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

Используйте навык интеграции SDK (бета)

Навык adapty-sdk-integration автоматизирует интеграцию от начала до конца: настройку дашборда, установку SDK, пейвол и проверку на каждом этапе. Если ваш инструмент не поддерживает формат Claude Skills, используйте пошаговое руководство ниже.

Поддерживаемые инструменты: Claude Code, GitHub Copilot CLI, OpenAI Codex, Gemini CLI.

Установить

Выберите форму для своего инструмента. Полный список — в README навыка.

Claude Code: Выполните claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill, затем claude plugin install adapty-sdk-integration@adapty в терминале.
GitHub Copilot CLI: Выполните gh skill install adaptyteam/adapty-sdk-integration-skill.
Gemini CLI: Выполните gemini skills install https://github.com/adaptyteam/adapty-sdk-integration-skill.
OpenAI Codex или любой другой инструмент: Склонируйте репозиторий и скопируйте plugins/adapty-sdk-integration/skills/adapty-sdk-integration/ в директорию skills вашего инструмента.

Запуск

В своём проекте выполните /adapty-sdk-integration. Скилл определит вашу платформу и задаст несколько вопросов. Затем он последовательно проведёт через настройку дашборда, установку SDK, создание пейвола и проверку — подгружая нужные документы 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. В коде идентификатор плейсмента — это строка, которую вы передаёте в 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 избавляет от необходимости вставлять ссылки на документацию вручную, порядок внедрения имеет значение. Следуйте пошаговому руководству по внедрению ниже, выполняя шаги по порядку.

Используйте документацию в формате plain text

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

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

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

Пошаговый разбор реализации

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

Планирование интеграции

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

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

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

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

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

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

Гайды:

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 плейсмента точно совпадает с указанным в дашборде и что плейсменту назначена аудитория.

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

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

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

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

Checkpoint

Ожидаемый результат: После вызова Adapty.identify("your-user-id") в разделе Profiles дашборда отображается ваш пользовательский 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 формате. Обратите внимание, что для некоторых AI-агентов (например, ChatGPT) нужно скачать llms.txt и загрузить файл в чат.
llms-full.txt: Вся документация Adapty в одном файле. Очень большой объём — используйте только когда нужна полная картина.
Android-специфичные android-llms.txt и android-llms-full.txt: Подмножества для конкретной платформы, позволяющие сэкономить токены по сравнению с полным сайтом.