RevenueCat: configurar una subscripció in-app a iOS

Per què fer servir RevenueCat i no només StoreKit

StoreKit, el framework d'Apple, et permet vendre una subscripció sense cap servei de tercers. Però per a un principiant, escriure tu mateix tota la lògica de compra, restauració i verificació dels drets d'accés és molt codi per mantenir, amb casos límit fàcils d'oblidar: canvi de dispositiu, caducitat, reemborsament.

RevenueCat se situa entre App Store Connect i la teva app: llegeix els teus productes, gestiona les subscripcions actives i t'estalvia escriure aquesta capa tu mateix. Continues controlant el preu i les ofertes des d'un tauler, sense tornar a publicar l'app a cada canvi.

Pas 1: crear els productes a App Store Connect

Abans de RevenueCat, els productes han d'existir a la banda d'Apple. A App Store Connect, crea un grup de subscripcions i després un o diversos nivells amb la seva durada, mensual o anual per exemple, i el seu preu per territori. Omple també els textos que es mostren a l'usuari per a cada nivell: Apple els demana abans d'acceptar el producte a revisió.

Un oblit freqüent en aquest punt: un producte creat però que mai s'ha enviat a la primera revisió de l'app amb la seva versió associada. Un producte pendent que mai s'ha inclòs en un enviament d'app continua sent invisible per als teus usuaris, encara que RevenueCat ja el vegi.

Pas 2: connectar RevenueCat amb la teva app

A RevenueCat, crees un projecte, hi connectes la teva clau d'API d'App Store Connect perquè RevenueCat sincronitzi automàticament els productes, i després defineixes els "entitlements", els drets d'accés. Un entitlement representa el que desbloqueja la subscripció, per exemple l'accés complet a l'app, independentment del producte concret que l'ha activat.

Aquesta capa intermèdia és útil: si més endavant canvies l'estructura de les ofertes, per exemple afegint un nivell anual, simplement connectes el nou producte al mateix entitlement, sense tocar el codi que verifica l'accés a la teva app.

A la banda de l'app, el SDK de RevenueCat per a React Native s'instal·la en un projecte Expo amb un plugin específic, i ofereix una funció senzilla per saber si l'usuari actual té un entitlement actiu.

Pas 3: construir el paywall

El paywall és la pantalla que presenta l'oferta i llança la compra. RevenueCat ofereix paywalls configurables des del tauler, modificables sense tornar a publicar l'app, o pots construir el teu amb el SDK si vols un control complet sobre el disseny.

La ubicació compta tant com el disseny. Un paywall que apareix abans que la persona hagi vist el valor de l'app sol convertir pitjor que un paywall situat just després d'una primera acció reeixida. La guia dels errors de paywall iOS per a principiants detalla els paranys més freqüents en aquest punt, més enllà de la simple connexió tècnica.

Pas 4: provar la compra, la restauració i la caducitat

És el pas que més sovint es fa de pressa, i tanmateix el que Apple verifica més. Tres escenaris han de funcionar abans de l'enviament:

La compra. Amb un compte de prova sandbox, la compra ha de desbloquejar l'entitlement immediatament, i la teva app ha de reaccionar a aquest canvi sense haver de reiniciar-la.

La restauració. En un dispositiu nou o després de reinstal·lar, amb el mateix compte d'Apple, un botó "Restaurar les compres" ha de recuperar la subscripció activa. Apple verifica sistemàticament aquest recorregut a la revisió, i que falti o no funcioni bé és un motiu de rebuig freqüent segons la guideline 3.1.1.

La caducitat. A l'entorn sandbox, les subscripcions caduquen en pocs minuts en lloc de diversos mesos, cosa que et permet comprovar que l'accés es tanca correctament un cop acabat el període, sense esperar un cicle de facturació real.

El que RevenueCat no substitueix

RevenueCat gestiona la mecànica de compra, no la conformitat de la teva fitxa ni la del teu paywall respecte a la guideline 3.1.2. Continua sent cosa teva descriure correctament la subscripció a la descripció de l'App Store, indicar-ne el preu exacte i la durada, i informar les teves condicions d'ús. La pàgina subscripció o compra única a iOS t'ajuda a triar el model adequat fins i tot abans d'arribar a aquest pas tècnic.

A més, RevenueCat cobra una comissió sobre els ingressos a partir d'un cert llindar mensual, a més de la comissió d'Apple sobre les subscripcions venudes dins l'app. Comprova els trams actuals al seu propi web abans de construir el teu model de negoci al voltant d'aquestes dues comissions.

Els errors més freqüents d'un principiant

Oblidar l'estat de càrrega. En obrir l'app, RevenueCat necessita un moment per recuperar els drets d'accés de l'usuari. Si la teva app mostra el contingut de pagament per defecte abans d'aquesta resposta, un usuari sense subscripció pot veure, durant un instant, contingut que no ha pagat. Preveu un estat de càrrega explícit en lloc d'una visualització per defecte optimista.

Verificar els drets al lloc equivocat. Un entitlement actiu s'ha de tornar a verificar cada cop que s'obre una pantalla de pagament, no només una vegada a l'inici. Si l'usuari cancel·la o si la subscripció caduca mentre fa servir l'app, la pantalla següent ha de reflectir aquest canvi.

Confondre l'entorn sandbox amb producció. Els identificadors de producte i els comptes de prova sandbox són diferents dels de producció. Una prova que funciona en sandbox amb el compte d'Apple equivocat, o un producte creat només en producció, pot donar la falsa impressió que tot està llest.

Una app verificada, no només una app que compila

Una subscripció que "funciona" en una prova ràpida amb el teu propi compte no garanteix que sobrevisqui a una restauració en un altre dispositiu o a una caducitat real. És exactament el que verifica un revisor d'Apple. La pàgina subscripció in-app iOS detalla tota aquesta cadena, des de la creació dels productes fins a la verificació final.

Si vols partir d'una base on el paywall i les subscripcions ja són al codi, és el que conté el codi de partida de l'iOS Kit. Per verificar la teva subscripció com ho farà el revisor, l'Apple Review Kit reuneix la meva checklist abans de l'enviament i les notes que cal deixar al revisor per a la compra integrada.

Preguntes freqüents

Com es configura una subscripció amb RevenueCat a iOS?

En quatre passos. Primer crea els teus productes a App Store Connect. Després connecta RevenueCat amb la teva clau d'API d'App Store Connect i defineix els entitlements (els drets d'accés), i construeix el paywall. Acaba provant la compra, la restauració i la caducitat: és el pas que sovint es fa de pressa, i tanmateix Apple el verifica.

RevenueCat és obligatori per vendre una subscripció a iOS?

No. StoreKit, el framework d'Apple, et permet vendre una subscripció sense cap servei de tercers. Però llavors escrius tota la lògica de compra, restauració i verificació dels drets d'accés, amb casos límit fàcils d'oblidar: canvi de dispositiu, caducitat, reemborsament. RevenueCat se situa entre App Store Connect i la teva app per estalviar-te aquesta capa.

Què és un entitlement a RevenueCat?

Un entitlement és un dret d'accés: representa el que desbloqueja la subscripció, per exemple l'accés complet a l'app, sigui quin sigui el producte concret que l'ha activat. Si més endavant afegeixes un nivell anual, simplement connectes el nou producte al mateix entitlement. El codi que verifica l'accés a la teva app no ha de canviar.

Com es prova una subscripció de RevenueCat abans d'enviar-la a Apple?

Tres escenaris han de funcionar abans de l'enviament. Compra: amb un compte de prova sandbox, l'accés es desbloqueja immediatament, sense reiniciar l'app. Restauració: en un dispositiu nou o després de reinstal·lar, amb el mateix compte d'Apple, el botó de restauració recupera la subscripció activa. Caducitat: en sandbox, les subscripcions caduquen en pocs minuts, cosa que et permet comprovar que l'accés es tanca.

Per què un producte visible a RevenueCat continua invisible per als usuaris?

Sovint perquè el producte mai s'ha inclòs en un enviament d'app. Un producte creat a App Store Connect però que mai s'ha enviat a la primera revisió amb la seva versió associada continua invisible per als teus usuaris, encara que RevenueCat ja el vegi. És un oblit freqüent en el pas de creació dels productes.

RevenueCat cobra comissió sobre les subscripcions?

RevenueCat cobra una comissió sobre els ingressos a partir d'un cert llindar mensual. S'afegeix a la d'Apple sobre les subscripcions venudes dins l'app. Comprova els trams actuals al web de RevenueCat abans de construir el teu model de negoci al voltant d'aquestes dues comissions.