Использование флоу Adapty с вашей собственной платёжной системой

Чтобы использовать флоу Adapty, не обязательно переносить покупки в Adapty. В режиме Observer ваш код по-прежнему обрабатывает все покупки, а Adapty отрисовывает пейвол или онбординг, решает, кому его показывать, проводит A/B-тесты и формирует отчёты по результатам.

В этом гайде разбирается, что меняется, что остаётся прежним и что потребуется для настройки.

Tip

Не знакомы с флоу? Flow & Paywall Builder расскажет, что можно создать, прежде чем приступать к настройке.

Что остаётся за вами, что берёт на себя Adapty

Ваш код отвечает за:

  • Вызов покупки
  • Завершение и подтверждение транзакций
  • Выдачу и отзыв доступа
  • Возобновления и повторные попытки списания

Adapty берёт на себя:

Ваша биллинговая логика не меняется. Adapty отрисовывает флоу и передаёт нажатие кнопки покупки в ваш код, который и выполняет списание.

Создайте продукты в Adapty

Пропустите этот раздел, если ни один экран во флоу не показывает цену и не предполагает покупку — флоу только из экранов онбординга не требует продуктов в Adapty.

Как только какой-либо экран предлагает продукты, создайте продукт в Adapty для каждой подписки или разовой покупки. Флоу берёт цену для карточки из продукта, поэтому карточка отображает актуальную цену из стора, вы можете проводить A/B-тесты этой цены, а Adapty группирует выручку по продуктам в аналитике.

Продукт в Adapty указывает на продукт в сторе, который вы уже продаёте, поэтому его создание не затрагивает биллинг: все списания по-прежнему выполняет ваш код. Каждый продукт привязывается к уровню доступа, и в режиме Observer Adapty его не выдаёт — управление доступом остаётся на стороне вашего кода, — но уровень доступа всё равно нужен.

Adapty CLI позволяет создавать продукты без открытия дашборда. Установите его (Node.js 18 или выше) и войдите в систему:

npm install -g adapty
adapty auth login

Получите ID приложения, затем уровень доступа для привязки — в каждом новом приложении уже есть premium:

adapty apps list
adapty access-levels list --app <app-id>

Затем создайте один продукт Adapty для каждого продукта в сторе, используя идентификаторы продуктов из App Store Connect и Google Play Console:

adapty products create --app <app-id> --title "Monthly" --access-level-id <access-level-id> --period monthly --ios-product-id com.example.monthly --android-product-id com.example.monthly --android-base-plan-id monthly

Передайте --period lifetime для разовой покупки, а --stripe-product-id с --stripe-price-id (или пару Paddle) — для того, что продаёте через веб. products create содержит полный список флагов. Идентификаторы продуктов стора нельзя изменить после создания, поэтому если нужно привязать продукт к другому продукту стора — придётся создавать новый продукт.

Warning

Элемент продукта без назначенного продукта блокирует сохранение и публикацию — вы узнаете об этом прямо в билдере. Действие Purchase без установленного продукта сохраняется нормально, но не работает на устройстве — кнопка просто ничего не делает. Обязательно задайте продукт для каждого действия Purchase.

Или пропустите продукты и пишите цены как статический текст

Флоу без элемента продукта сохраняется и публикуется, поэтому вы можете вручную вписать цены в текст и позволить своему коду решать, что именно покупается по нажатию. Это обойдётся вам следующим:

  • Вы вручную поддерживаете цены в двух местах — в сторе и в тексте флоу — и они расходятся, как только вы меняете одно из них.
  • Нет A/B-тестов цен, а именно для этого флоу и нужен.
  • Графики и интеграции группируют выручку менее чисто, так как Adapty узнаёт продукт только из транзакции, которую вы передаёте.
  • Ваш код сопоставляет каждый нажатый элемент с продуктом вместо того, чтобы получать его из флоу.

Настройка

  1. Активируйте SDK в режиме Observer. Включите observerMode при настройке SDK: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
  2. Создайте продукты в Adapty, если только флоу не обходится без отображения цены. Одна команда CLI на каждый продукт — см. Создание продуктов в Adapty.
  3. Создайте флоу. См. Flow & Paywall Builder для работы с экранами, настройка покупок для продуктов на экране пейвола и создание плейсмента, чтобы определить, где флоу будет появляться в вашем приложении.
  4. Запустите флоу и выполните покупку в своём коде. Adapty передаёт нажатие кнопки покупки в обработчик, который вы регистрируете.
  5. Сообщите о транзакции, указав идентификатор варианта пейвола купленного продукта, чтобы покупка попала в аналитику с атрибуцией на пейвол, через который она была совершена.

Шаги 4 и 5 различаются в зависимости от платформы. В каждом фрагменте flow — это AdaptyFlow, полученный для плейсмента, product — это AdaptyPaywallProduct, на который нажал пользователь, а myPurchaseApi или yourBillingClient — это заменитель кода покупки, который у вас уже есть.

Ограничения режима Observer

  • Adapty не предоставляет доступ: он не реагирует на события покупки выдачей или ограничением платного доступа и не управляет продлениями или повторными попытками списания. Уровни доступа остаются в зоне ответственности вашего кода.
  • Ваш код сам закрывает транзакции: Adapty не завершает и не подтверждает покупки, которые совершает ваш код, — закрытие каждой из них по-прежнему ваша задача.
  • Отчётность обязательна: variationId, который вы передаёте вместе с отчётом, — единственная связь между покупкой и флоу, который её инициировал. Если не отправлять отчёт по каждой транзакции, метрики флоу и результаты A/B-тестов окажутся неверными.

Если вы уже используете другого вендора

Observer mode требует только одного: чтобы покупка совершалась в вашем коде — неважно, чей SDK при этом вызывается. Флоу работают поверх RevenueCat, Superwall или Qonversion точно так же, как поверх вашего собственного кода на StoreKit или Billing Library.

Три решения, которые нужно принять перед релизом:

  • Одна система завершает каждую транзакцию: наиболее распространённая ошибка — когда два SDK одновременно завершают одну и ту же покупку.
  • Одна система управляет доступом: в режиме Observer Adapty ничего не предоставляет, поэтому оставьте уровни доступа там, где они есть.
  • Каждая покупка сообщается один раз: если одна и та же транзакция передаётся из двух мест, это искажает аналитику.

Если вы хотите полностью перейти с другого вендора, см. Миграция с RevenueCat или Миграция с Superwall.

Пусть Adapty выполняет покупки

Tip

В этом случае ваше приложение совершает покупки через Adapty — стандартная интеграция. Следуйте быстрому старту или миграции с RevenueCat, либо передайте задачу скиллу интеграции SDK.

Observer mode — это самый быстрый способ начать работу. Если вы хотите сохранить аналитику RevenueCat, но избежать ограничений Observer mode, просто поменяйте их ролями: Adapty работает в полном режиме и проводит все покупки, а RevenueCat работает в своём собственном Observer mode и записывает покупки, которые совершает Adapty.

Adapty при этом знает, какой флоу, плейсмент и вариант A/B-теста привёл к каждому списанию, и предоставляет уровни доступа, а также обрабатывает обновления подписок, повторные попытки списания и возвраты.

На стороне RevenueCat при настройке SDK укажите, что покупки завершаются вашим приложением: .myApp на iOS, MY_APP на Android. В документации RevenueCat Using the SDK with your own IAP code описана конфигурация для каждой платформы, версия StoreKit, необходимая для iOS, и вызов syncPurchases(), который подтягивает уже совершённые покупки. Передайте обоим SDK одинаковый идентификатор пользователя — customer user ID в Adapty и appUserID в RevenueCat — иначе в дашбордах будут разные пользователи.

Warning

Эта схема переводит уровни доступа RevenueCat в подчинённую роль: теперь источником истины становятся уровни доступа Adapty. RevenueCat продолжает вести наблюдение, его дашборд продолжает собирать статистику, но информацию о каждой покупке он теперь получает из вторых рук — в рамках ограничений, которые описывает его собственная документация. Всё, что сегодня читает данные об entitlements из RevenueCat — ваше приложение, бэкенд, веб- или десктопная сборка — должно либо перейти на Adapty, либо работать с копией этих данных. Решите этот вопрос до релиза. Всё остальное остаётся на месте: аккаунт RevenueCat, его история и интеграции никуда не переезжают.