Обзор Capacitor SDK | Документация Adapty

Обзор Capacitor SDK

Release

Добро пожаловать! Мы здесь, чтобы сделать встроенные покупки простыми и понятными 🚀

Мы создали Adapty Capacitor SDK, чтобы избавить вас от головной боли с встроенными покупками — и вы могли сосредоточиться на том, что у вас получается лучше всего: создавать классные приложения. Вот что мы берём на себя:

  • Управляйте покупками, валидацией чеков и подписками прямо из коробки
  • Создавайте и тестируйте пейволы без обновления приложения
  • Получайте детальную аналитику покупок без настройки — когорты, LTV, отток и воронки уже включены
  • Поддерживайте актуальный статус подписки пользователя во всех сессиях и на всех устройствах
  • Интегрируйте приложение с сервисами маркетинговой атрибуции и аналитики одной строкой кода

Прежде чем погружаться в код, вам нужно интегрировать Adapty с App Store Connect и Google Play Console, а затем настроить продукты в дашборде. Ознакомьтесь с нашим гайдом по быстрому старту, чтобы сначала всё настроить.

Начало работы

Автоматическая интеграция · Beta
Skill для интеграции Adapty SDK выполняет всю интеграцию из вашего AI-инструмента одной командой.

Вот что мы рассмотрим в этом гайде по интеграции:

  1. Установите и настройте SDK: Добавьте SDK как зависимость в проект и активируйте его в коде.
  2. Настройте покупки через пейволы: Настройте флоу покупки, чтобы пользователи могли приобретать продукты.
  3. Проверьте статус подписки: Автоматически проверяйте состояние подписки пользователя и управляйте его доступом к платному контенту.
  4. Идентифицируйте пользователей (опционально): Свяжите пользователей с их профилями Adapty, чтобы их данные корректно сохранялись на всех устройствах.

Смотрите в действии

Хотите увидеть, как всё работает вместе? Мы подготовили примеры:

Примеры приложений: Готовые примеры с полной настройкой:

Основные концепции

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

Главное преимущество подхода Adapty в том, что в коде приложения жёстко прописаны только плейсменты. Всё остальное — продукты, дизайн пейволов, цены и офферы — можно гибко настраивать прямо из дашборда Adapty без обновления приложения:

  1. Продукт — всё, что можно купить в вашем приложении: подписка, расходуемая покупка или пожизненный доступ.

  2. Флоу или пейвол — продукты с настройками, привязанные к плейсменту. Два варианта:

    • Флоу — визуальный no-code интерфейс, созданный во Flow Builder. Adapty отрисовывает UI и обрабатывает покупку за вас.
    • Пейвол — без визуальной настройки; вы создаёте UI в своём коде и сами вызываете makePurchase. См. Реализация пейволов вручную.

    В коде SDK оба варианта получают через один и тот же метод getFlow.

  3. Placement - Стратегическая точка в пользовательском пути, где вы хотите показать пейвол. Плейсменты отвечают на вопросы «где» и «когда» в вашей стратегии монетизации. Распространённые плейсменты:

    • main — основное место показа пейвола
    • onboarding — показывается во время онбординга пользователя
    • settings — доступен из настроек приложения

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

  4. Profile - Когда пользователи приобретают продукт, их профилю присваивается уровень доступа, который вы используете для определения доступа к платным функциям.