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

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

Warning

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

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

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

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

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

Отправьте LLM:

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

Tip

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

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

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

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

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

Гайды:

Отправьте LLM:

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

Tip

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

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

Гайды:

Отправьте LLM:

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

Tip

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

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

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

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

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

Отправьте LLM:

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

Tip

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

Ожидаемый результат: После вызова Adapty.Identify("your-user-id") в разделе Profiles дашборда появляется ваш пользовательский ID.
Частая ошибка: Вызывайте 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 и Google Play Real-Time Developer Notifications в App settings → Android SDK.

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

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

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