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

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

Warning

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

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

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

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

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

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

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

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

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

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

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

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

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

Установите пакет SDK Adapty через Swift Package Manager в Xcode и активируйте его с помощью публичного SDK-ключа. Это основа — без этого шага ничего не работает.

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

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

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

Tip

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

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

Отображение флоу или пейволов и обработка покупок

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

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

Гайды:

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

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

Tip

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

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

Гайды:

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

Read these Adapty docs before writing code:
- https://adapty.io/docs/ru/ios-quickstart-manual.md
- https://adapty.io/docs/ru/fetch-paywalls-and-products.md
- https://adapty.io/docs/ru/present-remote-config-paywalls.md
- https://adapty.io/docs/ru/making-purchases.md
- https://adapty.io/docs/ru/restore-purchase.md

Tip

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

Ожидаемый результат: Ваш кастомный пейвол отображает продукты, полученные из 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.md
- https://adapty.io/docs/ru/report-transactions-observer-mode.md

Tip

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

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

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

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

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

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

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

Tip

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

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

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

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

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

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

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

Tip

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

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

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

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

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