RevenueCat : revenus d'abonnement dans Finance
Brancher RevenueCat donne à Appwin les chiffres d'abonnement de ton app : MRR, revenus, churn, abonnés actifs, essais.
C'est la source de la quasi-totalité du produit Finance. Sans elle, la page reste vide et propose de connecter le compte.
Accès en lecture seule. Appwin ne crée ni ne modifie rien dans RevenueCat.
1. Créer une clé secrète
Dans RevenueCat, sur ton projet :
- Project settings → API keys
- Section Secret API keys → bouton + New
- Nomme la clé (« appwin »)
- Coche au minimum les permissions en lecture sur
projects,apps,customersetcharts - Copie la clé affichée
La clé secrète n'est visible qu'à sa création. RevenueCat ne la réaffiche jamais : range-la dans ton gestionnaire de mots de passe avant de fermer l'onglet.
Secrète, pas publique
| Clé | Préfixe | Rôle |
|---|---|---|
| Secret API key | sk_… | Serveur à serveur - c'est celle-ci |
| Public SDK key iOS | appl_… | Embarquée dans ton app |
| Public SDK key Android | goog_… | Embarquée dans ton app |
Coller une clé publique donne un 401 sur tous les appels : elle n'ouvre pas l'API de reporting.
2. Relever le Project ID
Project settings → General → « Project ID », de la forme proj1a2b3c4d.
C'est aussi le segment après /projects/ dans l'URL du dashboard RevenueCat.
Le champ est facultatif. Laissé vide, Appwin interroge GET /v2/projects
avec ta clé et prend le premier projet accessible - ce qui suffit dans le cas
courant d'une clé pour un projet. Renseigne-le dès que ton compte porte
plusieurs projets, sinon les chiffres affichés peuvent être ceux d'une autre
app.
3. Renseigner dans Appwin
Réglages → Projets → ton app → Intégrations → RevenueCat.
| Champ | Valeur |
|---|---|
| API Key (secret) | sk_AbCdEfGhIjKlMnOpQrStUvWx |
| Project ID | proj1a2b3c4d (facultatif) |
Ce que ça débloque
Les métriques de Finance alimentées par RevenueCat :
| Métrique | Contenu |
|---|---|
| MRR | Revenu mensuel récurrent |
| ARR | Revenu annuel récurrent |
| Revenue | Revenus encaissés sur la période |
| Churn | Taux d'attrition |
| Active subscribers | Abonnés actifs |
| Refund rate | Taux de remboursement |
| LTV per customer | Valeur vie moyenne |
| New trials | Essais démarrés |
| Trial conversion rate | Conversion des essais en payant |
| New customers | Nouveaux clients |
Chacune s'affiche en valeur unique ou en série temporelle, sur les périodes proposées par le produit (7 jours à 1 an, MTD, QTD, YTD, mois/trimestre/année précédents).
Fraîcheur et limites de débit
RevenueCat limite l'API Charts à 15 requêtes par minute et par projet. Appwin s'y tient avec une file d'attente par projet, et met les réponses en cache.
| Période | Cache | Pourquoi |
|---|---|---|
| En cours (le mois courant) | 1 à 5 minutes | Le chiffre bouge encore |
| Close (un mois terminé) | 1 à 24 heures | Le chiffre ne bougera plus |
Conséquence pratique : un rafraîchissement de page ne relance pas forcément un appel, et un chiffre du jour peut avoir quelques minutes de retard. C'est volontaire - sans cache, une poignée d'utilisateurs consommerait le quota en quelques secondes.
Dépannage
| Symptôme | Cause probable |
|---|---|
| 401 sur tous les appels | Clé publique (appl_/goog_) au lieu d'une clé secrète (sk_) |
| 403 sur les graphiques | Permission charts non cochée à la création de la clé |
| Chiffres d'une autre app | Plusieurs projets sur le compte, Project ID laissé vide |
| Page Finance vide | Aucune donnée RevenueCat sur la période choisie |
| Chiffre figé quelques minutes | Cache de période en cours - comportement attendu |