Plans de base et offres d’abonnement Google Play
Deux questions déterminent ce qu’un Google Play abonné paie réellement, et elles se règlent à deux endroits différents. Le plan de base répond à « quelle période de facturation, à quel prix, à renouvellement automatique ou prépayé ? » L’offre répond à « qui est éligible à un démarrage moins cher, et pour combien de temps ? » Modélisez mal les offres d’abonnement et chaque demande marketing de période d’essai gratuite se transforme en un tout nouveau produit d’abonnement — ce qui fragmente votre catalogue, éclate votre reporting entre des produits qui ne pourront jamais être supprimés une fois achetés, et laisse le client avec une logique d’achat que personne n’ose toucher.
Ce tutoriel suit l’ordre qu’imposent réellement Play Console et la Billing Library : créer le produit, configurer les plans de base, ajouter des offres avec éligibilité, lire les jetons d’offre côté client, gérer les changements de plan avec le bon mode de remplacement, puis vérifier le droit d’accès sur votre serveur. Trois points font trébucher les équipes encore et encore : le jeton d’offre que le client doit transmettre explicitement, le mode de proratisation choisi lors d’une mise à niveau et la vérification serveur qui détermine si un essai gratuit est réel. Les dernières sections couvrent les pièges qui n’apparaissent qu’après la mise en ligne : écarts de tarification régionale, offres qui ne peuvent jamais être affichées et changement de prix qui devient discrètement un second plan de base.
1. Le modèle à trois niveaux : produit, plan de base, offre
Un Google Play abonnement se construit en trois couches, et leurs durées de vie sont totalement différentes. C’est ce qui détermine si la décision d’aujourd’hui pourra encore être modifiée dans deux ans.
- Produit — l’entrée du catalogue, identifiée par un ID de produit. L’ID ne peut pas être modifié après la création, et un produit que quelqu’un a acheté ne peut pas être supprimé, seulement désactivé. Nommez-le dès le premier jour pour ce qu’il est, pas pour la promotion en cours ce trimestre : « first_month_half_price » est un ID permanent pour une idée temporaire.
- Plan de base — la couche qui fixe réellement l’économie : période de facturation (hebdomadaire, mensuelle, 3 mois, 6 mois, annuelle), type de renouvellement (renouvellement automatique ou prépayé), prix par pays, ainsi que le délai de grâce et le comportement en cas de blocage du compte. Un produit peut porter plusieurs plans de base, ce qui permet précisément de vendre mensuel et annuel côte à côte sans second produit.
- Offre — un traitement tarifaire rattaché à un plan de base : essai gratuit, prix de lancement, remise de réengagement. Chaque offre comporte une condition d'éligibilité, et seuls les utilisateurs éligibles la voient.
Il y a une conséquence technique à retenir : le offerToken utilisé par le client pour acheter est l'identifiant d'une paire précise « plan de base + offre ». Dès qu'un produit possède plus d'un plan de base, ou une offre quelconque, le jeton doit être transmis explicitement — il n'y a pas de valeur par défaut. La section 5 est l'endroit où cette règle cesse d'être une anecdote et commence à expliquer de vrais plantages.
2. Étape 1 — créer le produit d’abonnement
Dans Play Console, allez dans Monétiser avec Play → Produits → Abonnements et créez un abonnement. Cette étape fait quatre choses, et chacune est soit irréversible, soit coûteuse plus tard.
- Product ID — lettres minuscules, chiffres et tirets bas, unique au sein de l’application, immuable et jamais réutilisable, même après suppression. Le renommer implique de créer un nouveau produit, donc un nouvel ID et un nouveau parcours d’achat.
- Nom — pour vous permettre de reconnaître la ligne dans la console. Ce que l'acheteur voit sur la fiche d'achat est généré par Play à partir du plan de base et de l'offre.
- Description et avantages — ce que comprend l’abonnement. Ce texte apparaît sur certains écrans du store et c’est ce que le support vous citera en retour.
- Enregistrer — vous avez enregistré un brouillon. Le produit ne devient achetable qu’une fois qu’au moins un plan de base existe et est actif.
L’erreur structurelle la plus fréquente consiste à créer des produits distincts pour le mensuel et l’annuel. Vous maintenez alors deux parcours d’achat, deux jeux d’états, deux chemins d’annulation — alors que Play a été conçu pour héberger les deux comme plans de base sous un seul produit. La migration ultérieure est douloureuse : faites-le bien du premier coup.
3. Étape 2 — configurer les plans de base
Les plans de base portent l’économie de l’abonnement. Chaque produit en nécessite au moins un ; la plupart en nécessitent deux (mensuel et annuel).
Choisissez d’abord le type de renouvellement. Une offre de base à renouvellement automatique facture à nouveau à la fin de chaque période, ce dont la plupart des abonnements de contenu et d’utilitaires ont besoin. Une offre de base prépayée vend une période fixe à l’avance et exige que l’utilisateur recharge à son terme — un bon choix pour les marchés à bas prix et pour les utilisateurs qui ne veulent pas de facturation récurrente. Les deux ne se mélangent pas : une offre prépayée n’a ni cycle de renouvellement, ni notion de délai de grâce, et ne peut pas inclure d’essai gratuit. Si les essais font partie de votre plan de croissance, l’offre principale doit être à renouvellement automatique.
Définissez ensuite la période et les prix. La période fixe le rythme de facturation ; les prix se saisissent par pays et par région. C’est la source de tickets d’assistance la plus fiable qui soit : Play ne permet de fixer un prix que pour certains pays, et un pays sans prix n’est tout simplement pas achetable. Les acheteurs y voient « article non disponible dans votre pays », ce qui leur semble un bug et ne ressemble à rien du tout dans votre console. Avant la mise en ligne, renseignez chaque marché cible et vérifiez que le prix affiché respecte les règles locales de représentation fiscale.
Enfin, les paramètres de cycle de vie — ils déterminent ce qui se passe lorsqu’un paiement échoue, pas lorsqu’il réussit :
- Délai de grâce — une fenêtre après un échec de paiement pendant laquelle l’utilisateur conserve son droit d’accès, le temps de corriger son moyen de paiement.
- Suspension du compte — une fois le délai de grâce écoulé sans paiement, l’accès est suspendu mais l’enregistrement de l’abonnement est conservé, si bien qu’un paiement ultérieur le rétablit.
- Se réabonner — permet à un utilisateur qui a annulé de revenir sur le même plan sans repasser par le parcours d’achat.
Les valeurs par défaut ne sont pas forcément les bonnes. Les applications utilitaires veulent généralement un délai de grâce et une suspension de compte ; les applications de contenu préfèrent souvent une rétrogradation plus rapide. Quel que soit votre choix, la correspondance côté serveur doit suivre, car l'API d'état des abonnements distingue le délai de grâce de la suspension de compte — les confondre sous « valide » revient à perdre cette information.
4. Étape 3 — ajouter les offres et l’éligibilité
Les offres sont le levier de conversion, et la couche la plus souvent mal configurée. Chaque offre comporte trois éléments : un identifiant d’offre, une ou plusieurs phases et une condition d’éligibilité.
Les phases déterminent le déroulé de l’offre dans le temps. Une phase est soit un essai gratuit (prix zéro, un nombre de jours), soit un prix réduit (un nombre de périodes à un montant donné). Les phases peuvent être cumulées, par exemple « 7 jours gratuits, puis 50 % de réduction sur le premier mois » — mais l’ordre des phases correspond à l’ordre dans lequel l’utilisateur paie réellement : les inverser revient à facturer d’abord et à offrir ensuite, ce qui génère à la fois des tickets d’assistance et des questions lors de l’examen.
L’éligibilité est le commutateur qui détermine qui verra un jour l’offre. Play impose trois conditions :
- Nouvel abonné — ne s’est jamais abonné à ce produit. La condition habituelle pour un essai gratuit.
- Mise à niveau — contient actuellement un autre abonnement éligible comme cible de mise à niveau.
- Réengagement — abonné par le passé, puis résilié ou expiré. Bien plus précis qu'un coupon général, et sans contaminer le prix que voient les nouveaux utilisateurs.
Les balises d’offre ne sont pas décoratives. Elles accompagnent l’achat et constituent le seul moyen propre de distinguer plus tard les conversions d’essai des achats au prix plein dans vos propres rapports et votre logique serveur. Si vous les omettez, au bout de trois mois, vous ne pourrez pas dire si les essais ont généré de la rétention.
Une offre n’affecte que les nouveaux achats. La modifier ou la désactiver ne change pas la facturation des abonnés qui y sont déjà. À l’inverse, pour appliquer un nouveau prix aux abonnés existants, il faut passer par le flux de changement de prix — pas par une nouvelle offre.
Deux limites méritent d’être notées. Chaque plan de base ne peut porter qu’un nombre limité d’offres : les promotions doivent donc être réutilisées plutôt que créées sans fin. Et quand un plan de base est lui-même inactif, toutes les offres qui en dépendent sont invendables : quand une offre « n’apparaît pas », vérifiez d’abord l’état du plan de base, ensuite l’éligibilité, et en dernier le code client.
5. Étape 4 — lire le bon jeton d’offre côté client
Product details return a list, not a single price. Querying a subscription yields subscriptionOfferDetails, where each entry is one "base plan + offer" combination carrying a basePlanId, an offerId (which may be empty, meaning the base plan's own full-price path) and an offerToken.
Acheter signifie transmettre explicitement une entrée de cette liste au flux de facturation : construire les ProductDetailsParams pour l’achat et y définir l’offerToken sélectionné. La règle est simple, et le coût de l’enfreindre est immédiat :
- Un plan de base et aucune offre — le jeton peut être omis, même s’il est plus sûr de le transmettre explicitement selon les versions de la bibliothèque.
- Plusieurs plans de base, ou une offre quelconque — omettre le token fait échouer l'achat. C'est la cause racine du classique « le mensuel fonctionne, l'annuel renvoie une erreur ».
- Le prix affiché dans l’interface doit provenir de l’entrée que vous avez sélectionnée, jamais du premier élément de la liste. Afficher $4.99 tout en facturant $49.99 est le bug le plus coûteux de cet article.
Écrivez explicitement la règle de sélection plutôt que de vous fier à l’ordre de la liste : identifiez le plan de base grâce au basePlanId que vous reconnaissez, puis choisissez l’offre la plus prioritaire qu’il contient réellement dans la liste renvoyée, et revenez à l’entrée au prix plein du plan de base lorsqu’aucune offre n’est disponible. L’éligibilité relève de Play — la liste que vous recevez correspond déjà à « ce que cet utilisateur peut acheter maintenant », donc ne réimplémentez pas les règles d’éligibilité en local et ne devinez pas.
Pendant les tests, utilisez un compte de test de licence et rappelez-vous que l’éligibilité s’applique aussi aux testeurs : un compte déjà abonné ne verra pas d’offre pour nouveaux abonnés. C’est un comportement attendu, pas un code défaillant. Pour vérifier l’affichage d’un essai, un compte neuf est la voie la plus rapide.
6. Étape 5 — mises à niveau, rétrogradations et modes de remplacement
Faire passer un utilisateur du mensuel à l’annuel, ou d’un palier basique à un palier premium, est un remplacement, pas un second achat. Le comportement de ce remplacement est déterminé par le mode de remplacement, et un mauvais choix signifie soit facturer deux fois l’utilisateur, soit laisser filer de l’argent sur toute une période.
- Avec prorata temporel — prend effet immédiatement et crédite la valeur restante de l’ancien abonnement sur le nouveau, de sorte que l’utilisateur paie la différence maintenant.
- Charge prorated price — prend effet immédiatement et facture le montant au prorata sur-le-champ ; couramment utilisé pour les rétrogradations afin que l’utilisateur ne consomme pas d’abord et ne règle qu’ensuite.
- Facturer le prix plein — s’applique immédiatement au prix plein du nouveau forfait, sans crédit pour le reliquat ; raisonnable uniquement lorsque le montant en jeu est inférieur au coût de son prorata.
- Sans prorata — prend effet immédiatement, le nouvel abonnement est facturé à partir du cycle suivant, et le reste de l’ancienne période s’écoule simplement. C’est l’option la plus favorable à l’utilisateur, la moins rentable pour vous, et un choix par défaut raisonnable pour les rétrogradations.
Dans la Billing Library 8, le point d’entrée est unifié sous setSubscriptionReplacementMode ; les anciens noms de méthodes des versions précédentes de la bibliothèque sont dépréciés. Si votre code les appelle encore, l’erreur de compilation est un cadeau — moins coûteuse que de découvrir en plein déploiement progressif que la sémantique diffère.
Les plans de base prépayés ne participent pas au remplacement : ils n’ont pas de cycle de renouvellement et expirent selon leur propre calendrier. Toute invite « passer du mensuel à l’annuel » doit exclure les utilisateurs prépayés, sinon vous leur montrez un bouton qui ne pourra jamais aboutir.
Une règle d’ordonnancement : une demande de remplacement échoue ou prend effet, jamais partiellement. N’accordez donc pas l’autorisation locale sur le client avant de l’envoyer — attendez que le serveur détienne le nouvel identifiant d’achat, puis débloquez.
7. Étape 6 — vérifier et accuser réception sur votre serveur
Ce que le client renvoie se résume à « l’utilisateur dit qu’il l’a acheté ». Le droit d’accès se décide côté serveur : appelez la recherche d’abonnement (purchases.subscriptionsv2) avec le jeton d’achat, récupérez l’état et l’expiration faisant foi, et inscrivez-les dans votre propre table de droits.
Le champ d'état vous indique à quel segment appartient l'utilisateur — actif, en délai de grâce, en attente, en pause, annulé, expiré, en cours. Ces états correspondent directement aux branches d'octroi : le délai de grâce conserve généralement l'accès, la mise en attente du compte le restreint généralement, la pause doit interrompre le service tout en conservant les données. Coder en dur la correspondance en « valide ou invalide » revient à jeter précisément les distinctions que Play fournit.
Ensuite, deux actions faciles à oublier. Accusez réception de l’achat sous trois jours, faute de quoi il est remboursé automatiquement ; le faire depuis le serveur est plus fiable que de faire confiance au client. Et connectez les notifications développeur en temps réel pour recevoir les renouvellements, annulations, entrées en délai de grâce, récupérations et confirmations de changement de prix. Une notification est un signal pour aller vérifier, pas l’état final : récupérez ensuite l’abonnement complet, dédupliquez sur l’ID de message et traitez de manière idempotente.
Bien articuler ces trois couches boucle la boucle : le client initie, le serveur arbitre, les notifications assurent la réactivité.
8. Les pièges qui n'apparaissent qu'après la mise en ligne
Ces problèmes apparaissent rarement en test et surviennent d'un coup avec le trafic réel.
- Lacunes de tarification régionale — un nouveau marché est ajouté et la grille tarifaire n’est pas renseignée, si bien que les acheteurs y voient « non disponible ». Parcourir une fois la fiche d’achat avec un compte de cette région vaut mieux que de faire confiance à un tableau de la console.
- Modifier un prix dans le mauvais sens — modifier une offre de base existante déclenche le flux de changement de prix, dans lequel les abonnés actuels doivent confirmer avant que le nouveau tarif s’applique. Si l’objectif est « les anciens utilisateurs gardent l’ancien prix, les nouveaux paient le nouveau », la réponse habituelle est une nouvelle offre de base et un changement de ce que vous vendez, pas une modification. Décidez du résultat souhaité avant de toucher au prix.
- Désactiver une offre avec des abonnés actifs — la désactivation bloque uniquement les nouveaux achats ; les abonnés existants conservent l’offre jusqu’à la fin de la période. Ce n’est pas un bug, mais un script de support que vous devriez avoir sous la main.
- Transformer chaque promotion en nouveau produit — vous finissez avec des produits non supprimables, un reporting fragmenté et une logique client que personne ne voudra refactoriser.
- Oublier les balises d’offre — sans elles, impossible de distinguer les conversions d’essai des achats directs, donc impossible de dire quelle promotion a réellement fidélisé.
- Visible pour les testeurs, invisible pour les utilisateurs — l'éligibilité s'applique aussi aux comptes de test. Vérifier avec un compte propre est la voie de débogage la plus rapide dont vous disposez.
9. Où se situe KappS
La configuration des abonnements est une décision produit, mais elle repose sur des comptes qui doivent rester conformes pendant des années : profil de paiement, informations fiscales, statut de vérification du développeur. Si l’un de ces éléments casse, la chaîne de revenus casse au pire moment. KappS prépare et soumet des éléments conformes et maintient les comptes et l’état de publication en bonne santé, pour que ces prérequis cessent d’être une variable.
- Cohérence du compte et des paiements — identité du développeur, profil de paiement et bénéficiaire réel alignés, pour que le règlement ne bloque pas sur des informations discordantes.
- Revue de la configuration fiscale et régionale — W-8BEN/W-9, taux de retenue et marchés cibles vérifiés avant la mise en ligne, pas après un versement incomplet.
- Un second regard sur la configuration — plans de base, éligibilité aux offres et gestion des jetons côté client, en particulier sur les portefeuilles multi-produits, multi-régions et multilingues.
Nous ne proposons rien qui contourne les règles des plateformes : les prix et les essais doivent être réels, l’éligibilité doit suivre les définitions de Play, et chaque achat doit passer la vérification côté serveur. Ce sont à la fois les règles et la seule version de ce service qui continue de fonctionner.
Sources (documentation Google) : aide Play Console — créer et configurer des abonnements, des plans de base, des offres et l’éligibilité, des forfaits prépayés ; Android Developers — intégration Play Billing, modes de remplacement d’abonnement, vérification côté serveur, notifications développeur en temps réel.
Vous gérez des comptes développeur à grande échelle ? Nous prenons en charge le volet opérationnel.
Nous avons bien reçu votre message et vous répondrons sous 24 heures.
← Retour à la modification