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

В этом руководстве описывается пошаговая интеграция Adapty в приложение на Capacitor с помощью ИИ-инструмента для написания кода — вы передаёте ему нужную документацию Adapty в правильном порядке.

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

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

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

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

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

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

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

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

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

Tip

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

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

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

A/B-тесты: настраиваются на странице Placements. Изменения в коде не требуются. A/B-тесты
Дополнительные флоу и плейсменты: добавьте больше вызовов getFlow с разными ID плейсментов.
Интеграции с аналитикой: настраиваются на странице 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 Capacitor SDK

Warning

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

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

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

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

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

Пошаговое руководство по реализации

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

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

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

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

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

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

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

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

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

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

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

Tip

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

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

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

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

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

Руководства:

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

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

Tip

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

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

Руководства:

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

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

Tip

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

Ожидаемый результат: ваш собственный пейвол отображает продукты, полученные из 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-capacitor.md
- https://adapty.io/docs/ru/report-transactions-observer-mode-capacitor.md

Tip

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

Ожидаемый результат: после покупки в песочнице через существующий флоу покупки транзакция появляется в Event Feed дашборда Adapty.
Частая ошибка: нет событий → убедитесь, что вы передаёте транзакции в Adapty и серверные уведомления настроены для обоих сторов.

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

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

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

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

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

Tip

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

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

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

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

Important

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

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

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

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

Tip

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

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

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

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

Руководство: Чек-лист релиза

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

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

Tip

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

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

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

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

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