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

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

Tip

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

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

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

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

Warning

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

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

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

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

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

Гайды:

Tip

Checkpoint

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

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

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

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

Гайды:

Read these Adapty docs before writing code:

Tip

Checkpoint

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

Гайды:

Отправьте это своему 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-react-native.md
- https://adapty.io/docs/ru/report-transactions-observer-mode-react-native.md

Tip

Checkpoint

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

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

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

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

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

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

Tip

Checkpoint

Ожидаемый результат: После вызова adapty.identify("your-user-id") в разделе 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 в одном файле. Очень большой — используйте только когда нужна полная картина.
Файлы для React Native: react-native-llms.txt и react-native-llms-full.txt: подмножества документации для конкретной платформы, которые экономят токены по сравнению с полным сайтом.