Luseri : un tableau de bord du MRR pour ton application Shopify
Luseri est un tableau de bord qui recalcule le MRR de ton application Shopify (ton revenu mensuel récurrent) à partir de ton compte Partner, en lecture seule, et montre ce qui l'a fait bouger chaque jour : nouveaux abonnés, montées en gamme, baisses de forfait, résiliations et retours d'anciens abonnés. L'argent que Shopify a réellement facturé pour toi s'affiche à part, dans la devise de tes versements, avec une fiche pour chaque boutique et un bilan par e-mail chaque lundi.
Par Arthur Renard, mis à jour le
Le voir dans la démonstration
L'écran Revenus du tableau de bord, avec des chiffres d'exemple. Il s'ouvre sans compte.
Ce que montre la page Revenus
La page Revenus répond à trois questions : combien ton application rapporte chaque mois, d'où vient ce revenu, et ce qui l'a fait monter ou baisser. Les chiffres portent sur la période que tu choisis (7 jours, 30 jours, 90 jours, 12 mois, ou deux dates de ton choix dans la dernière année) et se comparent à la période juste avant.
| Chiffre | Ce que c'est |
|---|---|
| Revenu mensuel récurrent (MRR) | Le prix mensuel de chaque abonnement payant actif ce jour-là. Un forfait annuel compte pour un douzième de son prix. |
| Ce qui fait bouger ton revenu récurrent | Les gains et les pertes sur chaque morceau de la période : nouveaux abonnés, montées en gamme et retours d'anciens abonnés au-dessus de la ligne, baisses de forfait et résiliations en dessous, avec le solde. |
| Revenu encaissé | Tout ce qui a été facturé à tes marchands sur la période, abonnements, frais d'usage (facturés en plus selon la consommation) et achats ponctuels, dans la devise de tes versements, réparti par type. |
| Revenu moyen par abonné | Le revenu encaissé sur la période, ramené à un mois, divisé par le nombre de boutiques qui paient à la fin de la période. |
| Revenu récurrent perdu en résiliations | La part du MRR que tu avais au début de la période que les résiliations emportent chaque mois. |
| Détail par forfait | Le prix, les abonnés et le MRR de chaque forfait avec leur évolution, et ton revenu annuel récurrent (ARR) au rythme actuel, c'est-à-dire ton MRR multiplié par 12. |
| Prochain versement, estimé | Ce qui a été facturé sur les 15 derniers jours, moins les frais retenus par Shopify. La date et le montant exacts sont dans le Dev Dashboard de Shopify, dans les réglages de l'organisation. |
La page Indicateurs donne à chacun de ces chiffres, et à d'autres comme la valeur d'un abonné sur sa durée (la LTV), la part des essais devenus abonnés ou le revenu des 12 derniers mois, sa propre courbe et une définition en une ligne.
Comment chaque mouvement du MRR est compté
Luseri rejoue les événements de chaque boutique dans l'ordre où Shopify les a enregistrés, et additionne ce que chacun change. La méthode complète, ses cas limites et le calcul du churn (la part d'abonnés ou de revenu perdue chaque mois) sont dans la méthode de calcul de Luseri ; la démarche générale, quel que soit ton outil, est dans comment calculer le MRR d'une application Shopify.
| Mouvement | Quand il est compté | Effet sur le MRR |
|---|---|---|
| Nouvel abonné | Le premier paiement d'une boutique : quand son forfait payant est activé, ou quand son essai gratuit se termine | Plus le prix mensuel du forfait |
| Montée en gamme ou baisse de forfait | Une boutique qui paie passe à un autre forfait. Une résiliation suivie, dans les 10 minutes, de l'activation d'un autre forfait est lue comme un changement de forfait, pas comme un départ | Plus ou moins l'écart de prix |
| Résiliation | L'abonnement d'une boutique qui paie est résilié ou expire, la boutique désinstalle l'application, ou Shopify gèle le prélèvement | Moins le prix mensuel du forfait |
| Retour d'un ancien abonné | Une boutique qui a déjà payé se réabonne, ou un prélèvement gelé reprend | Plus le prix mensuel du forfait |
Un forfait dont la première date de facturation tombe plus de 12 heures après son activation est traité comme un essai gratuit : il entre dans le MRR à cette date, s'il est toujours actif. Les prélèvements de test sont écartés. Quand un marchand ferme ou met en pause sa boutique, son abonnement sort du MRR, et revient comme un retour d'ancien abonné si la boutique rouvre.
L'argent encaissé, à part du MRR
Le MRR, c'est le prix des forfaits de tes marchands. Le revenu encaissé, c'est ce que Shopify a réellement facturé pour toi, lu dans tes versements. Les deux coïncident rarement : les frais d'usage et les achats ponctuels sont de l'argent encaissé mais pas du revenu récurrent, une boutique en essai n'apporte ni l'un ni l'autre, et un forfait peut avoir un prix dans une devise alors que tes versements arrivent dans une autre. Le tableau de bord montre donc chaque chiffre dans sa devise et ne les additionne jamais.
Quand tes versements sont lisibles, les frais retenus par Shopify s'affichent à côté. Quand ils ne le sont pas, le revenu encaissé est estimé à partir des abonnements, sans les frais de Shopify, et le tableau de bord le dit. Pour voir ce que la part de revenu de Shopify et ses frais de traitement retirent d'un revenu donné, sers-toi du calculateur de part de revenu.
Une fiche pour chaque boutique
La page Marchands liste toutes les boutiques qui ont installé ton application, y compris celles qui sont parties. Clique sur l'une d'elles pour ouvrir sa fiche :
- Son statut : abonnée, en essai, au forfait gratuit, fermée ou suspendue (boutique fermée ou en pause, ou facturation suspendue par Shopify), ou désinstallée.
- Son forfait actuel et ce qu'elle paie par mois.
- Ce qu'elle a payé en tout depuis son installation, et il y a combien de temps elle a payé pour la dernière fois.
- La date de son installation, et les 40 derniers événements de son historique : installations, essais, paiements, changements de forfait, suspensions, avoirs (des crédits accordés à la boutique), et la désinstallation avec la raison donnée par le marchand.
Des listes prêtes à l'emploi rangent les boutiques pour toi : abonnés actifs, essais en cours, essais convertis et abandonnés, montées en gamme et baisses de forfait, abonnés sans paiement depuis 30 jours, et tes 15 meilleurs clients. Tu peux composer tes propres listes à partir de conditions, les garder, et exporter n'importe quelle liste dans un fichier CSV, qui s'ouvre dans un tableur.
Le bilan du lundi par e-mail
Chaque lundi, chaque application reliée reçoit un court bilan par e-mail, dans la langue de ton compte. Les chiffres ci-dessous sont inventés, pour montrer sa forme :
| Ligne de l'e-mail | Exemple (chiffres inventés) |
|---|---|
| Revenu mensuel récurrent | 4 210 $ (+130 $ en 7 jours) |
| Installations | 38, contre 31 la semaine d'avant |
| Désinstallations | 12, contre 14 la semaine d'avant |
| Nouveaux abonnés | 6 |
Un bouton ouvre la page Bilan du tableau de bord. Le bilan ne part que vers une adresse confirmée, et un lien en bas de chaque e-mail, ou tes réglages, l'arrête. L'autre e-mail, une alerte quand les désinstallations augmentent nettement, est décrit sur la page du suivi des désinstallations.
D'où viennent les chiffres
Tout ce qui figure sur ces pages vient de l'API Partner de Shopify, l'interface que Shopify donne aux développeurs d'applications pour lire leur compte Partner. Deux sortes de données sont lues :
- Les événements de l'application : installations, désinstallations, fermetures et réouvertures de boutiques, et événements d'abonnement, chacun avec le nom du forfait, son montant, sa devise et sa première date de facturation.
- Les versements : ce qui a été facturé pour chaque prélèvement et les frais retenus par Shopify, et, avec la permission « View financials », si un abonnement est facturé tous les 30 jours ou une fois par an.
L'accès est un client d'API (une clé d'accès) que tu crées dans le Dev Dashboard de Shopify, dans les réglages de l'organisation, avec la permission « Manage apps », dont Shopify dit qu'elle donne accès aux événements de l'application comme les installations, les désinstallations et les prélèvements. C'est en général suffisant, car Shopify rend aussi les versements sous forme d'événements historiques avec cette permission. Le code de Luseri n'envoie que des lectures à l'API Partner et refuse tout le reste : rien n'est jamais modifié dans ton compte. Le jeton est rangé chiffré et ne repart jamais vers ton navigateur.
Les chiffres se mettent à jour tout seuls une fois par jour, et de nouveau quand tu ouvres le tableau de bord s'ils datent de plus d'une heure. L'assistant IA du tableau de bord répond à tes questions sur ces chiffres, par exemple pourquoi ton MRR a baissé le mois dernier, à partir du résumé que la page lui envoie. Il s'appuie sur Claude, un modèle conçu par Anthropic, ne demande aucune clé d'API de ta part, et accepte jusqu'à 40 questions par jour et par compte, sans limite pour un usage normal pour les membres fondateurs (les comptes créés avant les forfaits payants).
Comment relier ton application
Compte environ cinq minutes, une seule fois.
- Crée ton compte Luseri avec une adresse e-mail et un mot de passe, puis confirme l'adresse.
- Ouvre ton application dans ton tableau de bord Shopify Partner et copie l'adresse de la page : Luseri y lit le numéro de ton organisation et celui de ton application.
- Dans le Dev Dashboard, ouvre « Organization settings », puis « Users », puis « Security », et crée un client d'API Partner nommé Luseri avec seulement « Manage apps » coché. Shopify affiche alors son jeton, la clé secrète du client, qui commence par prtapi_.
- Colle le jeton. Luseri vérifie les trois valeurs auprès de Shopify avant de garder quoi que ce soit.
- Ton historique est recopié depuis Shopify en une minute environ, un peu plus pour une application qui a un long historique. Tes chiffres se tiennent ensuite à jour tout seuls.
Un compte peut relier jusqu'à 10 applications. Retirer une application efface ce qui a été recopié pour elle, et supprimer ton compte efface tout, tout de suite. Ta fiche App Store et Google Analytics se relient ensuite, en une étape chacun.
Les limites à connaître
- Les devises ne sont pas converties. Si tes forfaits ont des prix dans plusieurs devises, ou si tes versements arrivent dans plusieurs, les montants sont additionnés tels quels, et le tableau de bord te prévient que le total est approximatif.
- Les forfaits annuels demandent « View financials ». Sans cette permission, les événements de versement de Shopify ne disent pas si un abonnement est annuel : un forfait annuel compte alors dans le MRR comme si son prix d'un an était facturé chaque mois. Si tu vends des forfaits annuels, coche aussi « View financials » sur le client d'API. Shopify attache à cette permission des actions d'écriture, comme l'annulation de l'abonnement d'un marchand ; Luseri n'envoie toujours que des lectures.
- Le MRR laisse de côté les frais d'usage, les achats ponctuels, les prélèvements de test et les essais pas encore terminés. Les avoirs que tu accordes apparaissent dans l'historique de la boutique mais ne baissent pas le MRR.
- Le MRR est un prix, pas un versement : la part de revenu de Shopify, ses frais de traitement, les remboursements et le calendrier des versements se placent entre les deux.
- Le prochain versement est une estimation. Le montant et la date exacts sont dans le Dev Dashboard de Shopify, dans les réglages de l'organisation.
- Luseri ne fait que lire : il ne facture pas tes marchands, ne change pas leurs forfaits et n'accorde pas d'avoirs.
Questions
- Shopify montre-t-il le MRR de mon application ?
- Non. Les tableaux de bord de Shopify montrent un revenu, des gains et des versements, pas de revenu mensuel récurrent. Le MRR se recalcule à partir des événements d'abonnement de l'API Partner, boutique par boutique : c'est ce que fait Luseri, en lecture seule.
- De quelle permission de l'API Partner Luseri a-t-il besoin ?
- De « Manage apps », qui donne accès aux événements de l'application comme les installations, les désinstallations et les prélèvements. Ajoute « View financials » seulement si tu vends des forfaits annuels : sans elle, Shopify ne dit pas si un abonnement est annuel. Dans tous les cas, le code de Luseri n'envoie que des lectures.
- Luseri peut-il modifier quelque chose dans mon compte Shopify ?
- Non. Son code refuse d'envoyer autre chose qu'une lecture à l'API Partner, et il ne facture pas tes marchands, ne change pas leurs forfaits et n'accorde pas d'avoirs. Pour lui couper l'accès, retire l'application dans Luseri ou supprime le client d'API dans ton tableau de bord Partner.
- Jusqu'où remonte l'historique des revenus ?
- Luseri recopie l'historique des événements de ton application depuis l'API Partner : le MRR est donc recalculé à partir du passé de ton application, pas seulement depuis le jour où tu la relies. Les pages montrent jusqu'aux 12 derniers mois, chacun comparé à la période d'avant.
- Combien coûte Luseri ?
- Luseri est gratuit pour l'instant, le temps d'accueillir ses premiers utilisateurs. Ses conditions disent que s'il devient payant, ses utilisateurs sont prévenus par e-mail au moins 30 jours avant, et que rien ne leur est facturé sans leur accord.
Sources
- API Partner de Shopify : authentification, permissions et limites de requêtes
- API Partner de Shopify : types d'événements d'une application
- API Partner de Shopify : AppSubscriptionSale, le versement d'un abonnement
- API Partner de Shopify : durées de facturation (AppPricingInterval)
- API Partner de Shopify : événements historiques
- Luseri : politique de confidentialité
- Luseri : conditions d'utilisation