Vous devez tester votre intégration tout au long du développement. Pour effectuer des tests pendant la phase de développement, nous vous recommandons d'utiliser des testeurs de licence afin de passer en revue les scénarios décrits dans cet article. Pour configurer ces testeurs de licence, consultez la page Tester la facturation des achats in-app avec les licences d'application.
Les testeurs de licence offrent les avantages suivants :
- En règle générale, la bibliothèque Google Play Billing n'est pas accessible aux applications qui ne sont pas signées ni importées dans Google Play. Les testeurs de licence peuvent ignorer cette vérification. Vous pouvez télécharger des applications indépendamment pour les tests, même pour des applications qui utilisent des versions de débogage avec des signatures de débogage, sans avoir à les importer dans la nouvelle version de votre application. Notez que le nom du package doit correspondre à celui de l'application configurée pour Google Play et que le compte Google doit être un testeur de licence pour le compte Google Play Console.
- Les testeurs de licence ont accès à des modes de paiement test qui leur évitent d'avoir à payer réellement les achats. Ces modes de paiement test permettent également de simuler certaines situations (un refus de paiement, par exemple). La figure 1 illustre les modes de paiement test tels qu'ils apparaissent dans le parcours d'achat.
- Les testeurs de licence peuvent tester rapidement les fonctionnalités d'abonnement.
Voici quelques informations supplémentaires sur le processus d'achat en mode test :
- Les achats en mode test suivent le même processus que les achats réels.
- Les taxes ne sont pas calculées pour les achats en mode test.
- Google Play indique les achats en mode test via une notification affichée au centre de la boîte de dialogue d'achat.
Pour confirmer le compte qui effectue un achat, développez la boîte de dialogue d'achat. Notez les points suivants :
- Les comptes de test doivent être installés sur l'appareil Android du testeur.
- Si l'appareil est associé à plusieurs comptes, l'achat est effectué avec le compte qui a téléchargé l'application.
- Si aucun des comptes n'a téléchargé l'application, l'achat est effectué avec le premier compte.
Avant de distribuer votre application, vous pouvez utiliser les canaux de test Google Play afin d'effectuer une validation supplémentaire. Par exemple, vous pouvez utiliser des canaux de test pour que votre équipe de contrôle qualité puisse qualifier une nouvelle version.
Avec les canaux de test, les utilisateurs peuvent installer votre application à partir de Google Play et tester une version de votre application qui n'est pas encore accessible à tous. Les utilisateurs peuvent effectuer des achats réels avec n'importe quel mode de paiement sur Google Play.
Pour tester l'intégration de la bibliothèque Google Play Billing à l'aide de canaux de test, procédez comme suit :
- Publiez votre application dans un canal de test. Notez que quelques heures peuvent s'écouler avant qu'elle ne soit accessible aux testeurs.
- Assurez-vous que chaque testeur active le test de votre application. L'URL d'activation de votre test indique aux testeurs en quoi consiste leur rôle et leur fournit un lien d'activation.
Vous pouvez tester votre intégration sur n'importe quel appareil physique équipé d'Android 1.6 ou version ultérieure. La dernière version de l'application Google Play doit y être installée. Pour obtenir des informations générales sur la configuration d'un appareil destiné au développement d'applications Android, consultez la section Utiliser des appareils physiques.
Tester les produits ponctuels
Tester les produits consommables
Lorsque vous testez des produits consommables, nous vous recommandons de tester différentes situations, y compris les suivantes :
- Achat réussi pour lequel l'utilisateur reçoit un article. Avec un testeur de licence, vous pouvez utiliser le mode de paiement Instrument de test, toujours approuvé.
- Achat pour lequel le mode de paiement n'a pas pu être débité et pour lequel l'utilisateur n'a donc pas reçu l'article. Avec un testeur de licence, vous pouvez utiliser le mode de paiement Instrument de test, toujours refusé.
- Assurez-vous que les articles peuvent être achetés plusieurs fois.
Vous devez également vérifier que les achats sont correctement confirmés, comme décrit dans la section Traiter les achats. Les achats effectués par des testeurs de licence sont remboursés au bout de trois minutes si votre application ne les confirme pas, et vous recevez un e-mail d'annulation. Vous pouvez également consulter l'onglet Commandes dans la Google Play Console pour voir si une commande a été remboursée au bout de trois minutes.
Tester les produits non consommables
Les produits non consommables doivent être testés de la même manière que les produits consommables, mais vous devez vous assurer qu'un article ne peut pas être acheté à nouveau dans votre application. Veillez à vérifier la confirmation d'achat des produits non consommables et des produits consommables (le cas échéant), car la logique de traitement de chacun des deux types d'achats varie.
Tester les achats en attente
Vous devez tester les achats en attente. Dans ce cas, l'article doit être accordé lorsque l'état de l'achat passe à PURCHASED. Les testeurs de licence ont accès à deux instruments de test pour les modes de paiement retardés. Le paiement est effectué ou annulé automatiquement au bout de quelques minutes.
Effectuez un achat avec un mode de paiement retardé "Carte test lente, refus après quelques minutes", comme illustré dans la figure 2. Redémarrez l'application et vérifiez que l'achat n'a pas été accordé.
Figure 2 : Tester un achat avec une carte test lente refusée Effectuez un achat avec un mode de paiement retardé "Carte test lente, approbation après quelques minutes", comme illustré dans la figure 3. Attendez quelques minutes, puis vérifiez que l'achat a été accordé.
Figure 3 : Tester un achat avec une carte test lente approuvée
Pour en savoir plus, consultez Gérer les transactions en attente.
Tester les fonctionnalités spécifiques aux abonnements
Le parcours d'achat des produits ponctuels et des abonnements est similaire. Toutefois, les abonnements présentent des scénarios supplémentaires, comme la validation ou le refus des renouvellements. Pour tester les renouvellements, vous pouvez utiliser les modes de paiement Instrument de test, toujours approuvé et Instrument de test, toujours refusé disponibles pour les testeurs de licence, comme indiqué dans la figure 1. Utilisez ces modes de paiement pour tester des scénarios au-delà du scénario d'abonnement réussi.
Comme avec les produits ponctuels, vous devez également vérifier que les achats sont correctement confirmés, tel que décrit dans la section Traiter les achats. Les achats effectués par des testeurs de licence sont remboursés au bout de trois minutes si votre application ne les confirme pas, et vous recevez un e-mail d'annulation. Vous pouvez également consulter l'onglet "Commandes" dans la Google Play Console pour voir si une commande a été remboursée au bout de trois minutes.
Périodes de renouvellement
Les abonnements de test sont renouvelés plus rapidement que les abonnements réels, et peuvent être renouvelés jusqu'à six fois, sans compter les essais sans frais et les périodes de lancement.
Le tableau suivant répertorie les délais de renouvellement des tests pour des abonnements de différentes durées. Ces délais sont approximatifs. Vous pourrez constater de légères variations de la durée exacte d'un événement. Pour compenser ces variations, appelez l'API afin d'afficher l'état actuel après chaque date d'expiration de l'abonnement.
| Période de l'abonnement en production | Renouvellement de l'abonnement test |
| 1 semaine | 5 minutes |
| 1 mois | 5 minutes |
| 3 mois | 10 minutes |
| 6 mois | 15 minutes |
| 1 an | 30 minutes |
Les fonctionnalités d'abonnement limitées dans le temps, telles que les essais sans frais, sont également raccourcies pour les tests. Le tableau suivant identifie les périodes de test associées à ces fonctionnalités :
| Fonctionnalité | Période de test |
| Confirmation d'achat | 5 minutes |
| Essai sans frais | 3 minutes |
| Période du prix découverte | Identique à la période de test de l'abonnement |
| Délai de grâce (3 et 7 jours) | 5 minutes |
| Blocage de compte | 10 minutes |
| Suspension (1 mois) | 5 minutes |
| Suspension (2 mois) | 10 minutes |
| Suspension (3 mois) | 15 minutes |
Changements de prix
Vous pouvez également faire appel à des testeurs de licence pour tester les changements de prix. Tenez compte des considérations suivantes lorsque vous planifiez des périodes de test :
- En raison de la courte durée de renouvellement pour les testeurs de licence, il est possible que la migration de prix depuis la console ne soit pas enregistrée pour ces derniers. Pour s'assurer que les notifications de changement de prix et les e-mails peuvent être testés, les développeurs doivent différer la facturation d'une heure après avoir déclenché un changement de prix.
- Aucune période de notification n'est associée aux baisses de prix. Peu de temps après la migration de la cohorte, les utilisateurs en sont informés. Ce paramètre reste inchangé lors des tests.
- Pour les augmentations de prix, les délais de notification des tests sont calculés de la même manière que pour les augmentations réelles :
- L'utilisateur est facturé pour la première fois au premier anniversaire de facturation à la suite d'une période de notification obligatoire.
- Les délais de notification sont calculés à rebours à partir de la date du premier prélèvement.
- La notification finale a toujours lieu une minute avant le débit, quelle que soit la période de facturation.
Le tableau suivant présente les périodes de facturation des tests et de notification pour plusieurs périodes de facturation réelles :
| Période de facturation réelle du forfait de base | Période de facturation des tests | Période de notification des tests (dans les régions où les utilisateurs peuvent activer ou désactiver la fonctionnalité avec un préavis de 30 jours) | Période de notification des tests (régions où la désactivation est possible avec un préavis de 60 jours) |
| 1 semaine | 5 minutes | 5 minutes | 10 minutes |
| 1 mois | 5 minutes | 5 minutes | 10 minutes |
| 3 mois | 10 minutes | 3 minutes | 6 minutes |
| 6 mois | 15 minutes | 2 minutes | 4 minutes |
| 1 an | 30 minutes | 3 minutes | 6 minutes |
Scénarios de test
Cliquez sur Afficher/Masquer pour développer la section suivante et afficher les scénarios de test à utiliser pour vérifier l'intégration de votre abonnement.
Tester les codes promotionnels
Vous pouvez utiliser la Google Play Console afin de créer des codes pour vos propres tests. N'oubliez pas que vous ne pouvez créer que 500 codes promotionnels par trimestre pour tous les produits gérés d'une application.
Vous devez tester les scénarios d'utilisation des codes promotionnels suivants :
- Scénario où le code promotionnel est saisi dans la boîte de dialogue d'achat lancée dans votre application
- Scénario où le code promotionnel est utilisé dans l'application Google Play Store
- Scénario où le code promotionnel est utilisé sur la page https://play.google.com/store via le bouton Utiliser dans le menu de navigation de gauche
Dans ces scénarios, testez l'utilisation des codes de toutes les manières possibles. Nous vous recommandons d'effectuer au moins les tests suivants :
- Utilisation d'un code avant l'installation de l'application.
- Utilisation d'un code lorsque l'application est exécutée au premier plan. Notez que dans ce cas, vous avez besoin d'un autre appareil afin de tester l'utilisation de l'application Google Play Store. Assurez-vous de tester l'utilisation des codes promotionnels sur différents écrans de votre application.
- Utilisation d'un code avec le mode multifenêtre pour afficher votre application et l'application Google Play Store en même temps.
Pour chaque test, assurez-vous que l'article est correctement détecté et que l'utilisateur reçoit une notification.
Tester l'expérience d'achat dans différentes régions
Les testeurs de licence vous permettent également de tester le parcours d'achat dans n'importe quelle région sans avoir besoin d'un mode de paiement réel. Procédez comme suit pour effectuer un test :
- Créez un compte Gmail. Le compte peut être créé dans n'importe quel pays.
- Configurez l'utilisateur en tant que testeur de licence.
- Connectez-vous dans le pays souhaité pour le test via un VPN.
- Lancez le parcours d'achat.
Vous pouvez effacer les données et vider le cache du Play Store, puis répéter les étapes 3 et 4 avec le pays que vous souhaitez tester. Après avoir changé de pays, vous devez effacer les données pour que le Google Play Store supprime les données liées au pays précédent.
Cette méthode de test des achats vous permet de tester l'éligibilité de l'offre en fonction de la région et l'expérience utilisateur dans n'importe quelle région, quel que soit le lieu où vous effectuez les tests physiques.