RevenueCat: naročnina v aplikaciji za iOS korak za korakom

Zakaj RevenueCat in ne samo StoreKit

StoreKit, Applov framework, ti omogoča prodajo naročnine brez kakršne koli storitve tretje osebe. A za začetnika pomeni pisanje celotne logike nakupa, obnovitve in preverjanja pravic dostopa veliko kode, ki jo moraš vzdrževati, in robne primere, ki jih zlahka spregledaš: zamenjava naprave, potek, vračilo denarja.

RevenueCat se vrine med App Store Connect in tvojo aplikacijo: prebere tvoje izdelke, upravlja aktivne naročnine in ti prihrani pisanje te plasti. Ceno in ponudbe še vedno nadziraš iz nadzorne plošče, ne da bi moral ob vsaki spremembi znova objaviti aplikacijo.

1. korak: ustvari izdelke v App Store Connect

Preden se lotiš RevenueCata, morajo izdelki obstajati pri Applu. V App Store Connect ustvari skupino naročnin, nato eno ali več ravni s trajanjem, na primer mesečno ali letno, in njihovo ceno po ozemljih. Izpolni tudi besedila, ki jih uporabnik vidi pri vsaki ravni: Apple jih zahteva, preden izdelek sprejme v pregled.

Pogosta napaka v tej fazi: izdelek je ustvarjen, a nikoli oddan v prvi pregled aplikacije skupaj z ustrezno različico. Izdelek na čakanju, ki ni bil nikoli vključen v oddajo aplikacije, ostane uporabnikom neviden, čeprav ga RevenueCat že vidi.

2. korak: poveži RevenueCat s svojo aplikacijo

V RevenueCatu ustvariš projekt, povežeš svoj API ključ za App Store Connect, da RevenueCat samodejno sinhronizira tvoje izdelke, nato pa določiš "entitlements", torej pravice dostopa. Entitlement predstavlja to, kar naročnina odklene, na primer polni dostop do aplikacije, ne glede na to, kateri točno izdelek ga je sprožil.

Ta vmesni sloj je uporaben: če kasneje spremeniš strukturo ponudb, na primer dodaš letno raven, nov izdelek preprosto povežeš z istim entitlementom in se ne dotakneš kode, ki v aplikaciji preverja dostop.

Na strani aplikacije se RevenueCat SDK za React Native v projekt Expo namesti z namenskim pluginom in ponuja preprosto funkcijo, s katero izveš, ali ima trenutni uporabnik aktiven entitlement.

3. korak: zgradi paywall

Paywall je zaslon, ki predstavi ponudbo in sproži nakup. RevenueCat ponuja paywalle, ki jih nastaviš v nadzorni plošči in spreminjaš brez ponovne objave aplikacije, lahko pa zgradiš svojega s SDK-jem, če želiš popoln nadzor nad dizajnom.

Postavitev šteje enako kot dizajn. Paywall, ki se prikaže, preden je oseba videla vrednost aplikacije, običajno konvertira slabše kot paywall takoj po prvem uspešnem dejanju. Vodnik o napakah s paywallom na iOS za začetnike podrobno opiše najpogostejše pasti v tej fazi, onkraj same tehnične povezave.

4. korak: preizkusi nakup, obnovitev in potek

To je korak, ki ga ljudje najpogosteje odpravijo na hitro, Apple pa ga preverja najbolj. Pred oddajo morajo delovati trije scenariji:

Nakup. S testnim računom sandbox mora nakup takoj odkleniti entitlement, aplikacija pa se mora na to spremembo odzvati brez ponovnega zagona.

Obnovitev. Na novi napravi ali po ponovni namestitvi mora gumb "Restore Purchases" z istim Apple računom najti aktivno naročnino. Apple to pot v pregledu preveri vsakič, njena odsotnost ali slabo delovanje pa je pogost razlog za zavrnitev po guideline 3.1.1.

Potek. V okolju sandbox naročnine poteče v nekaj minutah namesto v več mesecih, tako da lahko preveriš, ali se dostop po koncu obdobja pravilno zapre, ne da bi čakal na pravi obračunski cikel.

Česa RevenueCat ne nadomesti

RevenueCat skrbi za mehaniko nakupa, ne pa za skladnost tvoje strani v trgovini in paywalla z guideline 3.1.2. Še vedno moraš sam pravilno opisati naročnino v opisu na App Store, navesti njeno točno ceno in trajanje ter dodati pogoje uporabe. Stran naročnina ali enkratni nakup na iOS ti pomaga izbrati pravi model, še preden prideš do tega tehničnega koraka.

RevenueCat poleg tega vzame provizijo od prihodkov nad določenim mesečnim pragom, poleg Applove provizije za naročnine, prodane v aplikaciji. Preden zgradiš poslovni model okoli teh dveh provizij, preveri trenutne ravni na njihovi spletni strani.

Najpogostejše napake začetnikov

Pozabljeno stanje nalaganja. Ob zagonu RevenueCat potrebuje trenutek, da pridobi uporabnikove pravice dostopa. Če aplikacija pred tem odgovorom privzeto prikaže plačljivo vsebino, lahko uporabnik brez naročnine za hip vidi vsebino, ki je ni plačal. Predvidi izrecno stanje nalaganja namesto optimističnega privzetega prikaza.

Preverjanje pravic na napačnem mestu. Aktiven entitlement je treba znova preveriti ob vsakem odprtju plačljivega zaslona, ne le enkrat ob zagonu. Če uporabnik prekliče naročnino ali ta poteče med uporabo aplikacije, mora naslednji zaslon to spremembo upoštevati.

Mešanje okolij sandbox in produkcija. Identifikatorji izdelkov in testni računi sandbox so ločeni od produkcije. Test, ki v sandboxu deluje z napačnim Apple računom, ali izdelek, ustvarjen samo v produkciji, lahko da lažen vtis, da je vse pripravljeno.

Preverjena aplikacija, ne le aplikacija, ki se prevede

Naročnina, ki "deluje" v hitrem testu na tvojem lastnem računu, še ne zagotavlja, da bo preživela obnovitev na drugi napravi ali pravi potek. Prav to preverja Applov reviewer. Stran naročnina v aplikaciji za iOS podrobno opiše celotno verigo, od ustvarjanja izdelkov do končnega preverjanja.

Če želiš začeti z osnovo, v kateri sta paywall in naročnine že v kodi, je to vsebina začetne kode v iOS Kit. Da naročnino preveriš tako, kot jo bo reviewer, Apple Review Kit združuje moj seznam za preverjanje pred oddajo in opombe, ki jih pustiš preizkuševalcu za nakup v aplikaciji.

Pogosta vprašanja

Kako nastavim naročnino z RevenueCatom na iOS?

V štirih korakih. Najprej ustvari svoje izdelke v App Store Connect. Nato poveži RevenueCat s svojim API ključem za App Store Connect, določi entitlemente (pravice dostopa) in zgradi paywall. Na koncu preizkusi nakup, obnovitev in potek: ta korak se pogosto odpravi na hitro, Apple pa ga preverja.

Je RevenueCat obvezen za prodajo naročnine na iOS?

Ne. StoreKit, Applov framework, omogoča prodajo naročnine brez storitve tretje osebe. A potem sam pišeš celotno logiko nakupa, obnovitve in preverjanja pravic dostopa, z robnimi primeri, ki jih zlahka spregledaš: zamenjava naprave, potek, vračilo denarja. RevenueCat se vrine med App Store Connect in tvojo aplikacijo, da ti te plasti ni treba pisati.

Kaj je entitlement v RevenueCatu?

Entitlement je pravica dostopa: predstavlja to, kar naročnina odklene, na primer polni dostop do aplikacije, ne glede na to, kateri točno izdelek ga je sprožil. Če kasneje dodaš letno raven, nov izdelek preprosto povežeš z istim entitlementom. Kode, ki v aplikaciji preverja dostop, ni treba spreminjati.

Kako preizkusim naročnino z RevenueCatom pred oddajo Applu?

Pred oddajo morajo delovati trije scenariji. Nakup: s testnim računom sandbox se dostop odklene takoj, brez ponovnega zagona aplikacije. Obnovitev: na novi napravi ali po ponovni namestitvi gumb za obnovitev z istim Apple računom najde aktivno naročnino. Potek: v sandboxu naročnine potečejo v nekaj minutah, tako da lahko preveriš, ali se dostop zapre.

Zakaj izdelek, ki ga vidim v RevenueCatu, ostane uporabnikom neviden?

Pogosto zato, ker izdelek ni bil nikoli vključen v oddajo aplikacije. Izdelek, ustvarjen v App Store Connect, a nikoli oddan v prvi pregled z ustrezno različico, ostane uporabnikom neviden, čeprav ga RevenueCat že vidi. To je pogosta napaka pri ustvarjanju izdelkov.

Ali RevenueCat vzame provizijo od naročnin?

RevenueCat vzame provizijo od prihodkov nad določenim mesečnim pragom. Ta se prišteje k Applovi proviziji za naročnine, prodane v aplikaciji. Preden zgradiš poslovni model okoli teh dveh provizij, preveri trenutne ravni na spletni strani RevenueCata.