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

Этот гайд поможет вам интегрировать Adapty в приложение React Native с помощью LLM. Сначала вы настроите дашборд Adapty, а затем пройдёте каждый этап реализации, отправляя нужные ссылки на документацию своему LLM. В конце вы найдёте рекомендации по настройке ИИ-инструментов для работы с документацией Adapty.

Скопируйте всю эту страницу в формате Markdown и вставьте в свой LLM, чтобы начать — нажмите Copy for LLM вверху страницы или откройте версию в формате .md. LLM будет использовать ссылки на гайды и контрольные точки, чтобы провести вас через каждый этап.

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

Перед написанием кода 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, если приложение рассчитано на обе платформы. Без этого покупки не будут работать. Подключить сторы
Скопируйте публичный SDK-ключ: В дашборде Adapty перейдите в App settings → General и найдите раздел API keys. В коде это строка, которую вы передаёте в adapty.activate("YOUR_PUBLIC_SDK_KEY").
Создайте хотя бы один продукт: В дашборде Adapty перейдите на страницу Products. В коде вы не ссылаетесь на продукты напрямую — Adapty передаёт их через пейволы. Добавить продукты
Создайте пейвол и плейсмент: В дашборде Adapty создайте пейвол на странице Paywalls, затем назначьте его плейсменту на странице Placements. В коде ID плейсмента — это строка, которую вы передаёте в adapty.getPaywall("YOUR_PLACEMENT_ID"). Создать пейвол
Настройте уровни доступа: В дашборде Adapty настройте их для каждого продукта на странице Products. В коде это строка, которую проверяют в profile.accessLevels['premium']?.isActive. Уровень доступа premium по умолчанию подходит для большинства приложений. Если платящие пользователи получают доступ к разным функциям в зависимости от продукта (например, план basic и план pro), создайте дополнительные уровни доступа до начала разработки.

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

Настройте по мере готовности

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Гайды:

Отправьте это своему LLM (выберите подходящий вариант или отправьте оба):

Read these Adapty docs before writing code:
- https://adapty.io/docs/ru/sdk-installation-react-native-expo.md
- https://adapty.io/docs/ru/sdk-installation-react-native-pure.md

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

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

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

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

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

Гайды:

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

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

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

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

Гайды:

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

Read these Adapty docs before writing code:
- https://adapty.io/docs/ru/react-native-quickstart-manual.md
- https://adapty.io/docs/ru/fetch-paywalls-and-products-react-native.md
- https://adapty.io/docs/ru/present-remote-config-paywalls-react-native.md
- https://adapty.io/docs/ru/react-native-making-purchases.md
- https://adapty.io/docs/ru/react-native-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-react-native.md
- https://adapty.io/docs/ru/report-transactions-observer-mode-react-native.md

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

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

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

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

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

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

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

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

Подготовьтесь к выпуску

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

Гайд: Чеклист выпуска

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