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

Этот гайд поможет вам интегрировать Adapty в приложение на Capacitor с помощью 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. Подключите App Store и Google Play, если ваше приложение на Capacitor поддерживает обе платформы. Это обязательное условие для работы покупок. Подключить сторы
Скопируйте публичный SDK-ключ: В дашборде Adapty перейдите в App settings → General и найдите раздел API keys. В коде это строка, которую вы передаёте в adapty.activate().
Создайте хотя бы один продукт: В дашборде Adapty перейдите на страницу Products. В коде продукты не указываются напрямую — Adapty передаёт их через пейволы. Добавить продукты
Создайте пейвол и плейсмент: В дашборде Adapty создайте пейвол на странице Paywalls, затем привяжите его к плейсменту на странице Placements. В коде идентификатор плейсмента — это строка, которую вы передаёте в adapty.getPaywall(). Создать пейвол
Настройте уровни доступа: В дашборде 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 автоматически находит нужные разделы на основе вашего запроса — вручную вставлять ссылки не нужно.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Гайды:

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

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

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

Гайды:

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

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

Ожидаемый результат: Ваш пейвол отображает продукты, полученные из 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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