RevenueCat: sätt upp en in-app-prenumeration på iOS

Varför använda RevenueCat i stället för bara StoreKit

StoreKit, Apples ramverk, låter dig sälja en prenumeration utan någon tredjepartstjänst. Men för en nybörjare innebär det mycket kod att underhålla att själv skriva all logik för köp, återställning och kontroll av åtkomsträttigheter, med kantfall som är lätta att glömma: byte av enhet, utgång, återbetalning.

RevenueCat lägger sig mellan App Store Connect och din app: det läser dina produkter, hanterar aktiva prenumerationer och gör att du slipper skriva det lagret själv. Du behåller kontrollen över priset och erbjudandena från en dashboard, utan att publicera om appen vid varje ändring.

Steg 1: skapa dina produkter i App Store Connect

Innan RevenueCat måste produkterna finnas hos Apple. Skapa en prenumerationsgrupp i App Store Connect, och sedan en eller flera nivåer med längd, till exempel månadsvis eller årsvis, och pris per region. Fyll också i texterna som visas för användaren för varje nivå: Apple kräver dem innan produkten godkänns i granskningen.

En vanlig miss i det här läget: en produkt som skapats men aldrig skickats in till appens första granskning tillsammans med sin version. En väntande produkt som aldrig ingått i en appinlämning förblir osynlig för dina användare, även om RevenueCat redan ser den.

Steg 2: koppla RevenueCat till din app

I RevenueCat skapar du ett projekt, kopplar din API-nyckel för App Store Connect så att RevenueCat synkar dina produkter automatiskt, och definierar sedan "entitlements", alltså åtkomsträttigheter. Ett entitlement representerar det som prenumerationen låser upp, till exempel full åtkomst till appen, oavsett exakt vilken produkt som utlöste det.

Den här indirektionen är användbar: om du ändrar strukturen på dina erbjudanden senare, till exempel genom att lägga till en årsnivå, kopplar du bara den nya produkten till samma entitlement, utan att röra koden som kontrollerar åtkomsten i appen.

På appsidan installeras RevenueCats SDK för React Native i ett Expo-projekt med ett eget plugin, och det exponerar en enkel funktion för att se om den aktuella användaren har ett aktivt entitlement.

Steg 3: bygg din paywall

Paywallen är skärmen som presenterar erbjudandet och startar köpet. RevenueCat erbjuder paywalls som konfigureras från dashboarden och kan ändras utan att publicera om appen, eller så bygger du din egen med SDK:t om du vill ha full kontroll över designen.

Placeringen spelar lika stor roll som designen. En paywall som visas innan personen har sett värdet i appen konverterar oftast sämre än en paywall som placeras direkt efter en första lyckad handling. Guiden om paywall-misstag på iOS för nybörjare går igenom de vanligaste fällorna i det här steget, bortom själva den tekniska kopplingen.

Steg 4: testa köp, återställning och utgång

Det här är steget som oftast slarvas med, och ändå det som Apple kontrollerar mest. Tre scenarier måste fungera innan du skickar in:

Köpet. Med ett sandbox-testkonto ska köpet låsa upp entitlementet direkt, och appen ska reagera på ändringen utan att behöva startas om.

Återställningen. På en ny enhet eller efter ominstallation, med samma Apple-konto, ska en knapp "Återställ köp" hitta den aktiva prenumerationen. Apple kontrollerar alltid det här flödet i granskningen, och om det saknas eller fungerar dåligt är det en vanlig avslagsorsak enligt guideline 3.1.1.

Utgången. I sandbox-miljön går prenumerationer ut på några minuter i stället för flera månader, så att du kan kontrollera att åtkomsten stängs korrekt när perioden är slut, utan att vänta på en riktig faktureringscykel.

Det RevenueCat inte ersätter

RevenueCat sköter köpmekaniken, inte att din produktsida och din paywall följer guideline 3.1.2. Det är fortfarande ditt ansvar att beskriva prenumerationen korrekt i din App Store-beskrivning, ange exakt pris och längd, och fylla i dina användarvillkor. Sidan prenumeration eller engångsköp på iOS hjälper dig att välja rätt modell redan innan du kommer till det här tekniska steget.

RevenueCat tar dessutom en provision på intäkterna över en viss månadsgräns, utöver Apples provision på prenumerationer som säljs i appen. Kolla de aktuella nivåerna på deras egen webbplats innan du bygger din affärsmodell kring de två provisionerna.

De vanligaste misstagen hos nybörjare

Att glömma laddningsläget. Vid start behöver RevenueCat en kort stund för att hämta användarens åtkomsträttigheter. Om appen visar betalinnehållet som standard innan svaret kommer kan en användare utan prenumeration under ett ögonblick se innehåll som hen inte har betalat för. Lägg in ett tydligt laddningsläge i stället för en optimistisk standardvisning.

Att kontrollera rättigheterna på fel ställe. Ett aktivt entitlement ska kontrolleras på nytt varje gång en betalskärm öppnas, inte bara en gång vid start. Om användaren avslutar eller om prenumerationen går ut medan appen används ska nästa skärm spegla ändringen.

Att blanda ihop sandbox och produktion. Produkt-ID:n och sandbox-testkonton är skilda från produktion. Ett test som fungerar i sandbox med fel Apple-konto, eller en produkt som bara skapats i produktion, kan ge det felaktiga intrycket att allt är klart.

En verifierad app, inte bara en app som kompilerar

En prenumeration som "funkar" i ett snabbtest på ditt eget konto garanterar inte att den klarar en återställning på en annan enhet eller en riktig utgång. Det är precis det en granskare på Apple kontrollerar. Sidan in-app-prenumeration på iOS går igenom hela kedjan, från att skapa produkterna till den slutliga kontrollen.

Om du vill utgå från en grund där paywall och prenumerationer redan finns i koden är det vad startkoden i iOS Kit innehåller. För att kontrollera din prenumeration som granskaren kommer att göra samlar Apple Review Kit min checklista inför inlämningen och anteckningarna du ska lämna till testaren för köp i appen.

Vanliga frågor

Hur sätter man upp en prenumeration med RevenueCat på iOS?

I fyra steg. Skapa först dina produkter i App Store Connect. Koppla sedan RevenueCat med din API-nyckel för App Store Connect och definiera dina entitlements (åtkomsträttigheterna), och bygg därefter paywallen. Avsluta med att testa köp, återställning och utgång: det är steget som ofta slarvas med, och ändå kontrolleras av Apple.

Måste man använda RevenueCat för att sälja en prenumeration på iOS?

Nej. StoreKit, Apples ramverk, låter dig sälja en prenumeration utan tredjepartstjänst. Men då skriver du själv all logik för köp, återställning och kontroll av åtkomsträttigheter, med kantfall som är lätta att glömma: byte av enhet, utgång, återbetalning. RevenueCat lägger sig mellan App Store Connect och din app så att du slipper det lagret.

Vad är ett entitlement i RevenueCat?

Ett entitlement är en åtkomsträttighet: det representerar det som prenumerationen låser upp, till exempel full åtkomst till appen, oavsett exakt vilken produkt som utlöste det. Om du senare lägger till en årsnivå kopplar du bara den nya produkten till samma entitlement. Koden som kontrollerar åtkomsten i appen behöver inte ändras.

Hur testar man en RevenueCat-prenumeration innan man skickar in till Apple?

Tre scenarier måste fungera innan du skickar in. Köp: med ett sandbox-testkonto låses åtkomsten upp direkt, utan omstart av appen. Återställning: på en ny enhet eller efter ominstallation, med samma Apple-konto, hittar återställningsknappen den aktiva prenumerationen. Utgång: i sandbox går prenumerationer ut på några minuter, så att du kan kontrollera att åtkomsten stängs.

Varför är en produkt som syns i RevenueCat osynlig för användarna?

Ofta för att produkten aldrig har ingått i en appinlämning. En produkt som skapats i App Store Connect men aldrig skickats in till den första granskningen med sin version förblir osynlig för dina användare, även om RevenueCat redan ser den. Det är en vanlig miss när produkterna skapas.

Tar RevenueCat provision på prenumerationer?

RevenueCat tar en provision på intäkterna över en viss månadsgräns. Den kommer utöver Apples provision på prenumerationer som säljs i appen. Kolla de aktuella nivåerna på RevenueCats webbplats innan du bygger din affärsmodell kring de två provisionerna.