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

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

Используйте навык интеграции 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 на каждом этапе.

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

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

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. Подключите App Store и Google Play, если приложение поддерживает обе платформы. Это обязательно для работы покупок. Подключить сторы
Скопируйте публичный SDK-ключ: В дашборде Adapty перейдите в App settings → General и найдите раздел API keys. В коде это строка, которую вы передаёте в adapty.activate("YOUR_PUBLIC_SDK_KEY").
Создайте хотя бы один продукт: В дашборде 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 React Native SDK

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

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

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

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

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

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

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

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

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

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

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

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

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

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

У нас есть отдельные гайды для Expo и bare React Native проектов — выберите подходящий для вашего окружения.

Гайды:

Checkpoint

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

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

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

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

Гайды:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Read these Adapty docs before writing code:
- https://adapty.io/docs/ru/react-native-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

Ожидается: Все пункты чеклиста подтверждены: подключение сторов, серверные уведомления, процесс покупки, проверки уровней доступа и требования к конфиденциальности.
Частая ошибка: Отсутствие серверных уведомлений → настройте 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 в одном файле. Очень большой объём — используйте только когда нужна полная картина.
React Native-специфичные react-native-llms.txt и react-native-llms-full.txt: Подмножества документации для конкретной платформы, которые экономят токены по сравнению с полным сайтом.