Le guide suprême pour tester les abonnements sur Android

Vous avez déjà implémenté la logique de gestion des accès pour votre application d’abonnement, il est maintenant temps de la tester. Avant de faire examiner votre application par le service Google Play Console, assurez-vous qu’elle répond aux changements de statut d’abonnement et qu’elle permet aux utilisateurs d’accéder à votre contenu premium. Les actions liées à des événements du cycle de vie de l’abonnement doivent conduire à des mises à jour de l’accès des utilisateurs. 

Aujourd’hui, nous allons suivre les conseils détaillés de Google et explorer les principaux scénarios de test d’abonnement.

Conditions préalables

Avant de commencer, assurez-vous de ceci :

  • Il y a des abonnements actifs dans Google Play Console
  • La logique d’achat des abonnements est implémentée dans votre application

Configuration de l’environnement Sandbox (environnement de test)

Examen de licence

Tout d’abord, on doit configurer la liste des testeurs de la licence pour accéder à toutes les possibilités de test des abonnements. Après avoir ajouté l’adresse Gmail d’un testeur dans Google Play Console, vous devez vous connecter à l’appareil avec l’e-mail. Les utilisateurs du test de licence peuvent acheter des abonnements gratuitement et utiliser l’une des deux méthodes de paiement :

  • Carte de test, toujours approuvé
  • Carte de test, toujours refusé

Dispositifs d’essai

Vous pouvez utiliser à la fois des appareils physiques et des émulateurs pour tester les abonnements. Pour les émulateurs, assurez-vous que le Play Store est installé sur l’appareil. Vous pouvez le vérifier en sélectionnant Tools -> AVD Manager dans Android Studio.

Périodes d’abonnement aux tests

Les abonnements sont renouvelés automatiquement jusqu’à ce qu’ils soient annulés. Les abonnements aux tests peuvent être renouvelés jusqu’à six fois, puis ils sont automatiquement annulés. Subscription Duration (durée de l’abonnement) dans l’environnement Sandbox diffère de celle de la production et est raccourcie à des fins de test : 

Durée de l’abonnementRenouvellement de l’abonnement aux tests
1 semaine5 minutes
1 mois5 minutes
3 mois10 minutes
6 mois15 minutes
1 an30 minutes

La durée des états d’abonnement, comme le délai de grâce, est également réduite dans l’environnement Sandbox : 

État de l’abonnementPériode d’essai
Essai gratuit3 minutes
Période du prix de lancementIdentique à la période d’essai de l’abonnement
Délai de grâce5 minutes
Compte bloqué10 minutes

Tester les fonctionnalités spécifiques à l’abonnement

Achat d’un abonnement avec paiement réussi 

  1. Achetez un abonnement hebdomadaire avec le mode de paiement suivant : Carte de test, toujours approuvé

2. Vérifiez que vous avez reçu un e-mail de Google Play confirmant l’achat de l’abonnement. 

3. Assurez-vous que votre application débloque le contenu premium après l’achat.

4. Attendez 5 minutes pour le prochain renouvellement. Redémarrez l’application et vérifiez si vous avez toujours accès au contenu. 

5. Attendez 25 minutes pour cinq autres renouvellements. À la fin de la dernière période de renouvellement, Google Play annule l’abonnement. Vérifiez que vous avez reçu un e-mail de Google confirmant l’annulation de l’achat.

6. Assurez-vous que le contenu premium n’est plus disponible pour vous.

Annuler un abonnement actif

1. Assurez-vous que vous avez un abonnement actif dans votre application.

2. Ouvrez Google Play et cliquez sur l’icône du compte en haut à droite de l’écran. Choisissez Payments & Subscriptions – > Subscriptions.
(Paiements et abonnements -> Abonnements)

3. Tapez sur l’abonnement actif. 

4. L’onglet Manage Subscription (Gérer l’abonnement) s’ouvre. Cliquez sur le bouton Cancel Subscription (Annuler l’abonnement) et confirmez l’annulation. L’abonnement sera actif pour toute la période de facturation en cours. Mais le prochain renouvellement ne sera pas traité. 

5. Vérifiez que votre application permet toujours l’accès pendant la période de facturation en cours. 

6. Après la fin de la période de facturation, l’abonnement sera annulé. Assurez-vous que votre application a cessé de fournir l’accès au contenu. 

Essayez d’acheter un abonnement avec la méthode d’échec 

1. Dans la boîte de dialogue d’achat, sélectionnez le mode de paiement suivant : Testez la carte, refusez toujours et cliquez sur Subscribe (S’abonner).

2. Google Play renverra une erreur.

3. Assurez-vous que votre application traite l’erreur correctement et ne donne pas accès au contenu premium.  

Récupération de l’accès

Les utilisateurs ont parfois besoin de restaurer les achats actifs lorsqu’ils réinstallent votre application pour une raison quelconque ou lorsqu’ils utilisent l’application sur plusieurs appareils. Si l’utilisateur utilise le même compte Google, votre application doit offrir la possibilité de restaurer les abonnements pour maintenir l’accès au contenu acheté. Pour plus d’informations, consultez le guide sur le cycle de vie des abonnements dans les documents Google. Les cas de test suivants supposent que vous vérifiez les abonnements actifs au début de votre application.

Réinstaller l’application

  • Assurez-vous que votre abonnement est actif et que l’application vous donne droit au contenu premium. 
  • Réinstallez et ouvrez l’application sur le même appareil.
  • Assurez-vous que votre application accorde correctement l’accès à l’utilisateur.

Dispositifs multiples

  • Exécutez votre application sur l’appareil n° 1 et souscrivez un abonnement.
  • Assurez-vous que vous avez accès au contenu premium. 
  • Installez et ouvrez l’application sur l’appareil n° 2. 
  • Assurez-vous que votre application accorde correctement l’accès à l’utilisateur.

Essais gratuits 

Si vous souhaitez donner aux nouveaux abonnés la possibilité d’utiliser l’abonnement gratuitement pendant une période déterminée, configurez l’option Free Trial (Essai gratuit) comme étant activée et spécifiez sa durée dans les paramètres de l’abonnement dans Google Play Console.

Par défaut, les utilisateurs ne peuvent bénéficier que d’un seul essai gratuit ou prix de lancement pour tous les abonnements de l’application. Vous pouvez changer ce comportement. Allez dans la
Go to Google Play Console -> All Apps -> Your App -> Monetize -> Products -> Subscriptions -> Manage subscription settings. (Google Play Console -> Toutes les applications -> Votre application -> Monétisation -> Produits -> Abonnements -> Gérer les paramètres d’abonnement)

Acheter un abonnement avec un essai

1. Assurez-vous que l’abonnement avec essai gratuit n’a pas encore été acheté à partir du compte Google de test.

2. Commencez par acheter un abonnement avec un essai gratuit (un abonnement hebdomadaire dans l’exemple). 

3. Assurez-vous que la boîte de dialogue d’achat vous informe que vous ne serez facturé qu’à la fin de la période d’essai :

4. Achetez un abonnement avec la carte de test approuvée.

5. Vérifiez que vous avez été informé par Google par e-mail que l’abonnement comprend une période d’essai gratuite.

6. Assurez-vous que l’application donne accès au contenu premium.

7. Assurez-vous que le montant total de l’abonnement ne vous a été facturé qu’au bout de trois minutes (vous recevrez un e-mail de Google).

8. L’application doit permettre l’accès au contenu premium jusqu’à l’expiration de l’abonnement et l’annulation automatique qui en résulte.

Annuler un essai en cours

1. Répétez les étapes 1 à 4 du cas précédent.

2. Annulez l’abonnement via Google Play sans attendre trois minutes. 

3. L’abonnement restera actif jusqu’à la fin de la période d’essai. Assurez-vous que l’application donne accès au contenu premium jusqu’à la fin de la période d’essai gratuite.

4. Vérifiez que vous n’avez pas été facturé à la fin de la période d’essai gratuite.

Prix d’introduction

Si vous souhaitez offrir aux nouveaux abonnés un prix réduit pendant une durée déterminée, vous pouvez configurer un prix de lancement dans les paramètres de l’abonnement. Dans un environnement de test, la période de prix de lancement dure la même durée que la période de test de l’abonnement. Google permet de personnaliser le prix de l’intro de différentes manières ; choisissez celle qui vous convient et testez-la en fonction du scénario correspondant décrit ci-dessous.

Paiement unique

Les nouveaux abonnés paient un prix de lancement une seule fois pour une période déterminée. À la fin de la période, ils paient le prix fixe habituel de l’abonnement. 

1. Assurez-vous que l’abonnement avec un prix de lancement n’a pas encore été acheté à partir du compte Google de test.

2. Lancez la procédure d’achat d’un abonnement (l’exemple montre un abonnement hebdomadaire).

3. Vérifiez que Google propose d’acheter un abonnement au prix de lancement.

4. Achetez un abonnement avec la carte de test approuvée.

5. Attendez la fin de la période de facturation. L’abonnement devrait être renouvelé au prix normal (vous recevrez un e-mail de Google avec les détails). 

Paiement récurrent 

Les nouveaux abonnés paient un prix de lancement pour un nombre fixe de périodes de facturation. Ils paient ensuite le prix habituel de l’abonnement.

  1. Répétez les étapes 1 à 5 ci-dessus.
  2. Attendez la fin de la période de facturation. Assurez-vous que l’abonnement est renouvelé au prix de lancement (vous recevrez un courriel de Google avec les détails). 
  3. Assurez-vous que la troisième étape a été répétée pour le nombre de périodes de facturation spécifié dans les paramètres du prix de lancement.

Délai de grâce

L’abonnement passe à l’état de compte bloqué lorsque l’utilisateur rencontre des problèmes de paiement et que le délai de grâce n’est pas configuré ou a pris fin sans résolution du paiement. L’utilisateur n’a plus accès à l’abonnement pendant que Google réessaie le mode de paiement. Contrairement au délai de grâce, la suspension de compte ne doit pas être configurée, et sa prise en charge est obligatoire pour tous les développeurs.

Délai de grâce avec règlement du paiement 

  1. Achetez un abonnement mensuel avec la carte de test approuvée.
  2. Ouvrez l’application Google Play. Choisissez
    Choose Account -> Subscriptions & Payments -> Subscriptions.

    (Compte -> Abonnements et paiements -> Abonnements). Cliquez sur votre abonnement d’essai et changez le mode de paiement en « Test card, always declines. » (Carte d’essai, toujours refusée).
  1. Après 5 minutes, le paiement devrait être refusé. L’abonnement entre dans la période de grâce. 
  2. Assurez-vous que, pendant la période de grâce, l’utilisateur a toujours accès à l’abonnement.
  3. Changez le mode de paiement dans Google Play pour une carte de test approuvée. 
  4. Après 5 minutes supplémentaires (durée du délai de grâce dans l’environnement de test), l’abonnement se renouvelle avec succès, se rétablit et sort du délai de grâce.
  5. L’application doit permettre l’accès au contenu premium jusqu’à l’expiration de l’abonnement et l’annulation automatique qui en résulte. 

Délai de grâce sans règlement du paiement 

  1. Veuillez suivre la section sur le délai de grâce et le blocage du compte ci-dessous.

Délai de grâce et compte bloqué

The subscription goes into the Account hold state when the user is experiencing payment issues and grace period isn’t configured or has ended without payment resolution. The user no longer has access to the subscription while Google is retrying the payment method. Unlike the Grace period, Account hold does not need to be configured, and its support is mandatory for all developers.

Avec règlement du paiement 

Note : Avant de commencer, assurez-vous que le délai de grâce est configuré pour l’abonnement. 

  1. Achetez un abonnement mensuel avec la carte de test approuvée.
  2. Modifiez le mode de paiement dans Google Play en indiquant une carte de test refusée. 
  3. Après 5 minutes, le paiement doit être refusé et l’abonnement doit entrer dans la période de grâce. 
  4. Après 5 minutes supplémentaires, le paiement devrait être à nouveau refusé et l’abonnement devrait être mis en attente. L’application devrait cesser de donner accès au contenu de l’abonnement. 
  5. Changez le mode de paiement dans Google Play pour une carte de test approuvée. 
  6. Dans les 10 minutes qui suivent, l’abonnement est renouvelé et le compte sort de mise en attente.  
  7. Assurez-vous que l’application donne accès au contenu premium jusqu’à l’expiration de l’abonnement et l’annulation automatique qui s’ensuit. 

Sans règlement du paiement 

  1. Répétez les étapes 1 à 4 du cas précédent ci-dessus.
  2. Après 10 minutes, l’abonnement doit être annulé. Assurez-vous que l’utilisateur a perdu l’accès à l’abonnement.

Compte bloqué et pas de délai de grâce 

Retenue du compte avec règlement du paiement 

Note : Avant de commencer, assurez-vous que le délai de grâce n’est pas disponible pour l’abonnement. 

  1. Achetez un abonnement mensuel avec la carte de test approuvée.
  2. Modifiez le mode de paiement dans Google Play en indiquant une carte de test refusée. 
  3. Après 5 minutes, le paiement doit être refusé et l’abonnement doit être mis en attente. Assurez-vous que l’utilisateur a perdu l’accès à l’abonnement.
  4. Changez le mode de paiement dans Google Play pour une carte de test approuvée. 
  5. Après 10 minutes (durée de l’état de blocage du compte dans l’environnement de test), l’abonnement devrait se rétablir, se renouveler et sortir du blocage du compte.
  6. Assurez-vous que l’application donne accès au contenu premium jusqu’à l’expiration de l’abonnement et l’annulation automatique qui s’ensuit. 

Compte bloqué sans règlement du paiement 

  1. Répétez les étapes 1 à 3 du cas précédent ci-dessus.
  2. Après 10 minutes, l’abonnement sera annulé. Assurez-vous que l’utilisateur n’a toujours pas accès au contenu premium.

Rétrogradation/amélioration

Vous pouvez donner à vos utilisateurs actifs la possibilité de mettre à niveau et de déclasser leurs abonnements. Dans ces cas, l’abonnement précédent est invalidé, tandis que le nouvel abonnement est mis en place. Voyons comment la valeur ProrationMode affecte vos abonnés lors du passage d’un abonnement de base à un abonnement premium. Les cas de test suivants supposent que le bouton de mise à niveau a déjà été ajouté à votre application.  

Mise à niveau immédiate 

  1. Achetez un abonnement de base.
  2. Assurez-vous que votre application donne accès au contenu de base de votre application.
  3. Cliquez sur le bouton « Upgrade » (mise à niveau) et achetez un abonnement premium avec la valeur appropriée des valeurs ProrationMode suivantes : IMMEDIATE_WITH_TIME_PRORATION, IMMEDIATE_AND_CHARGE_PRORATED_PRICE, IMMEDIATE_WITHOUT_PRORATION, IMMEDIATE_AND_CHARGE_FULL_PRICE.
  4. L’abonnement est mis à jour immédiatement. Assurez-vous que votre application débloque le contenu premium de votre application.

Mise à niveau après renouvellement

  1. Achetez un abonnement de base.
  2. Assurez-vous que votre application donne accès au contenu de base de votre application.
  3. Cliquez sur le bouton Upgrade (mise à niveau) et achetez un abonnement premium avec la valeur DEFERRED ProrationMode.
  4. L’abonnement n’est mis à niveau que lorsqu’il est renouvelé. Votre application doit débloquer le contenu premium uniquement après le renouvellement de l’abonnement.

Remboursements

Tous les scénarios précédents ont été exécutés dans un environnement de test. Pour tester le remboursement, vous devez acheter un abonnement payant dans l’environnement de production. 

  1. Veuillez prendre connaissance des règles de remboursement de Google avant d’effectuer un achat.
  2. Achetez un abonnement.
  3. Demander un remboursement sur Google Play
  4. Attendez que Google traite votre demande (généralement un jour).
  5. Une fois le remboursement effectué, votre application devrait cesser d’accorder l’accès à l’utilisateur.

En conclusion

Dans cet article, nous avons exploré les principaux scénarios de test, mais il en existe quelques autres, tels que les tests de ré-enregistrement ou de codes promotionnels, qui sont traités dans la documentation de Google.

Nous espérons que vous avez testé avec succès vos abonnements et que vous n’avez pas trouvé de bugs. Mais même si vous en avez trouvé, c’est une excellente nouvelle de les repérer avant de publier votre application. L’implémentation des abonnements n’a jamais été facile et nécessite d’énormes ressources pour développer la logique de gestion des accès – les scénarios et les cas d’utilisation sont si nombreux.

Qonversion simplifie considérablement ce processus en vous fournissant des solutions prêtes à l’emploi afin que vous puissiez utiliser les méthodes d’achat, de restauration et de vérification des autorisations et gérer vos abonnements sans aucun problème. Dans tous les cas, que vous utilisiez une solution interne ou Qonversion, faites vos tests – c’est indispensable. Rappelez-vous : Il vaut mieux prévenir que guérir ; la confiance de vos utilisateurs est primordiale.