Обзор Kotlin Multiplatform SDK | Документация Adapty
English 中文TürkçeРусскийEspañol日本語Tiếng Việt

Обзор Kotlin Multiplatform SDK

Release

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

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

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

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

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

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

Вот что мы разберём в этом руководстве по интеграции:

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

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

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

  • Пример приложения: Посмотрите наш полный пример с готовой настройкой
  • Видеоурок: Следите за пошаговым руководством по реализации ниже

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

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

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

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

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

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

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

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

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

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

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