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

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

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

Adapty требует предварительной настройки в дашборде — до написания кода SDK. Это можно сделать с помощью интерактивного LLM-скилла или вручную через дашборд.

Подход с использованием скилла (рекомендуется)

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

npx skills add adaptyteam/adapty-cli --skill adapty-cli

После добавления скилла запустите /adapty-cli в вашем агенте. Он проведёт вас через каждый шаг — в том числе укажет, когда нужно открыть дашборд для подключения стора.

Skills CLI не обновляет скилл автоматически. Чтобы получить последнюю версию, выполните npx skills update.

Подход через дашборд

Если вы предпочитаете настраивать всё вручную, вот что нужно сделать до написания кода. 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, мой ID плейсмента — 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 избавляет от необходимости вручную вставлять ссылки на документацию, порядок реализации имеет значение. Следуйте пошаговому руководству ниже и выполняйте шаги строго по порядку.

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

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

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

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

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

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

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

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

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

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

Tip

Checkpoint

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

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

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

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

Гайды:

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

Checkpoint

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

Гайды:

Send this to your 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

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

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

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, иначе события не будут отображаться в дашборде.

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

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

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