Скиллы покрывают интеграцию SDK, создание flow и paywall, проверку перед публикацией, миграцию placement и многое другое. Опишите задачу обычными словами — агент сам выберет нужный скилл.
Чтобы использовать флоу Adapty, не обязательно переносить покупки в Adapty. В режиме Observer ваш код по-прежнему обрабатывает все покупки, а Adapty отрисовывает пейвол или онбординг, решает, кому его показывать, проводит A/B-тесты и формирует отчёты по результатам.
В этом гайде разбирается, что меняется, что остаётся прежним и что потребуется для настройки.
Tip
Не знакомы с флоу? Flow & Paywall Builder расскажет, что можно создать, прежде чем приступать к настройке.
Ваша биллинговая логика не меняется. 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:
Передайте --period lifetime для разовой покупки, а --stripe-product-id с --stripe-price-id (или пару Paddle) — для того, что продаёте через веб. products create содержит полный список флагов. Идентификаторы продуктов стора нельзя изменить после создания, поэтому если нужно привязать продукт к другому продукту стора — придётся создавать новый продукт.
Warning
Элемент продукта без назначенного продукта блокирует сохранение и публикацию — вы узнаете об этом прямо в билдере. Действие Purchase без установленного продукта сохраняется нормально, но не работает на устройстве — кнопка просто ничего не делает. Обязательно задайте продукт для каждого действия Purchase.
Или пропустите продукты и пишите цены как статический текст
Флоу без элемента продукта сохраняется и публикуется, поэтому вы можете вручную вписать цены в текст и позволить своему коду решать, что именно покупается по нажатию. Это обойдётся вам следующим:
Вы вручную поддерживаете цены в двух местах — в сторе и в тексте флоу — и они расходятся, как только вы меняете одно из них.
Нет A/B-тестов цен, а именно для этого флоу и нужен.
Графики и интеграции группируют выручку менее чисто, так как Adapty узнаёт продукт только из транзакции, которую вы передаёте.
Ваш код сопоставляет каждый нажатый элемент с продуктом вместо того, чтобы получать его из флоу.
Запустите флоу и выполните покупку в своём коде. Adapty передаёт нажатие кнопки покупки в обработчик, который вы регистрируете.
Сообщите о транзакции, указав идентификатор варианта пейвола купленного продукта, чтобы покупка попала в аналитику с атрибуцией на пейвол, через который она была совершена.
Шаги 4 и 5 различаются в зависимости от платформы. В каждом фрагменте flow — это AdaptyFlow, полученный для плейсмента, product — это AdaptyPaywallProduct, на который нажал пользователь, а myPurchaseApi или yourBillingClient — это заменитель кода покупки, который у вас уже есть.
Передайте AdaptyObserverModeResolver в getFlowConfiguration(forFlow:observerModeResolver:). Adapty вызывает resolver при нажатии на покупку вместо того, чтобы выполнять покупку самостоятельно.
final class MyObserverModeResolver: AdaptyObserverModeResolver { func observerMode( didInitiatePurchase product: AdaptyPaywallProduct, onStartPurchase: @MainActor @Sendable @escaping () -> Void, onFinishPurchase: @MainActor @Sendable @escaping () -> Void ) { Task { @MainActor in onStartPurchase() // the flow shows its loading indicator do { // your own purchase code, returning StoreKit's VerificationResult<Transaction> let verificationResult = try await myPurchaseApi.purchase(product.vendorProductId) try await Adapty.reportTransaction(verificationResult, withVariationId: product.variationId) } catch { // handle the error } onFinishPurchase() // the flow hides the loading indicator } } func observerModeDidInitiateRestorePurchases( onStartRestore: @MainActor @Sendable @escaping () -> Void, onFinishRestore: @MainActor @Sendable @escaping () -> Void ) { Task { @MainActor in onStartRestore() try? await myPurchaseApi.restore() onFinishRestore() } }}
Then present the flow with the resolver attached:
do { let flowConfiguration = try await AdaptyUI.getFlowConfiguration( forFlow: flow, observerModeResolver: MyObserverModeResolver() ) let visualFlow = try AdaptyUI.flowController( with: flowConfiguration, delegate: self // an AdaptyFlowControllerDelegate ) present(visualFlow, animated: true)} catch { // handle the error}
Передайте AdaptyUiObserverModeHandler при создании представления флоу — этот обработчик является параметром AdaptyUI.getFlowView, AdaptyFlowScreen и AdaptyFlowView. Его метод onPurchaseInitiated получает нажатие на кнопку покупки. getRestoreHandler необязателен — без него восстановление остаётся за SDK.
Warning
Всегда передавайте обработчик. Без него SDK завершает покупку самостоятельно — пользователь получает списание через Adapty, и об этом сообщается только в логах. На iOS то же упущение приведёт к ошибке при покупке.
Передайте onObserverPurchaseInitiated и onObserverRestoreInitiated как пропсы в AdaptyFlowView или зарегистрируйте их через view.setEventHandlers.
function MyFlow({ flow }) { const onObserverPurchaseInitiated = useCallback< FlowEventHandlers['onObserverPurchaseInitiated'] >((product, onStartPurchase, onFinishPurchase) => { onStartPurchase(); // the flow shows its loading indicator myPurchaseApi(product.vendorProductId) .then((transactionId) => adapty.reportTransaction(transactionId, product.variationId)) .finally(() => onFinishPurchase()); // the flow hides the loading indicator }, []); const onObserverRestoreInitiated = useCallback< FlowEventHandlers['onObserverRestoreInitiated'] >((onStartRestore, onFinishRestore) => { onStartRestore(); myRestoreApi().finally(() => onFinishRestore()); }, []); return ( <AdaptyFlowView flow={flow} onObserverPurchaseInitiated={onObserverPurchaseInitiated} onObserverRestoreInitiated={onObserverRestoreInitiated} // ... your other event handlers /> );}
Во встроенном компоненте возвращаемое значение обработчика не закрывает флоу — размонтируйте компонент самостоятельно после успешной покупки или восстановления.
Зарегистрируйте резолвер через AdaptyUI().setObserverModeResolver — именно на AdaptyUI(), а не на Adapty. Реализуйте оба метода: observerModeDidInitiatePurchase и observerModeDidInitiateRestore; оба обязательны, и каждый получает вью флоу первым аргументом.
Зарегистрируйте резолвер с помощью Adapty.SetObserverModeResolver — на Adapty, а не на AdaptyUI. Реализуйте IAdaptyUIObserverModeResolver с методами FlowViewDidInitiatePurchase и FlowViewDidInitiateRestore; имена колбэков в Unity отличаются от других платформ.
using System;using AdaptySDK;public class MyObserverModeResolver : IAdaptyUIObserverModeResolver{ public void FlowViewDidInitiatePurchase( AdaptyUIFlowView view, AdaptyPaywallProduct product, Action onStartPurchase, Action onFinishPurchase ) { onStartPurchase(); // the flow shows its loading indicator MyPurchaseApi.Purchase(product.VendorProductId, (transactionId, purchaseError) => { if (purchaseError != null) { onFinishPurchase(); return; } Adapty.ReportTransaction(transactionId, product.PaywallVariationId, (reportError) => { onFinishPurchase(); // the flow hides the loading indicator }); }); } public void FlowViewDidInitiateRestore( AdaptyUIFlowView view, Action onStartRestore, Action onFinishRestore ) { onStartRestore(); MyPurchaseApi.Restore((restoreError) => onFinishRestore()); }}
Зарегистрируйте resolver один раз, до отображения любого флоу:
Зарегистрируйте resolver с помощью AdaptyUI.setObserverModeResolver. Реализуйте оба метода — observerModeDidInitiatePurchase и observerModeDidInitiateRestore; оба обязательны, и каждый принимает представление флоу в качестве первого аргумента.
class MyObserverModeResolver( private val scope: CoroutineScope,) : AdaptyUIObserverModeResolver { override fun observerModeDidInitiatePurchase( view: AdaptyUIFlowView, product: AdaptyPaywallProduct, onStartPurchase: () -> Unit, onFinishPurchase: () -> Unit, ) { onStartPurchase() // the flow shows its loading indicator scope.launch { val transactionId = myPurchaseApi(product.vendorProductId) Adapty.reportTransaction( transactionId = transactionId, variationId = product.paywallVariationId, ).onError { error -> // handle the error } onFinishPurchase() // the flow hides the loading indicator } } override fun observerModeDidInitiateRestore( view: AdaptyUIFlowView, onStartRestore: () -> Unit, onFinishRestore: () -> Unit, ) { onStartRestore() scope.launch { myRestoreApi() onFinishRestore() } }}
Зарегистрируйте resolver один раз, до того как показывать какой-либо флоу:
Встройте onObserverPurchaseInitiated и onObserverRestoreInitiated через view.setEventHandlers в каждое создаваемое вами флоу — в Capacitor нет отдельного объекта resolver, и оба обработчика входят в стандартные обработчики событий.
const view = await createFlowView(flow);const unsubscribe = await view.setEventHandlers({ onObserverPurchaseInitiated(product, onStartPurchase, onFinishPurchase) { onStartPurchase(); // the flow shows its loading indicator myPurchaseApi(product.vendorProductId) .then((transactionId) => adapty.reportTransaction({ transactionId, variationId: product.variationId }), ) .finally(() => onFinishPurchase()); // the flow hides the loading indicator return false; // keep the flow open; dismiss it yourself after success }, onObserverRestoreInitiated(onStartRestore, onFinishRestore) { onStartRestore(); myRestoreApi().finally(() => onFinishRestore()); return false; },});
Adapty не предоставляет доступ: он не реагирует на события покупки выдачей или ограничением платного доступа и не управляет продлениями или повторными попытками списания. Уровни доступа остаются в зоне ответственности вашего кода.
Ваш код сам закрывает транзакции: Adapty не завершает и не подтверждает покупки, которые совершает ваш код, — закрытие каждой из них по-прежнему ваша задача.
Отчётность обязательна: variationId, который вы передаёте вместе с отчётом, — единственная связь между покупкой и флоу, который её инициировал. Если не отправлять отчёт по каждой транзакции, метрики флоу и результаты A/B-тестов окажутся неверными.
Если вы уже используете другого вендора
Observer mode требует только одного: чтобы покупка совершалась в вашем коде — неважно, чей SDK при этом вызывается. Флоу работают поверх RevenueCat, Superwall или Qonversion точно так же, как поверх вашего собственного кода на StoreKit или Billing Library.
Три решения, которые нужно принять перед релизом:
Одна система завершает каждую транзакцию: наиболее распространённая ошибка — когда два SDK одновременно завершают одну и ту же покупку.
Одна система управляет доступом: в режиме Observer Adapty ничего не предоставляет, поэтому оставьте уровни доступа там, где они есть.
Каждая покупка сообщается один раз: если одна и та же транзакция передаётся из двух мест, это искажает аналитику.
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, его история и интеграции никуда не переезжают.