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

Этот гайд проведёт вас через интеграцию Adapty в iOS-приложение шаг за шагом с помощью AI-инструмента для написания кода — вы подаёте ему нужную документацию Adapty в правильном порядке.

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

Прежде чем писать код SDK, нужно настроить дашборд Adapty. Это можно сделать с помощью интерактивного 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
Скопируйте публичный 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), создайте дополнительные уровни доступа до начала разработки.

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

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

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

A/B-тесты: Настройте на странице Placements. Изменения кода не требуются. A/B-тесты
Дополнительные флоу и плейсменты: Добавьте больше вызовов getFlow с разными идентификаторами плейсментов.
Аналитические интеграции: Настройте на странице Integrations. Настройка зависит от интеграции. См. аналитические интеграции и интеграции атрибуции.

Передайте документацию Adapty вашему LLM

Используйте Context7 (рекомендуется)

Context7 — MCP-сервер, который даёт вашей языковой модели прямой доступ к актуальной документации Adapty. Модель сама подтягивает нужные документы на основе вашего запроса — никаких ссылок вставлять вручную не нужно.

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

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

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

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

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

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

Пошаговая реализация

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Гайды:

Включить покупки с помощью Flow Builder (быстрый старт)
Получить флоу и их конфигурацию
Отобразить флоу
Обработать события флоу
Реагировать на действия кнопок Отправьте это своей 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

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

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

Гайды:

Обзор Observer mode
Реализация Observer mode
Регистрация транзакций в Observer mode Отправьте это своему 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

Checkpoint

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

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

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

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

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

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

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

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

Read these Adapty docs before writing code:
- https://adapty.io/docs/ru/ios-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, иначе события не будут появляться в дашборде.

Текстовые индексные файлы документации

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

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