RevenueCat-tilaus iOS-sovellukseen: näin otat sen käyttöön

Miksi RevenueCat eikä pelkkä StoreKit

StoreKit, Applen oma framework, riittää tilauksen myymiseen ilman kolmannen osapuolen palvelua. Aloittelijalle koko osto-, palautus- ja käyttöoikeuslogiikan kirjoittaminen itse on kuitenkin paljon ylläpidettävää koodia. Lisäksi reunatapaukset unohtuvat helposti: laitteen vaihto, tilauksen päättyminen, hyvitys.

RevenueCat asettuu App Store Connectin ja sovelluksesi väliin. Se lukee tuotteesi, hallitsee aktiiviset tilaukset ja säästää sinut kirjoittamasta tätä kerrosta itse. Hinta ja tarjoukset pysyvät hallinnassasi hallintapaneelin kautta, eikä sovellusta tarvitse julkaista uudelleen jokaisen muutoksen jälkeen.

Vaihe 1: luo tuotteet App Store Connectissa

Tuotteiden täytyy olla olemassa Applen puolella ennen RevenueCatia. Luo App Store Connectissa tilausryhmä ja sen alle yksi tai useampi taso kestoineen, esimerkiksi kuukausi- tai vuositilaus, sekä niiden hinnat maittain. Täytä myös käyttäjälle näytettävät tekstit jokaiselle tasolle: Apple vaatii ne ennen kuin hyväksyy tuotteen tarkastukseen.

Tässä vaiheessa unohtuu usein yksi asia: tuote on luotu, mutta sitä ei ole koskaan lähetetty sovelluksen ensimmäiseen tarkastukseen yhdessä siihen liittyvän version kanssa. Odottava tuote, jota ei ole koskaan liitetty sovelluksen lähetykseen, pysyy käyttäjiltäsi piilossa, vaikka RevenueCat näkisi sen jo.

Vaihe 2: yhdistä RevenueCat sovellukseesi

RevenueCatissa luot projektin ja liität siihen App Store Connectin API-avaimesi, jotta RevenueCat synkronoi tuotteesi automaattisesti. Sen jälkeen määrität "entitlementit" eli käyttöoikeudet. Entitlement kuvaa sitä, mitä tilaus avaa, esimerkiksi täyden pääsyn sovellukseen, riippumatta siitä, mikä tuote sen tarkalleen laukaisi.

Tämä välikerros on hyödyllinen. Jos muutat tarjontasi rakennetta myöhemmin, vaikkapa lisäämällä vuositason, liität uuden tuotteen vain samaan entitlementtiin. Sovelluksen pääsyntarkistuskoodiin ei tarvitse koskea.

Sovelluksen puolella RevenueCatin React Native -SDK asennetaan Expo-projektiin omalla pluginillaan. Se tarjoaa yksinkertaisen funktion, jolla selvität, onko nykyisellä käyttäjällä aktiivinen entitlement.

Vaihe 3: rakenna paywall

Paywall on näkymä, joka esittelee tarjouksen ja käynnistää oston. RevenueCat tarjoaa hallintapaneelista muokattavia paywalleja, joita voi muuttaa julkaisematta sovellusta uudelleen. Voit myös rakentaa omasi SDK:lla, jos haluat täyden kontrollin ulkoasuun.

Sijoittelu on yhtä tärkeä kuin ulkoasu. Paywall, joka näytetään ennen kuin käyttäjä on nähnyt sovelluksen arvon, konvertoi yleensä huonommin kuin paywall heti ensimmäisen onnistuneen toiminnon jälkeen. Opas aloittelijan iOS-paywall-virheistä käy läpi tämän vaiheen yleisimmät sudenkuopat pelkän teknisen kytkennän lisäksi.

Vaihe 4: testaa osto, palautus ja päättyminen

Tämä vaihe hoidetaan useimmiten hutiloiden, vaikka Apple tarkistaa sen tarkimmin. Kolmen skenaarion täytyy toimia ennen lähetystä:

Osto. Sandbox-testitilillä oston pitää avata entitlement heti, ja sovelluksesi pitää reagoida muutokseen ilman uudelleenkäynnistystä.

Palautus. Uudella laitteella tai uudelleenasennuksen jälkeen samalla Apple-tilillä "Palauta ostot" -painikkeen pitää löytää aktiivinen tilaus. Apple tarkistaa tämän polun tarkastuksessa aina, ja sen puuttuminen tai toimimattomuus on yleinen hylkäyssyy guideline 3.1.1:n perusteella.

Päättyminen. Sandbox-ympäristössä tilaukset päättyvät muutamassa minuutissa kuukausien sijaan. Näin voit varmistaa, että pääsy sulkeutuu oikein jakson päätyttyä, odottamatta oikeaa laskutusjaksoa.

Mitä RevenueCat ei korvaa

RevenueCat hoitaa ostomekaniikan, ei sivusi tai paywallisi yhteensopivuutta guideline 3.1.2:n kanssa. Sinun vastuullasi on edelleen kuvata tilaus oikein App Store -kuvauksessa, kertoa sen tarkka hinta ja kesto sekä lisätä käyttöehtosi. Sivu tilaus vai kertaosto iOS:llä auttaa valitsemaan oikean mallin jo ennen tätä teknistä vaihetta.

RevenueCat ottaa lisäksi provision tuloista tietyn kuukausittaisen rajan ylittävältä osalta, Applen sovelluksen sisällä myydyistä tilauksista perimän provision päälle. Tarkista nykyiset tasot heidän omalta sivustoltaan ennen kuin rakennat ansaintamallisi näiden kahden provision varaan.

Aloittelijan yleisimmät virheet

Latausnäkymä unohtuu. Käynnistyksessä RevenueCat tarvitsee hetken hakeakseen käyttäjän käyttöoikeudet. Jos sovelluksesi näyttää maksullisen sisällön oletuksena ennen vastausta, tilaamaton käyttäjä voi hetken nähdä sisältöä, josta hän ei ole maksanut. Tee selkeä latausnäkymä optimistisen oletusnäkymän sijaan.

Oikeudet tarkistetaan väärässä kohdassa. Aktiivinen entitlement pitää tarkistaa uudelleen aina, kun maksullinen näkymä avataan, ei vain kerran käynnistyksessä. Jos käyttäjä peruu tilauksen tai se päättyy kesken käytön, seuraavan näkymän pitää näyttää muutos.

Sandbox ja tuotanto sekoittuvat. Sandboxin tuotetunnisteet ja testitilit ovat erillään tuotannosta. Testi, joka toimii sandboxissa väärällä Apple-tilillä, tai pelkästään tuotantoon luotu tuote voi antaa väärän kuvan siitä, että kaikki on valmista.

Tarkistettu sovellus, ei vain sovellus joka kääntyy

Tilaus, joka "toimii" nopeassa testissä omalla tililläsi, ei takaa, että se kestää palautuksen toisella laitteella tai todellisen päättymisen. Juuri tätä Applen tarkastaja tarkistaa. Sivu iOS-sovelluksen sisäinen tilaus käy läpi koko ketjun tuotteiden luomisesta lopputarkistukseen.

Jos haluat aloittaa pohjasta, jossa paywall ja tilaukset ovat jo koodissa, juuri sen iOS Kitin Starter Code sisältää. Jos haluat tarkistaa tilauksesi samalla tavalla kuin tarkastaja, Apple Review Kit kokoaa lähetystä edeltävän tarkistuslistani ja muistiinpanot, jotka kannattaa jättää testaajalle sovelluksen sisäisestä ostosta.

Usein kysytyt kysymykset

Miten RevenueCat-tilaus otetaan käyttöön iOS:llä?

Neljässä vaiheessa. Luo ensin tuotteesi App Store Connectissa. Yhdistä sitten RevenueCat App Store Connectin API-avaimellasi ja määritä entitlementit (käyttöoikeudet), ja rakenna paywall. Testaa lopuksi osto, palautus ja päättyminen: tämä vaihe hoidetaan usein hutiloiden, vaikka Apple tarkistaa sen.

Onko RevenueCat pakollinen tilauksen myymiseen iOS:llä?

Ei. StoreKit, Applen framework, riittää tilauksen myymiseen ilman kolmannen osapuolen palvelua. Silloin kirjoitat kuitenkin itse koko osto-, palautus- ja käyttöoikeuslogiikan, ja reunatapaukset unohtuvat helposti: laitteen vaihto, päättyminen, hyvitys. RevenueCat asettuu App Store Connectin ja sovelluksesi väliin, joten tätä kerrosta ei tarvitse tehdä itse.

Mikä on entitlement RevenueCatissa?

Entitlement on käyttöoikeus: se kuvaa sitä, mitä tilaus avaa, esimerkiksi täyden pääsyn sovellukseen, riippumatta siitä, mikä tuote sen laukaisi. Jos lisäät myöhemmin vuositason, liität uuden tuotteen vain samaan entitlementtiin. Sovelluksen pääsyntarkistuskoodia ei tarvitse muuttaa.

Miten RevenueCat-tilaus testataan ennen lähetystä Applelle?

Kolmen skenaarion täytyy toimia ennen lähetystä. Osto: sandbox-testitilillä pääsy avautuu heti ilman sovelluksen uudelleenkäynnistystä. Palautus: uudella laitteella tai uudelleenasennuksen jälkeen samalla Apple-tilillä palautuspainike löytää aktiivisen tilauksen. Päättyminen: sandboxissa tilaukset päättyvät muutamassa minuutissa, joten voit varmistaa, että pääsy sulkeutuu.

Miksi RevenueCatissa näkyvä tuote ei näy käyttäjille?

Usein siksi, ettei tuotetta ole koskaan liitetty sovelluksen lähetykseen. App Store Connectissa luotu tuote, jota ei ole lähetetty ensimmäiseen tarkastukseen siihen liittyvän version kanssa, pysyy käyttäjiltä piilossa, vaikka RevenueCat näkisi sen jo. Tämä unohtuu usein tuotteita luotaessa.

Ottaako RevenueCat provision tilauksista?

RevenueCat ottaa provision tuloista tietyn kuukausittaisen rajan ylittävältä osalta. Se tulee Applen sovelluksen sisällä myydyistä tilauksista perimän provision päälle. Tarkista nykyiset tasot RevenueCatin sivustolta ennen kuin rakennat ansaintamallisi näiden kahden provision varaan.