Récompenses de test

Play Billing Lab est une application associée qui vous aide à tester les intégrations avec le système de facturation de Google Play. Vous pouvez utiliser les tests d'aperçu des achats hors application (OOAP) de Play Billing Lab pour vérifier que votre backend est correctement configuré pour gérer les éléments acquis en dehors de votre application, y compris les récompenses Play Jeux.

La fonctionnalité en preview OOAP vous permet de sélectionner un produit ou une offre spécifique à afficher sur des surfaces hors de l'application, comme la page d'informations de votre application sur Google Play, et de vérifier le flux d'acquisition et de traitement des droits de bout en bout.

Prérequis

Avant d'utiliser Play Billing Lab pour tester les parcours d'achat hors application afin de valider votre configuration pour les récompenses Play Jeux, assurez-vous de remplir les conditions suivantes :

1. Inscrivez-vous au programme d'accès anticipé aux récompenses Play Jeux.

2. État de testeur agréé : votre compte de test doit être enregistré en tant que testeur agréé pour le jeu. Pour en savoir plus, consultez la documentation sur les testeurs sous licence Google Play.

   Remarque : Bien que n'importe quel utilisateur puisse afficher l'application Play Billing Lab, seuls les testeurs sous licence des développeurs du programme d'accès anticipé figurant sur la liste d'autorisation peuvent configurer et déclencher des remplacements OOAP.

3. Cohérence des comptes sur toutes les surfaces : vous devez vous connecter à Play Billing Lab et au Google Play Store avec le même compte de testeur agréé. En cas d'incohérence de compte, il est possible que le Play Store n'affiche pas le produit ou l'offre de test remplacé, ou qu'il ne finalise pas l'achat test.

Télécharger et installer

Vous pouvez télécharger et installer Play Billing Lab depuis Google Play :

• Google Play Store (Android) : application Play Billing Lab
• Canal de test Web : Inscription à Play Billing Lab sur le Web

Guide par étapes pour l'intégration et les tests du programme d'accès anticipé

Les étapes suivantes expliquent comment intégrer et tester les récompenses Play Jeux à l'aide de Play Billing Lab.

Étape 1 : Lancez Play Billing Lab et connectez-vous

Lorsque vous ouvrez Play Billing Lab pour la première fois après l'installation :

• Appuyez sur Se connecter avec Google.
• Sélectionnez le compte Google enregistré en tant que testeur sous licence pour votre application.
• Une fois connecté, vous accédez au tableau de bord principal.

Étape 2 : Accédez aux tests d'achats hors application

• Dans le tableau de bord, recherchez la fiche Achats hors application.
• Appuyez sur Test pour ouvrir l'écran de configuration de l'OOAP.

Étape 3 : Spécifiez le nom du package d'application et l'ID produit

Sur l'écran de configuration de l'OOAP, saisissez les identifiants d'application requis :

1. Nom du package : nom exact du package Android de votre application (par exemple, com.example.app).
2. Type de produit : sélectionnez Produit ponctuel (élément intégré) ou Abonnement dans le menu déroulant.
3. ID produit (SKU) : ID produit du produit intégré ou de l'abonnement que vous souhaitez tester.

Étape 4 : Sélectionnez une offre éligible

Une fois que vous avez saisi le nom du package, l'ID produit et le type de produit, Play Billing Lab interroge le backend et affiche la liste des offres disponibles pour ce produit.

• Pour les produits ponctuels : sélectionnez l'option d'achat ou l'offre applicable.

  

Étape 5 : Lancez le test OOAP

Après avoir sélectionné l'offre, appuyez sur Démarrer le test. La configuration est enregistrée et synchronisée avec les serveurs backend Google Play.

Après l'activation, votre tableau de bord affiche un badge Actif sur la fiche Achats hors application, indiquant le nom du package configuré, l'ID produit (SKU) et la durée restante.

• Période de test : les configurations de test OOAP actives restent actives pendant deux heures par défaut avant d'expirer automatiquement.

• Remplacement du backend : lorsqu'elle est active, la configuration s'affiche avec la priorité la plus élevée sur les différentes surfaces OOAP (comme la page d'informations de votre application sur le Play Store).

  

Étape 6 : Testez le flux d'acquisition de bout en bout pour les offres hors application

Pendant que le test OOAP est actif dans Play Billing Lab, ouvrez l'application Google Play Store en vous connectant avec le même compte de testeur de licence :

1. Videz le cache du Google Play Store :
   1. Ouvrez l'application Réglages sur votre appareil.
   2. Appuyez sur Applications > Google Play Store.
   3. Appuyez sur Espace de stockage et cache, puis sur Vider le cache et Vider l'espace de stockage.
2. Ouvrez l'application Google Play Store.
3. Accédez à la page d'informations de votre application.

4. Effectuer un achat test (superposition Play Express) : appuyez sur la carte de l'article. La bottom sheet de paiement natif Google Play Express se superpose au Play Store.

   • Vérifiez le prix, le mode de paiement (mode de test pour les testeurs de licence) et les détails de l'offre.
   • Appuyez sur Achat immédiat pour finaliser la transaction.

   

5. Vérifier l'intégration du backend :

   • Une fois l'achat effectué, vérifiez que Google Play envoie une notification en temps réel pour les développeurs (RTDN) à votre serveur backend.
     • Remarque : Rewards envoie également une RTDN.
   • Vérifiez que votre serveur appelle l'API Google Play Developer pour confirmer l'achat et accorder le droit d'accès à l'utilisateur.
   • Consultez l'historique des achats de l'utilisateur dans l'application Play Store pour vérifier que la commande test est enregistrée.

Étape 7 : Arrêtez et effacez le test OOAP

Une fois les tests terminés :

1. Accédez à la page Achats hors application.
2. Appuyez sur Effacer le test pour arrêter le test OOAP et effacer ses paramètres.

Modifier les configurations de test

Vous ne pouvez pas modifier le nom du package, l'ID produit, la sélection d'offres ni le remplacement du pays du Play Store lorsqu'un test d'aperçu d'OOAP est en cours d'exécution.

Pour ce faire, vous devez arrêter et effacer le test d'achat hors application en cours.

Modifier un produit ou une offre

Si vous exécutez actuellement un test OOAP et que vous souhaitez tester un autre produit ou une autre offre :

1. Ouvrez Play Billing Lab et appuyez sur Afficher sur la fiche Achats hors application active.
2. Appuyez sur Modifier pour modifier le nom du package, l'ID produit ou l'offre de test.
3. Confirmez l'opération en cliquant sur Arrêter le test lorsque vous y êtes invité. Le test sera arrêté et toutes les entrées pertinentes seront effacées.
4. Saisissez votre nouveau produit ou sélectionnez la nouvelle offre, puis relancez le test.

Tester la tarification localisée avec des remplacements par pays

Play Billing Lab vous permet de remplacer le pays de votre Google Play Store pour tester la tarification régionale et le formatage des devises. Toutefois, les changements de pays doivent être synchronisés correctement avec les tests OOAP :

1. Arrêter le test d'achat hors application actif : si vous essayez de modifier le forçage de pays alors qu'un test d'achat hors application est actif, depuis le tableau de bord ou la page "Achat hors application", Play Billing Lab affichera un avertissement vous invitant à arrêter d'abord le test. Si vous confirmez en appuyant sur Arrêter le test, le test d'achat hors application en cours sera arrêté et les entrées de test seront effacées.

2. Définir le remplacement de pays : après avoir arrêté le test OOAP, vous pouvez modifier le paramètre de pays sur la page Paramètres de configuration. Sélectionnez le pays cible (par exemple, le Japon ou le Royaume-Uni), puis appuyez sur Appliquer.

3. Redémarrer le test d'achat hors application : une fois le forçage du pays actif, revenez à la fiche Achats hors application, sélectionnez votre produit et votre offre, puis appuyez sur Démarrer le test.

   Votre tableau de bord affiche désormais à la fois un forçage de pays actif et un test OOAP actif.

4. Vérifiez le prix localisé sur le Play Store : ouvrez le Play Store et accédez à la page d'informations de votre application. La fiche d'interface utilisateur affichée et la bottom sheet Play Express affichent désormais le prix du produit dans la devise locale du pays que vous avez défini.

Résolution des problèmes et questions fréquentes