--- title: "Интеграция Adapty в приложение на Capacitor с помощью ИИ" description: "Пошаговое руководство по интеграции Adapty в приложение на Capacitor с использованием Cursor, Context7, ChatGPT, Claude и других ИИ-инструментов." --- Этот гайд поможет вам интегрировать Adapty в приложение на Capacitor с помощью LLM. Сначала вы настроите дашборд Adapty, затем пройдёте каждый этап реализации, отправляя нужные ссылки на документацию вашему LLM. В конце — рекомендации по настройке ИИ-инструментов для работы с документацией Adapty. :::tip Скопируйте всю эту страницу в формате Markdown и вставьте в ваш LLM — нажмите **Copy for LLM** в верхней части страницы или откройте [версию .md](https://adapty.io/docs/ru/adapty-cursor-capacitor.md). LLM использует ссылки из гайда и контрольные точки, чтобы провести вас через каждый этап. ::: ## Перед началом: настройка дашборда \{#before-you-start-dashboard-setup\} Adapty требует предварительной настройки дашборда перед написанием кода. Это можно сделать с помощью интерактивного скилла для LLM или вручную через дашборд. ### Подход через скилл (рекомендуется) \{#skill-approach-recommended\} Скилл Adapty CLI позволяет вашему LLM напрямую настраивать приложение, продукты, уровни доступа, пейволы и плейсменты — без необходимости открывать дашборд на каждом шаге. Вам нужно только [подключить сторы](integrate-payments) в дашборде. ``` npx skills add adaptyteam/adapty-cli --skill adapty-cli ``` После добавления скилла запустите `/adapty-cli` в вашем агенте. Он проведёт вас через каждый шаг — в том числе укажет, когда нужно открыть дашборд для подключения сторов. ### Подход через дашборд \{#dashboard-approach\} Если вы предпочитаете настраивать всё вручную, вот что нужно сделать до написания кода. Ваш LLM не может самостоятельно получить значения из дашборда — вам придётся предоставить их самостоятельно. 1. **Подключите сторы**: В дашборде Adapty перейдите в **App settings → General**. Подключите App Store и Google Play, если ваше приложение на Capacitor поддерживает обе платформы. Это обязательное условие для работы покупок. [Подключить сторы](integrate-payments) 2. **Скопируйте публичный SDK-ключ**: В дашборде Adapty перейдите в **App settings → General** и найдите раздел **API keys**. В коде это строка, которую вы передаёте в `adapty.activate()`. 3. **Создайте хотя бы один продукт**: В дашборде Adapty перейдите на страницу **Products**. В коде продукты не указываются напрямую — Adapty передаёт их через пейволы. [Добавить продукты](quickstart-products) 4. **Создайте пейвол и плейсмент**: В дашборде Adapty создайте пейвол на странице **Paywalls**, затем привяжите его к плейсменту на странице **Placements**. В коде идентификатор плейсмента — это строка, которую вы передаёте в `adapty.getPaywall()`. [Создать пейвол](quickstart-paywalls) 5. **Настройте уровни доступа**: В дашборде Adapty настройте уровни доступа для каждого продукта на странице **Products**. В коде это строка, которую вы проверяете в `profile.accessLevels['premium']?.isActive`. Уровень доступа `premium` по умолчанию подходит большинству приложений. Если пользователи получают доступ к разным функциям в зависимости от продукта (например, план `basic` и план `pro`), [создайте дополнительные уровни доступа](assigning-access-level-to-a-product) до начала разработки. :::tip Как только всё пять пунктов готовы, можно писать код. Скажите вашему LLM: «Мой публичный SDK-ключ — X, идентификатор плейсмента — Y», чтобы он сгенерировал корректный код инициализации и получения пейвола. ::: ### Настройте по мере готовности \{#set-up-when-ready\} Это необязательно для начала разработки, но пригодится по мере развития интеграции: - **A/B-тесты**: Настраиваются на странице **Placements**. Изменений в коде не требуется. [A/B-тесты](ab-tests) - **Дополнительные пейволы и плейсменты**: Добавьте вызовы `getPaywall` с разными идентификаторами плейсментов. - **Интеграции аналитики**: Настраиваются на странице **Integrations**. Конфигурация зависит от интеграции. См. [интеграции аналитики](analytics-integration) и [интеграции атрибуции](attribution-integration). ## Передайте документацию Adapty вашему LLM \{#feed-adapty-docs-to-your-llm\} ### Используйте Context7 (рекомендуется) \{#use-context7-recommended\} [Context7](https://context7.com) — MCP-сервер, который даёт вашему LLM прямой доступ к актуальной документации Adapty. LLM автоматически находит нужные разделы на основе вашего запроса — вручную вставлять ссылки не нужно. Context7 работает с **Cursor**, **Claude Code**, **Windsurf** и другими MCP-совместимыми инструментами. Для настройки выполните: ``` npx ctx7 setup ``` Команда определяет ваш редактор и настраивает сервер Context7. Для ручной настройки смотрите [репозиторий Context7 на GitHub](https://github.com/upstash/context7). После настройки указывайте библиотеку Adapty в своих запросах: ``` Use the adaptyteam/adapty-docs library to look up how to install the Capacitor SDK ``` :::warning Даже если Context7 избавляет от необходимости вставлять ссылки вручную, порядок реализации имеет значение. Следуйте [пошаговому руководству по реализации](#implementation-walkthrough) ниже строго по шагам, чтобы всё работало корректно. ::: ### Используйте документацию в виде обычного текста \{#use-plain-text-docs\} Любую страницу документации Adapty можно открыть в виде обычного Markdown. Добавьте `.md` в конец URL или нажмите **Copy for LLM** под заголовком статьи. Например: [adapty-cursor-capacitor.md](https://adapty.io/docs/ru/adapty-cursor-capacitor.md). Каждый этап [пошагового руководства](#implementation-walkthrough) ниже содержит блок «Отправьте это вашему LLM» со ссылками `.md` для вставки. Если нужно передать сразу больше документации, смотрите [индексные файлы и платформенные подмножества](#plain-text-doc-index-files) ниже. ## Пошаговое руководство по реализации \{#implementation-walkthrough\} Дальше в этом гайде — интеграция Adapty в порядке реализации. Для каждого этапа указаны документы для LLM, ожидаемый результат и типичные проблемы. ### Спланируйте интеграцию \{#plan-your-integration\} Прежде чем приступать к коду, попросите LLM проанализировать ваш проект и составить план реализации. Если ваш ИИ-инструмент поддерживает режим планирования (например, plan mode в Cursor или Claude Code), используйте его — так LLM сможет изучить структуру вашего проекта и документацию Adapty до написания кода. Сообщите LLM, какой подход к покупкам вы используете — это определяет, какие гайды ему нужно изучить: - [**Adapty Paywall Builder**](adapty-paywall-builder): Вы создаёте пейволы в no-code конструкторе Adapty, а SDK отображает их автоматически. - [**Пейволы, созданные вручную**](capacitor-making-purchases): Вы создаёте собственный интерфейс пейвола в коде, но используете Adapty для получения продуктов и обработки покупок. - [**Observer mode**](observer-vs-full-mode): Вы сохраняете существующую инфраструктуру покупок и используете Adapty только для аналитики и интеграций. Не знаете, что выбрать? Прочитайте [сравнительную таблицу в quickstart](capacitor-quickstart-paywalls). ### Установите и настройте SDK \{#install-and-configure-the-sdk\} Добавьте зависимость Adapty SDK через npm и активируйте её с помощью публичного SDK-ключа. Это основа — без неё ничто другое не работает. **Гайд:** [Установка и настройка Adapty SDK](sdk-installation-capacitor) Отправьте это вашему LLM: ``` Read these Adapty docs before writing code: - https://adapty.io/docs/ru/sdk-installation-capacitor.md ``` :::tip[Контрольная точка] - **Ожидаемый результат:** Приложение собирается и запускается на iOS и Android. В консоли отображается лог активации Adapty. - **Частая ошибка:** «Public API key is missing» → убедитесь, что вы заменили заглушку реальным ключом из App settings. ::: ### Показывайте пейволы и обрабатывайте покупки \{#show-paywalls-and-handle-purchases\} Получите пейвол по идентификатору плейсмента, отобразите его и обработайте события покупок. Нужные гайды зависят от выбранного подхода к покупкам. Тестируйте каждую покупку в песочнице по мере разработки — не откладывайте на конец. Инструкции по настройке см. в [Тестирование покупок в песочнице](test-purchases-in-sandbox). **Гайды:** - [Включение покупок с помощью пейволов (quickstart)](capacitor-quickstart-paywalls) - [Получение пейволов Paywall Builder и их конфигурации](capacitor-get-pb-paywalls) - [Отображение пейволов](capacitor-present-paywalls) - [Обработка событий пейвола](capacitor-handling-events) - [Реагирование на действия кнопок](capacitor-handle-paywall-actions) Отправьте это вашему LLM: ``` Read these Adapty docs before writing code: - https://adapty.io/docs/ru/capacitor-quickstart-paywalls.md - https://adapty.io/docs/ru/capacitor-get-pb-paywalls.md - https://adapty.io/docs/ru/capacitor-present-paywalls.md - https://adapty.io/docs/ru/capacitor-handling-events.md - https://adapty.io/docs/ru/capacitor-handle-paywall-actions.md ``` :::tip[Контрольная точка] - **Ожидаемый результат:** Пейвол отображается с настроенными продуктами. Нажатие на продукт вызывает диалог покупки в песочнице. - **Частая ошибка:** Пустой пейвол или ошибка `getPaywall` → убедитесь, что идентификатор плейсмента точно совпадает с указанным в дашборде и плейсменту назначена аудитория. ::: **Гайды:** - [Включение покупок в собственном пейволе (quickstart)](capacitor-quickstart-manual) - [Получение пейволов и продуктов](fetch-paywalls-and-products-capacitor) - [Отображение пейвола, созданного через Remote Config](present-remote-config-paywalls-capacitor) - [Совершение покупок](capacitor-making-purchases) - [Восстановление покупок](capacitor-restore-purchase) Отправьте это вашему LLM: ``` Read these Adapty docs before writing code: - https://adapty.io/docs/ru/capacitor-quickstart-manual.md - https://adapty.io/docs/ru/fetch-paywalls-and-products-capacitor.md - https://adapty.io/docs/ru/present-remote-config-paywalls-capacitor.md - https://adapty.io/docs/ru/capacitor-making-purchases.md - https://adapty.io/docs/ru/capacitor-restore-purchase.md ``` :::tip[Контрольная точка] - **Ожидаемый результат:** Ваш пейвол отображает продукты, полученные из Adapty. Нажатие на продукт вызывает диалог покупки в песочнице. - **Частая ошибка:** Пустой массив продуктов → убедитесь, что в дашборде пейволу назначены продукты и плейсменту задана аудитория. ::: **Гайды:** - [Обзор Observer mode](observer-vs-full-mode) - [Реализация Observer mode](implement-observer-mode-capacitor) - [Передача транзакций в Observer mode](report-transactions-observer-mode-capacitor) Отправьте это вашему 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-capacitor.md - https://adapty.io/docs/ru/report-transactions-observer-mode-capacitor.md ``` :::tip[Контрольная точка] - **Ожидаемый результат:** После покупки в песочнице через существующий механизм покупок транзакция появляется в **Event Feed** дашборда Adapty. - **Частая ошибка:** Нет событий → убедитесь, что вы передаёте транзакции в Adapty и серверные уведомления настроены для обоих сторов. ::: ### Проверьте статус подписки \{#check-subscription-status\} После покупки проверьте профиль пользователя на наличие активного уровня доступа, чтобы открыть доступ к premium-контенту. **Гайд:** [Проверка статуса подписки](capacitor-check-subscription-status) Отправьте это вашему LLM: ``` Read these Adapty docs before writing code: - https://adapty.io/docs/ru/capacitor-check-subscription-status.md ``` :::tip[Контрольная точка] - **Ожидаемый результат:** После покупки в песочнице `profile.accessLevels['premium']?.isActive` возвращает `true`. - **Частая ошибка:** Пустой `accessLevels` после покупки → убедитесь, что продукту назначен уровень доступа в дашборде. ::: ### Идентифицируйте пользователей \{#identify-users\} Привяжите аккаунты пользователей вашего приложения к профилям Adapty, чтобы покупки сохранялись на всех устройствах. :::important Пропустите этот шаг, если в вашем приложении нет аутентификации. ::: **Гайд:** [Идентификация пользователей](capacitor-quickstart-identify) Отправьте это вашему LLM: ``` Read these Adapty docs before writing code: - https://adapty.io/docs/ru/capacitor-quickstart-identify.md ``` :::tip[Контрольная точка] - **Ожидаемый результат:** После вызова `adapty.identify()` в разделе **Profiles** дашборда отображается ваш кастомный идентификатор пользователя. - **Частая ошибка:** Вызывайте `identify` после активации, но до получения пейволов — иначе покупки будут привязаны к анонимному профилю. ::: ### Подготовьтесь к релизу \{#prepare-for-release\} Когда интеграция работает в песочнице, пройдитесь по чеклисту релиза и убедитесь, что всё готово к production. **Гайд:** [Чеклист релиза](release-checklist) Отправьте это вашему 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**. ::: ## Индексные файлы с документацией в виде обычного текста \{#plain-text-doc-index-files\} Если вам нужно дать LLM более широкий контекст помимо отдельных страниц, мы предоставляем индексные файлы, которые содержат список или полное содержимое документации Adapty: - [`llms.txt`](https://adapty.io/docs/ru/llms.txt): Список всех страниц со ссылками `.md`. [Формирующийся стандарт](https://llmstxt.org/) для доступа к сайтам из LLM. Обратите внимание: для некоторых ИИ-агентов (например, ChatGPT) потребуется скачать `llms.txt` и загрузить файл в чат. - [`llms-full.txt`](https://adapty.io/docs/ru/llms-full.txt): Вся документация Adapty в одном файле. Очень большой объём — используйте только когда нужна полная картина. - Для Capacitor: [`capacitor-llms.txt`](https://adapty.io/docs/ru/capacitor-llms.txt) и [`capacitor-llms-full.txt`](https://adapty.io/docs/ru/capacitor-llms-full.txt): Подмножества документации для конкретной платформы, которые экономят токены по сравнению с полным сайтом.