Vous devez tester votre intégration tout au long du développement. Pour tester pendant la phase de développement, nous vous recommandons d'exploiter testeurs de licence et Play Billing Lab pour examiner les scénarios décrits. dans cette section.
Testeurs de licence
Pour configurer des testeurs de licence, consultez 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.
![Les testeurs de licence ont accès à des modes de paiement test.](https://developer.android.com/static/images/google/play/billing/test-payment-methods.png?authuser=6&hl=fr)
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.
Play Billing Lab
Play Billing Lab est une application Android qui aide les développeurs à tester leurs avec le système de facturation de Google Play. Il fournit une interface pratique pour les développeurs de tester les fonctionnalités de facturation, d'intégrer plus rapidement et lancez-vous avec une plus grande confiance. Vous pouvez télécharger et installer Play Billing Lab depuis le Play Store.
Play Billing Lab vous permet d'effectuer les opérations suivantes pendant vos tests:
- Modifier le pays sur Play depuis Play Billing Lab et appliquez les paramètres à votre test. Cela permet Tester des expériences utilisateur personnalisées dans différents pays/régions quel que soit l'endroit où le testeur effectue le test physique
- Tester les offres d'essai ou les offres découverte à plusieurs reprises avec la même compte
- Testez les changements de prix des abonnements sans affecter les autres abonnés actifs
![Tableau de bord Play Billing Lab](https://developer.android.com/static/images/google/play/billing/play-billing-lab-dashboard.png?authuser=6&hl=fr)
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 3 : 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 4 : 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 instruments 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. les abonnements d'essai peuvent être renouvelés jusqu'à six fois, sans compter les frais les essais et les périodes d'introduction.
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 |
Offres d'essai
Avec la fonctionnalité de test de l'offre d'essai Play Billing Lab, testeur de licence peut tester et utiliser des offres d'essai sans frais ou de découverte plusieurs fois, en cochant la case Tester l'essai sans frais ou l'offre découverte et appliquer la modification. Ainsi, il n'est plus nécessaire de créer plusieurs pour tester une offre d'essai réservée aux nouveaux abonnés.
![offres d'essais d'essai](https://developer.android.com/static/images/google/play/billing/trial-offers-testing.png?authuser=6&hl=fr)
Changements de prix
Vous pouvez aussi utiliser Play Billing Lab et des testeurs de licence pour effectuer des tests changements du prix des abonnements sans affectant les autres abonnés actifs, procédez comme suit:
- Cliquez sur Gérer dans la fiche Paramètres d'abonnement du tableau de bord.
- Choisissez l'abonnement actif que vous souhaitez tester.
- Saisissez le nouveau prix.
- Cochez ou décochez la case User opt-out (Désinscription des utilisateurs), en fonction des exigences de votre test.
- Cliquez sur Appliquer.
![changement de prix de l'abonnement test](https://developer.android.com/static/images/google/play/billing/play-billing-lab-price-change.png?authuser=6&hl=fr)
Une fois vos modifications appliquées, le prix sera mis à jour à partir du renouvellement uniquement pour le testeur. Les autres abonnés actifs ne seront pas affectés. Toutes les règles applicables aux testeurs de licence s'appliqueront à l'abonnement test. Le testeur peut : puis tester son application pour détecter les processus en aval déclenchés par le changement de prix, tels que notifications de changement 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 qu'un La migration de prix effectuée depuis la console ne sera pas enregistrée pour les testeurs de licence. À s'assurer que les notifications de changement de prix et les e-mails peuvent être testés, les développeurs doit différer la facturation d'au moins une heure après avoir déclenché un changement de prix.
- Aucune période de notification n'est associée aux baisses de prix. Les utilisateurs sont informés des une baisse de prix peu de temps après la migration de la cohorte. 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 transactions en attente
Vous devez tester que les transactions en attente sont gérées correctement et que les droits d'accès
sont mis à jour en conséquence lorsque l'état de l'achat passe à PURCHASED
. Testeurs de licence
vous avez accès à deux instruments de test pour les modes de paiement retardés lorsque le
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
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
Vous pouvez tester l'expérience d'achat avec ou sans Play Billing Lab:
Tester avec
L'application Android Play Billing Lab vous permet de tester le dans n'importe quelle région. Toutefois, Pour utiliser Play Billing Lab, vous devez être testeur de licence. Utilisez le procédez comme suit:
- Enregistrez l'utilisateur de la facturation de l'application en tant que testeur de licence.
- Connectez-vous à l'application Play Billing Lab avec le même utilisateur.
- Sélectionnez le pays souhaité et appliquez la modification dans Play Billing Lab.
- Lancez le parcours d'achat dans l'application en cours de test.
![Tester l'expérience d'achat dans différentes régions](https://developer.android.com/static/images/google/play/billing/play-billing-lab-country.png?authuser=6&hl=fr)
Tester sans
Vous pouvez également tester le parcours d'achat dans n'importe quelle région sans utiliser le Play Billing Lab. Procédez comme suit pour effectuer un test :
- Créez un compte Gmail. Le compte peut être créé dans n'importe quel pays.
- Vous pouvez éventuellement lui attribuer le rôle de 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 les pays que vous souhaitez tester. Après avoir changé de pays, vous devez : Effacer les données pour le Google Play Store afin de supprimer les données liées pays.
Ces deux méthodes de test des achats vous permettent de tester l'éligibilité des offres régionales et l'expérience utilisateur dans n'importe quelle région, quel que soit le lieu où vous effectuez les tests physiques.