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

Этот гайд проведёт вас через интеграцию Adapty в Unity-приложение шаг за шагом с помощью 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 и 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, мой placement 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 Unity SDK

Warning

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

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

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

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

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

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

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

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

Прежде чем переходить к коду, попросите LLM проанализировать ваш проект и составить план реализации. Если ваш AI-инструмент поддерживает режим планирования (например, режим plan в 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

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

Tip

Checkpoint

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

Гайды:

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

Checkpoint

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

Гайды:

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

Checkpoint

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

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 и Google Play Real-Time Developer Notifications в App settings → Android SDK.

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

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

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