RevenueCat: jak nastavit předplatné v iOS aplikaci

Proč jít přes RevenueCat, a ne jen přes StoreKit

StoreKit, framework od Applu, ti umožní prodávat předplatné bez jakékoli služby třetí strany. Jenže pro začátečníka je napsat si sám celou logiku nákupu, obnovení a ověřování přístupových práv hromada kódu na údržbu. A k tomu okrajové případy, na které se snadno zapomene: změna zařízení, vypršení, refundace.

RevenueCat se postaví mezi App Store Connect a tvoji aplikaci: načte tvoje produkty, spravuje aktivní předplatná a tuhle vrstvu psát nemusíš. Cenu a nabídky máš pořád pod kontrolou z dashboardu a při každé změně nemusíš aplikaci znovu publikovat.

Krok 1: vytvoř produkty v App Store Connect

Než se pustíš do RevenueCat, musí produkty existovat na straně Applu. V App Store Connect vytvoř skupinu předplatných a pak jednu nebo víc úrovní s jejich délkou, třeba měsíční nebo roční, a cenou podle území. U každé úrovně vyplň i texty, které uvidí uživatel: Apple je vyžaduje, než produkt při review přijme.

Častá chyba v téhle fázi: produkt je vytvořený, ale nikdy nebyl odeslaný v rámci prvního review aplikace spolu s příslušnou verzí. Produkt čekající na schválení, který nebyl nikdy součástí odeslání aplikace, zůstane pro tvoje uživatele neviditelný, i když ho RevenueCat už vidí.

Krok 2: propoj RevenueCat se svou aplikací

V RevenueCat vytvoříš projekt, připojíš svůj API klíč z App Store Connect, aby RevenueCat automaticky synchronizoval tvoje produkty, a pak nadefinuješ „entitlements“, tedy přístupová práva. Entitlement představuje to, co předplatné odemyká, například plný přístup k aplikaci, nezávisle na tom, který konkrétní produkt ho spustil.

Tahle mezivrstva se hodí: když později změníš strukturu nabídek, třeba přidáš roční úroveň, jednoduše nový produkt připojíš ke stejnému entitlementu a na kód, který v aplikaci ověřuje přístup, vůbec nesáhneš.

V aplikaci se RevenueCat SDK pro React Native instaluje do Expo projektu pomocí vlastního pluginu a nabízí jednoduchou funkci, která zjistí, jestli má aktuální uživatel aktivní entitlement.

Krok 3: postav paywall

Paywall je obrazovka, která představuje nabídku a spouští nákup. RevenueCat nabízí paywally nastavitelné z dashboardu, které upravíš bez nového publikování aplikace. Nebo si se SDK postavíš vlastní, pokud chceš mít design plně pod kontrolou.

Umístění je stejně důležité jako design. Paywall zobrazený dřív, než člověk uvidí, co aplikace umí, obvykle konvertuje hůř než paywall hned po první úspěšné akci. Průvodce chybami v iOS paywallu pro začátečníky rozebírá nejčastější pasti v téhle fázi, nad rámec samotného technického napojení.

Krok 4: otestuj nákup, obnovení a vypršení

Tenhle krok se nejčastěji odbyde, a přitom ho Apple kontroluje nejvíc. Před odesláním musí fungovat tři scénáře:

Nákup. S testovacím sandbox účtem musí nákup okamžitě odemknout entitlement a aplikace musí na změnu zareagovat, aniž by bylo nutné ji restartovat.

Obnovení. Na novém zařízení nebo po přeinstalaci, se stejným Apple účtem, musí tlačítko „Obnovit nákupy“ najít aktivní předplatné. Apple tenhle průchod při review kontroluje pokaždé a jeho chybění nebo nefunkčnost je častým důvodem zamítnutí podle guideline 3.1.1.

Vypršení. V sandbox prostředí vyprší předplatná za pár minut místo několika měsíců, takže si můžeš ověřit, že se přístup po skončení období správně zavře, a nemusíš čekat na skutečný fakturační cyklus.

Co RevenueCat nenahradí

RevenueCat řeší mechaniku nákupu, ne soulad tvé stránky v obchodě ani paywallu s guideline 3.1.2. Pořád je na tobě, abys předplatné správně popsal v popisu na App Store, uvedl jeho přesnou cenu a délku a vyplnil podmínky použití. Stránka předplatné, nebo jednorázový nákup na iOS ti pomůže vybrat správný model ještě předtím, než se dostaneš k téhle technické fázi.

RevenueCat si navíc nad určitou měsíční hranicí bere provizi z příjmů, a to k provizi Applu z předplatných prodaných v aplikaci. Než kolem těchhle dvou provizí postavíš svůj byznys model, ověř si aktuální úrovně přímo na jejich webu.

Nejčastější chyby začátečníků

Zapomenutý stav načítání. Po spuštění potřebuje RevenueCat chvilku, než načte přístupová práva uživatele. Pokud aplikace před touhle odpovědí zobrazuje placený obsah jako výchozí, uživatel bez předplatného může na okamžik vidět obsah, za který nezaplatil. Počítej s explicitním stavem načítání, ne s optimistickým výchozím zobrazením.

Ověřování práv na špatném místě. Aktivní entitlement je potřeba znovu ověřit při každém otevření placené obrazovky, ne jen jednou při startu. Když uživatel předplatné zruší nebo mu vyprší, zatímco aplikaci používá, další obrazovka musí tuhle změnu odrážet.

Záměna sandboxu a produkce. Identifikátory produktů a testovací sandbox účty jsou oddělené od produkce. Test, který v sandboxu funguje se špatným Apple účtem, nebo produkt vytvořený jen v produkci můžou vyvolat falešný dojem, že je všechno připravené.

Ověřená aplikace, ne jen aplikace, která se zkompiluje

Předplatné, které „funguje“ při rychlém testu na tvém vlastním účtu, ještě nezaručuje, že přežije obnovení na jiném zařízení nebo skutečné vypršení. Přesně tohle reviewer od Applu kontroluje. Stránka předplatné v iOS aplikaci popisuje celý tenhle řetězec, od vytvoření produktů až po finální kontrolu.

Pokud chceš začít ze základu, kde už paywall a předplatná v kódu jsou, přesně to obsahuje startovní kód iOS Kitu. Abys své předplatné zkontroloval stejně jako reviewer, Apple Review Kit obsahuje můj checklist před odesláním a poznámky, které testerovi nechat k nákupu v aplikaci.

Časté dotazy

Jak nastavit předplatné přes RevenueCat na iOS?

Ve čtyřech krocích. Nejdřív vytvoř produkty v App Store Connect. Pak připoj RevenueCat přes API klíč z App Store Connect, nadefinuj entitlements (přístupová práva) a postav paywall. Nakonec otestuj nákup, obnovení a vypršení: tenhle krok se často odbyde, a přitom ho Apple kontroluje.

Je RevenueCat povinný pro prodej předplatného na iOS?

Ne. StoreKit, framework od Applu, umožňuje prodávat předplatné bez služby třetí strany. Pak ale píšeš celou logiku nákupu, obnovení a ověřování přístupových práv sám, včetně okrajových případů, na které se snadno zapomene: změna zařízení, vypršení, refundace. RevenueCat se postaví mezi App Store Connect a tvoji aplikaci, abys tuhle vrstvu psát nemusel.

Co je entitlement v RevenueCat?

Entitlement je přístupové právo: představuje to, co předplatné odemyká, například plný přístup k aplikaci, bez ohledu na konkrétní produkt, který ho spustil. Když později přidáš roční úroveň, jednoduše nový produkt připojíš ke stejnému entitlementu. Kód, který v aplikaci ověřuje přístup, se měnit nemusí.

Jak otestovat předplatné přes RevenueCat před odesláním Applu?

Před odesláním musí fungovat tři scénáře. Nákup: s testovacím sandbox účtem se přístup okamžitě odemkne, bez restartu aplikace. Obnovení: na novém zařízení nebo po přeinstalaci, se stejným Apple účtem, najde tlačítko obnovení aktivní předplatné. Vypršení: v sandboxu vyprší předplatná za pár minut, takže si ověříš, že se přístup zavře.

Proč produkt viditelný v RevenueCat zůstává pro uživatele neviditelný?

Často proto, že produkt nebyl nikdy součástí odeslání aplikace. Produkt vytvořený v App Store Connect, ale nikdy neodeslaný v rámci prvního review s příslušnou verzí, zůstane pro tvoje uživatele neviditelný, i když ho RevenueCat už vidí. Je to častá chyba při vytváření produktů.

Bere si RevenueCat provizi z předplatných?

RevenueCat si bere provizi z příjmů nad určitou měsíční hranicí. Přičítá se k provizi Applu z předplatných prodaných v aplikaci. Než kolem těchhle dvou provizí postavíš svůj byznys model, ověř si aktuální úrovně na webu RevenueCat.