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

Эта страница описывает два способа интеграции Adapty в ваше iOS-приложение. Воспользуйтесь навыком SDK integration ниже для автоматического сквозного процесса или следуйте пошаговому руководству далее.

Используйте навык интеграции SDK (бета)

Навык adapty-sdk-integration skill автоматизирует интеграцию от начала до конца: настройка дашборда, установка SDK, пейвол и проверка на каждом этапе. Пошаговое руководство ниже — резервный вариант, если ваш инструмент не поддерживает формат Claude Skills.

Поддерживаемые инструменты: Claude Code, GitHub Copilot CLI, OpenAI Codex, Gemini CLI.

Установка

Выберите форму для своего инструмента. Полный список — в README скилла.

Claude Code: Выполните claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill, затем claude plugin install adapty-sdk-integration@adapty в терминале.
GitHub Copilot CLI: Выполните gh skill install adaptyteam/adapty-sdk-integration-skill.
Gemini CLI: Выполните gemini skills install https://github.com/adaptyteam/adapty-sdk-integration-skill.
OpenAI Codex или любой другой инструмент: Клонируйте репозиторий и скопируйте plugins/adapty-sdk-integration/skills/adapty-sdk-integration/ в директорию навыков вашего инструмента.

Запуск

В вашем проекте выполните /adapty-sdk-integration. Скилл определит вашу платформу и задаст несколько вопросов по настройке. Затем он проведёт вас через настройку дашборда, установку SDK, пейвол и верификацию — на каждом этапе подтягивая нужную документацию 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
Скопируйте публичный 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"]. Уровень доступа premium по умолчанию подходит для большинства приложений. Если платящие пользователи получают доступ к разным функциям в зависимости от продукта (например, план basic и план pro), создайте дополнительные уровни доступа до начала разработки.

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

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

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

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

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

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

Установка и настройка 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.

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

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

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

Гайды:

Включить покупки через пейволы (быстрый старт)
Получить пейволы Paywall Builder и их конфигурацию
Отобразить пейволы
Обработать события пейвола
Реагировать на действия кнопок Это сообщение предназначено для разработчиков, использующих LLM-ассистентов (например, GitHub Copilot, Cursor или ChatGPT) при написании кода с Adapty. Оно не является частью документации — просто скопируйте и отправьте его вашему 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

Checkpoint

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

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

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

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

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

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

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

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

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

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