Обзор Kotlin Multiplatform SDK

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

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

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

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

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

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. Профиль - Когда пользователи покупают продукт, их профилю присваивается уровень доступа, который вы используете для определения доступа к платным функциям.