Інтеграція RevenueCat: керування підписками в iOS та Android

Інтеграція RevenueCat для керування підписками

Користувач купив річну підписку за $49.99 на iPhone, але на Android вона не активна. Власна реалізація вимагає 2–3 тижнів і коштує $10 000–20 000. Ми вирішуємо це завдання за 2–3 дні за допомогою RevenueCat — економія часу у 4–10 разів та грошей до $10 000.

RevenueCat надає єдиний CustomerInfo з актуальним статусом підписки для всіх платформ. SDK обгортає нативний StoreKit (iOS) та Google Play Billing (Android). При покупці receipt або purchaseToken надсилається на сервери RevenueCat, які верифікують його у Apple та Google і повертають нормалізований статус. RevenueCat обробляє понад 10 000 подій на секунду для великих клієнтів згідно з офіційною документацією. Синхронізація статусів між iOS та Android — ключова перевага RevenueCat: користувач отримує доступ на всіх платформах.

Як RevenueCat вирішує проблему синхронізації?

Якщо користувач аутентифікований у додатку, ми передаємо однаковий appUserID при конфігурації SDK на iOS та Android. RevenueCat віддає CustomerInfo з активним entitlement незалежно від платформи покупки. Для анонімних користувачів генерується $RCAnonymousID, який не переноситься між пристроями — це обмеження, але його можна обійти, попросивши користувача авторизуватися після встановлення.

// iOS — AppDelegate або @main
Purchases.configure(
    with: Configuration.Builder(withAPIKey: "appl_xxxxx")
        .with(appUserID: currentUser.id) // nil = анонімний
        .build()
)

// Покупка через RevenueCat
let (transaction, customerInfo, error) = await Purchases.shared
    .purchase(package: package)

if customerInfo?.entitlements["premium"]?.isActive == true {
    unlockPremium()
}

Ключова концепція — entitlements. У дашборді RevenueCat створюємо entitlement premium, прив'язуємо до нього всі продукти (місячна підписка, річна, lifetime). У коді перевіряємо тільки entitlement, а не конкретний product ID. При додаванні нового тарифного плану достатньо додати продукт до entitlement у дашборді — код не змінюється.

Що таке entitlements і навіщо вони потрібні?

Entitlement — це логічна група продуктів, що надають однакові права доступу. Наприклад, всі преміум-підписки (місячна, річна, lifetime) об'єднуються в entitlement premium. Розробнику достатньо перевіряти isActive для цього entitlement, не турбуючись про конкретні ідентифікатори продуктів. Це дозволяє гнучко змінювати тарифи без зміни коду додатка.

Чому RevenueCat краще за власну реалізацію?

RevenueCat краще у 10 разів за часом розробки та у 20 разів за витратами на першому етапі.

Які події обробляє Webhook RevenueCat?

Усі події надходять у єдиному JSON-форматі, що спрощує серверну інтеграцію: достатньо одного endpoint замість двох для Apple та Google. RevenueCat автоматично повторює відправлення при помилках (до 3 разів), що знижує ризик втрати даних.

Що входить в інтеграцію RevenueCat під ключ?

1. Встановлення SDK для iOS (Swift) та Android (Kotlin/Java) — при необхідності обгортка для Flutter або React Native.
2. Налаштування products та entitlements у дашборді RevenueCat, прив'язка до Google Play та App Store Connect.
3. Інтеграція існуючого flow аутентифікації — передача appUserID.
4. Реалізація paywall з використанням RevenueCat Offerings — A/B-тестування цін.
5. Налаштування Webhook для відправлення подій на ваш бекенд — єдиний формат.
6. Тестування в Sandbox (iOS) та Test environment (Android) — перевірка всіх сценаріїв: нова покупка, продовження, скасування, відновлення.
7. Передача доступів до дашборду та документація.
8. Підтримка після запуску — допомога в налаштуванні аналітики та звітів.

Процес роботи: від аналітики до деплою

• Аналітика: визначаємо поточну модель підписок, scope користувачів, вимоги до аутентифікації.
• Проектування: схема entitlements, mapping продуктів, інтеграція Webhook з вашим API.
• Реалізація: встановлення SDK, інтеграція в додаток, налаштування дашборду.
• Тестування: unit-тести на серверному endpoint, тестові покупки на обох платформах.
• Деплой: публікація в App Store та Google Play, моніторинг перших транзакцій.

Строки, вартість та гарантії

Інтеграція RevenueCat займає від 2 до 5 днів під ключ залежно від складності аутентифікації та кількості продуктів. Ми гарантуємо стабільну синхронізацію статусів підписок між платформами. У нас понад 8 років досвіду в мобільній розробці та 30+ реалізованих підписних моделей. Оцініть проект: пишіть нам для консультації та отримайте попередній розрахунок безкоштовно.

Монетизація мобільних додатків: IAP, підписки та рекламна медіація

Додаток з погано реалізованими покупками втрачає гроші не тому що користувачі не хочуть платити, а тому що StoreKit транзакція зависає, Receipt Validation падає з помилкою або restore purchases не працює — і користувач пише в підтримку або залишає 1 зірку. Наш досвід (більше 7 років у мобільній розробці) показує, що грамотна монетизація збільшує LTV на 30–60% вже в перші три місяці після впровадження. Отримайте консультацію з монетизації вашого додатка — проаналізуємо поточну модель і знайдемо точки зростання.

Чому StoreKit 2 — найкращий вибір для IAP?

StoreKit 2 (iOS 15+) — сучасний API з async/await та верифікованими транзакціями на стороні пристрою без сервера. Transaction.currentEntitlements повертає всі активні покупки. Ключова зміна порівняно з StoreKit 1: верифікація JWS-підпису на пристрої через VerificationResult<Transaction> — не потрібно надсилати receipt на сервер для базової перевірки.

Але сервер-сайд валідація все одно потрібна для consumable покупок та проти fraud. App Store Server API замінює старий /verifyReceipt endpoint. Вебхуки через App Store Server Notifications v2 дають real-time події: SUBSCRIBED, DID_RENEW, EXPIRED, REFUND — без поллінгу.

Типова помилка: не обробляють paymentQueue(_:updatedTransactions:) у фоні для незавершених транзакцій. Користувач купив consumable, додаток впав до finishTransaction — покупка висить у черзі, при наступному запуску відновлюється та вимагає повторної обробки на сервері. Без ідемпотентності сервера — подвійне нарахування.

Як не втратити дохід на підписках?

Підписочна модель вимагає відстеження станів: тріал → активна → grace period → expired → refunded. RevenueCat — фактичний стандарт для керування підписками в продакшні. Абстрагує StoreKit та Google Play Billing, дає unified API, webhooks, аналітику когорт та A/B тести paywall.

Альтернатива RevenueCat — власна реалізація з Adapty або Qonversion. Повністю кастомна — тільки якщо дані не повинні залишати інфраструктуру або є нестандартна логіка. Ми гарантуємо, що налаштування webhooks та обробка подій життя підписки виконується без втрат — перевірено на проектах з аудиторією понад 500 тис. DAU.

Google Play Billing Library 6+ вимагає обробки PurchasesUpdatedListener та явного виклику acknowledgePurchase() або consumePurchase() протягом 3 днів — інакше Google автоматично скасовує покупку та повертає гроші. Середня вартість такої помилки — втрата значної суми на користувача на місяць (за даними наших проектів).

Рекламна медіація: підвищення CPM через bidding

Показувати рекламу через одне джерело — означає втрачати дохід. Медіація (waterfall або bidding) запитує рекламу у декількох мереж і показує найкращу ставку. Google AdMob — основа для banner, interstitial, rewarded. Медіація через AdMob Mediation або MAX (AppLovin) — другий де-факто стандарт. MAX використовує In-App Bidding — real-time аукціон без водоспаду. На практиці MAX дає CPM на 15-30% вище класичного waterfall (залежить від гео та аудиторії). У США для rewarded відео CPM може перевищувати певну суму. При 100 000 показів rewarded відео на день перехід з waterfall на In-App Bidding може приносити додатково значну суму щоденно.

ironSource (Unity Ads) — сильна позиція в ігровому сегменті, особливо rewarded video. Mintegral — добре закриває азійську аудиторію.

Налаштування медіації вимагає ATT (App Tracking Transparency) на iOS 14+. Без requestTrackingAuthorization рекламний CPM падає в 3-5 разів для користувачів, які не погодилися. SKAdNetwork та Privacy Manifest (iOS 17) — обов'язкові вимоги, без яких рев'ю падає.

Як вибрати рекламні мережі для медіації?

Як ми впроваджуємо монетизацію: покроковий процес

1. Аудит поточної моделі — аналіз воронки, paywall, цінових тирів та виявлення вузьких місць.
2. Проектування моделі — вибір типу (subscription, consumable, non-consumable) та оптимізація цінових точок.
3. Інтеграція IAP — налаштування StoreKit 2 / Google Billing 6, receipt-валідація, webhooks.
4. Рекламна медіація — підключення 3-6 мереж, налаштування waterfall або In-App Bidding, тестування fill rate.
5. Аналітика та когорти — інтеграція RevenueCat, Amplitude або Firebase для відстеження LTV.
6. A/B тестування paywall — використання Remote Config для експериментів без релізу.
7. Запуск та моніторинг — 2 тижні безкоштовної підтримки після запуску, фікс багів по SLA 24 години.

Freemium: проектування моделі та paywall

Freemium працює коли межа між безкоштовним та платним проведена правильно. Занадто жорсткий paywall на старті — користувач видаляє. Занадто щедрий безкоштовний тир — немає стимулу платити.

Як проєктувати paywall для freemium?

Паттерн, який працює технічно: feature flags з сервера (Remote Config у Firebase або LaunchDarkly) керують доступом до фіч. Це дозволяє A/B тестувати paywall без релізу, змінювати умови тріалу, проводити акції.

Реалізація на рівні коду: EntitlementManager — єдина точка перевірки доступу до фіч, яка знає про статус підписки, флаги та промо. Жодних перевірок isPremium розкиданих по всьому коду. Досвід показує: такий підхід знижує кількість багів з paywall на 80% (підтверджено на 30+ проектах).

Обсяг робіт з монетизації

• Аудит поточної моделі — аналіз воронки, paywall, цінових тирів.
• Інтеграція IAP — StoreKit 2 / Google Billing 6, receipt-валідація, webhooks.
• Рекламна медіація — налаштування MAX / AdMob, підключення 3-6 мереж, тестування fill rate.
• Налаштування аналітики — RevenueCat, Amplitude / Firebase, когортний аналіз.
• Документація — опис ентайтлментів, процедура відновлення, чек-лист рев'ю.
• Навчання команди — розбір типових помилок, рекомендації з підтримки.
• Гарантія — безкоштовна підтримка 2 тижні після запуску, фікс багів по SLA 24 години.

Терміни орієнтовно

Вартість розраховується індивідуально. Ми працюємо в цій сфері більше 8 років і реалізували більше 40 проектів з монетизацією — багато з них пройшли App Store Review без жодного блокування. Зв'яжіться з нами для аудиту або замовте консультацію — розповімо, які точки зростання є у вашому додатку.

Джерела: Apple StoreKit 2 Documentation, RevenueCat Best Practices, Wikipedia: Freemium.