RevenueCat: ako nastaviť in-app predplatné v iOS

Prečo použiť RevenueCat namiesto samotného StoreKitu

StoreKit, framework od Apple, ti umožní predávať predplatné bez akejkoľvek služby tretej strany. Lenže pre začiatočníka to znamená napísať si sám celú logiku nákupu, obnovenia a overovania prístupových práv. To je veľa kódu na údržbu a veľa hraničných prípadov, na ktoré sa ľahko zabudne: zmena zariadenia, vypršanie, refundácia.

RevenueCat sa vloží medzi App Store Connect a tvoju appku: načíta tvoje produkty, spravuje aktívne predplatné a ušetrí ťa písania tejto vrstvy. Cenu a ponuky máš stále pod kontrolou v dashboarde a pri každej zmene nemusíš appku znova publikovať.

Krok 1: vytvor si produkty v App Store Connect

Skôr než sa pustíš do RevenueCat, produkty musia existovať na strane Apple. V App Store Connect vytvor skupinu predplatného a potom jednu alebo viac úrovní s ich trvaním, napríklad mesačné alebo ročné, a ich cenou podľa krajiny. Vyplň aj texty, ktoré sa používateľovi zobrazia pri každej úrovni: Apple ich vyžaduje, inak produkt pri review neprijme.

Častá chyba v tejto fáze: produkt je vytvorený, ale nikdy nebol odoslaný na prvé review appky spolu s príslušnou verziou. Čakajúci produkt, ktorý nikdy nebol súčasťou odoslania appky, zostáva pre tvojich používateľov neviditeľný, aj keď ho RevenueCat už vidí.

Krok 2: prepoj RevenueCat so svojou aplikáciou

V RevenueCat si vytvoríš projekt, pripojíš svoj API kľúč z App Store Connect, aby RevenueCat automaticky synchronizoval tvoje produkty, a potom definuješ „entitlements“, teda prístupové práva. Entitlement predstavuje to, čo predplatné odomyká, napríklad plný prístup k appke, bez ohľadu na to, ktorý konkrétny produkt ho spustil.

Táto medzivrstva sa oplatí: ak neskôr zmeníš štruktúru ponúk, napríklad pridáš ročnú úroveň, jednoducho priradíš nový produkt k tomu istému entitlementu. Kód, ktorý v appke overuje prístup, nemusíš vôbec meniť.

Na strane appky sa RevenueCat SDK pre React Native inštaluje do Expo projektu cez vlastný plugin a ponúka jednoduchú funkciu, ktorou zistíš, či má aktuálny používateľ aktívny entitlement.

Krok 3: postav si paywall

Paywall je obrazovka, ktorá predstaví ponuku a spustí nákup. RevenueCat ponúka paywally nastaviteľné v dashboarde, ktoré môžeš meniť bez nového publikovania appky. Alebo si postavíš vlastný pomocou SDK, ak chceš mať dizajn úplne pod kontrolou.

Umiestnenie je rovnako dôležité ako dizajn. Paywall zobrazený skôr, než človek uvidí hodnotu appky, zvyčajne konvertuje horšie ako paywall hneď po prvej úspešnej akcii. Návod o chybách začiatočníkov pri iOS paywalle rozoberá najčastejšie pasce v tejto fáze, nielen samotné technické zapojenie.

Krok 4: otestuj nákup, obnovenie a vypršanie

Toto je krok, ktorý sa najčastejšie odflákne, a pritom ho Apple kontroluje najviac. Pred odoslaním musia fungovať tri scenáre:

Nákup. So sandbox testovacím účtom musí nákup okamžite odomknúť entitlement a tvoja appka musí na túto zmenu zareagovať bez reštartu.

Obnovenie. Na novom zariadení alebo po preinštalovaní, s tým istým Apple účtom, musí tlačidlo „Restore Purchases“ nájsť aktívne predplatné. Apple tento postup pri review kontroluje vždy a jeho absencia alebo nefunkčnosť je častým dôvodom zamietnutia podľa guideline 3.1.1.

Vypršanie. V sandbox prostredí predplatné vyprší za pár minút namiesto niekoľkých mesiacov. Vďaka tomu overíš, že sa prístup po skončení obdobia správne uzavrie, a nemusíš čakať na skutočný fakturačný cyklus.

Čo RevenueCat nenahradí

RevenueCat rieši mechaniku nákupu, nie súlad tvojej stránky v App Store ani paywallu s guideline 3.1.2. Stále je na tebe, aby si predplatné správne opísal v popise v App Store, uviedol jeho presnú cenu a trvanie a doplnil podmienky používania. Stránka predplatné alebo jednorazový nákup v iOS ti pomôže vybrať správny model ešte predtým, než sa dostaneš k tomuto technickému kroku.

RevenueCat si navyše berie províziu z príjmov nad určitou mesačnou hranicou, a to popri provízii Apple z predplatného predaného v appke. Skôr než postavíš svoj biznis model okolo týchto dvoch provízií, over si aktuálne úrovne priamo na ich webe.

Najčastejšie chyby začiatočníkov

Zabudnutý stav načítavania. Pri spustení potrebuje RevenueCat chvíľku, aby získal prístupové práva používateľa. Ak tvoja appka pred touto odpoveďou predvolene zobrazí platený obsah, používateľ bez predplatného môže na okamih vidieť obsah, za ktorý nezaplatil. Namiesto optimistického predvoleného zobrazenia si priprav jasný stav načítavania.

Overovanie práv na nesprávnom mieste. Aktívny entitlement treba overiť znova pri každom otvorení platenej obrazovky, nielen raz pri štarte. Ak používateľ zruší predplatné alebo mu vyprší počas používania appky, ďalšia obrazovka to musí zohľadniť.

Zámena sandboxu a produkcie. Identifikátory produktov a sandbox testovacie účty sú oddelené od produkcie. Test, ktorý v sandboxe funguje s nesprávnym Apple účtom, alebo produkt vytvorený len v produkcii ti môžu dať falošný dojem, že je všetko pripravené.

Overená aplikácia, nielen aplikácia, ktorá sa skompiluje

Predplatné, ktoré „funguje“ pri rýchlom teste na tvojom vlastnom účte, ešte nezaručuje, že prežije obnovenie na inom zariadení alebo skutočné vypršanie. Presne toto kontroluje reviewer od Apple. Stránka in-app predplatné v iOS rozoberá celý tento reťazec, od vytvorenia produktov až po záverečnú kontrolu.

Ak chceš začať zo základu, kde sú paywall a predplatné už v kóde, presne to obsahuje štartovací kód v iOS Kit. Ak chceš svoje predplatné skontrolovať tak, ako to urobí reviewer, Apple Review Kit obsahuje môj checklist pred odoslaním a poznámky, ktoré treba nechať testerovi k in-app nákupu.

Často kladené otázky

Ako nastaviť predplatné cez RevenueCat v iOS?

V štyroch krokoch. Najprv vytvor svoje produkty v App Store Connect. Potom pripoj RevenueCat cez API kľúč z App Store Connect, definuj entitlements (prístupové práva) a postav paywall. Nakoniec otestuj nákup, obnovenie a vypršanie: tento krok sa často odflákne, a pritom ho Apple kontroluje.

Je RevenueCat povinný na predaj predplatného v iOS?

Nie. StoreKit, framework od Apple, umožňuje predávať predplatné bez služby tretej strany. Vtedy si však píšeš celú logiku nákupu, obnovenia a overovania prístupových práv sám, s hraničnými prípadmi, na ktoré sa ľahko zabudne: zmena zariadenia, vypršanie, refundácia. RevenueCat sa vloží medzi App Store Connect a tvoju appku a túto vrstvu ti ušetrí.

Čo je entitlement v RevenueCat?

Entitlement je prístupové právo: predstavuje to, čo predplatné odomyká, napríklad plný prístup k appke, bez ohľadu na to, ktorý konkrétny produkt ho spustil. Ak neskôr pridáš ročnú úroveň, jednoducho priradíš nový produkt k tomu istému entitlementu. Kód, ktorý v appke overuje prístup, sa meniť nemusí.

Ako otestovať predplatné cez RevenueCat pred odoslaním do Apple?

Pred odoslaním musia fungovať tri scenáre. Nákup: so sandbox testovacím účtom sa prístup odomkne okamžite, bez reštartu appky. Obnovenie: na novom zariadení alebo po preinštalovaní, s tým istým Apple účtom, nájde tlačidlo obnovenia aktívne predplatné. Vypršanie: v sandboxe predplatné vyprší za pár minút, takže si overíš, že sa prístup uzavrie.

Prečo produkt, ktorý vidím v RevenueCat, zostáva pre používateľov neviditeľný?

Často preto, že produkt nikdy nebol súčasťou odoslania appky. Produkt vytvorený v App Store Connect, ktorý nikdy nebol odoslaný na prvé review spolu s príslušnou verziou, zostáva pre tvojich používateľov neviditeľný, aj keď ho RevenueCat už vidí. Je to častá chyba pri vytváraní produktov.

Berie si RevenueCat províziu z predplatného?

RevenueCat si berie províziu z príjmov nad určitou mesačnou hranicou. Pripočítava sa k provízii Apple z predplatného predaného v appke. Skôr než postavíš svoj biznis model okolo týchto dvoch provízií, over si aktuálne úrovne na webe RevenueCat.