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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Checkpoint

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

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

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

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

Гайды:

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

Checkpoint

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

Checkpoint

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

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

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

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

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

Read these Adapty docs before writing code:
- https://adapty.io/docs/ru/unity-check-subscription-status.md

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

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

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

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

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

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

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

Read these Adapty docs before writing code:
- https://adapty.io/docs/ru/unity-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 и Google Play Real-Time Developer Notifications в App settings → Android SDK.

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

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

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