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

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

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

Навык adapty-sdk-integration автоматизирует интеграцию от начала до конца: настройка дашборда, установка 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 в вашем агенте. Он проведёт вас через каждый шаг — в том числе подскажет, когда нужно открыть дашборд для подключения сторов.

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

Если вы предпочитаете настраивать всё вручную, вот что нужно сделать до написания кода. Ваша языковая модель не может получить значения из дашборда за вас — их придётся предоставить самостоятельно.

Подключите сторы: В дашборде 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 сама подтягивает нужные документы в зависимости от вашего запроса — никаких ручных вставок ссылок не нужно.

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-инструмент поддерживает режим планирования (например, plan mode в Cursor или Claude Code), используйте его — так LLM сможет изучить структуру вашего проекта и документацию Adapty до того, как начнёт писать код.

Укажите LLM, какой подход вы используете для покупок — это определяет, какими гайдами ему следует руководствоваться:

Adapty Paywall Builder: Вы создаёте пейволы в конструкторе Adapty без кода, а SDK отображает их автоматически.
Вручную созданные пейволы: Вы сами строите интерфейс пейвола в коде, но используете Adapty для получения продуктов и обработки покупок.
Режим наблюдателя: Вы сохраняете существующую инфраструктуру покупок и используете 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 Console отображается лог активации Adapty.
Частая проблема: “Public API key is missing” → убедитесь, что заменили placeholder на реальный ключ из App settings.

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

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

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

Гайды:

Checkpoint

Ожидается: пейвол отображается с настроенными продуктами. Нажатие на продукт открывает диалог покупки в песочнице.
Частая проблема: пустой пейвол или ошибка GetPaywall → убедитесь, что 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

Checkpoint

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

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

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

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

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