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

Этот гайд проведёт вас через интеграцию Adapty в приложение на Capacitor шаг за шагом с помощью AI-инструмента для написания кода — вы передаёте ему нужную документацию 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. В коде идентификатор плейсмента — это строка, которую вы передаёте в adapty.getFlow(). Создать пейвол
Настройте уровни доступа: В дашборде Adapty настройте для каждого продукта на странице Products. В коде нужная строка проверяется в profile.accessLevels['premium']?.isActive. Стандартный уровень доступа premium подходит для большинства приложений. Если платящие пользователи получают доступ к разным функциям в зависимости от продукта (например, тариф basic и тариф pro), создайте дополнительные уровни доступа до начала разработки.

Tip

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

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

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

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

Warning

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

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

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

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

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

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

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

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

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

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

Adapty Flow & Paywall Builder: Вы создаёте флоу в no-code конструкторе Adapty, а SDK отображает их автоматически.
Кастомные пейволы: Вы создаёте собственный UI пейвола в коде, но по-прежнему используете 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

Tip

Checkpoint

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

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

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

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

Гайды:

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

Checkpoint

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

Гайды:

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

Checkpoint

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

Гайды:

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

Checkpoint

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

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

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

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

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

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

Tip

Checkpoint

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

Checkpoint

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

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

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

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

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

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

Tip

Checkpoint

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

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

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

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