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

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

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

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

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

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

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

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

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

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

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

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

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

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

2. Флоу и пейволы - Продукты в связке с настройками, прикреплённые к плейсменту. Есть два способа их создать, сравнение в разделе Флоу и пейволы:

   • Flow & Paywall Builder - Визуальный редактор без кода. Adapty сам отрисовывает UI и обрабатывает покупку.
   • Кастомные пейволы - Без визуальной настройки; UI вы строите в своём коде и сами вызываете makePurchase. См. Реализация кастомных пейволов.

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

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

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

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

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