Détecter et distribuer des éléments intégrés à l'application

Cette rubrique explique comment détecter et distribuer des produits intégrés à votre jeu une fois que les joueurs les ont achetés avec des points Play dans l'application Google Play.

Une fois que les utilisateurs ont utilisé leurs points Play pour acheter un produit intégré dans l'application Google Play, les éléments devraient être immédiatement disponibles dans votre jeu. L'exemple suivant montre comment un utilisateur achète des éléments avec des points Play.

1. Cliquez sur Points Play. 1. Cliquez sur l'onglet Utiliser pour afficher les éléments. 2. Sélectionnez un élément, puis cliquez sur Utiliser les points pour finaliser l'achat. 3. Recevez l'élément.
Capture d'écran de À déterminer Capture d'écran de À déterminer Capture d'écran de À déterminer Capture d'écran de À déterminer

Dans cet exemple, le jeu n'est pas exécuté lors de l'achat du produit. Les utilisateurs peuvent également échanger des points Play contre des produits même si le jeu n'est pas installé sur leur appareil. Pour cette raison, vous devez concevoir votre jeu afin qu'il gère la distribution des éléments intégrés même si l'achat est effectué hors du magasin du jeu.

Avant de commencer

Avant de détecter et de distribuer un produit intégré, vous devez créer le produit et les promotions Play Points.

Consignes à respecter pour la distribution

Lorsque vous proposez des produits intégrés à votre jeu dans le cadre d'une promotion Play Points, vous devez respecter les exigences énoncées ci-après.

Délai de distribution

Lorsqu'un joueur échange des points Play contre un produit intégré, utilisez la bibliothèque Google Play Billing pour distribuer l'élément rapidement.

Message de distribution

Lorsqu'un utilisateur retourne dans votre jeu après avoir acheté un produit intégré en dehors du jeu, vous devez afficher une confirmation indiquant que le produit a bien été autorisé dans le jeu. Le message doit s'afficher dans une fenêtre pop-up ou dans le jeu. Les utilisateurs ne devraient pas avoir à effectuer d'autres étapes pour recevoir l'élément.

Voici le format requis pour les messages :

  • Un message clair indiquant que l'élément a bien été reçu.

  • Mentionnez clairement le nom de l'élément et reportez-vous à la section Play Points pour que les utilisateurs puissent le distinguer des autres contenus qu'ils reçoivent.

  • Le nom de l'élément doit également inclure la bonne dénomination de l'élément s'il existe des éléments similaires avec plusieurs dénominations.

  • La fenêtre pop-up, le message ou la notification dans le jeu doivent être visibles par l'utilisateur jusqu'à ce qu'il clique sur une confirmation telle que Continuer ou OK. Il ne devrait pas y avoir de bouton d'annulation, car ce message est uniquement destiné à informer les utilisateurs de la disponibilité de l'élément qu'ils ont reçu dans le jeu. S'il n'y a pas de bouton de confirmation, le message doit être visible par les utilisateurs pendant au moins trois secondes avant de disparaître afin que les utilisateurs sachent qu'ils ont bien reçu l'élément acheté.

Voici un exemple de message :

"Élément reçu ! Vous venez de recevoir 100 gemmes avec des points Play. Continuer."

Les utilisateurs doivent voir une animation ou une confirmation visuelle indiquant l'augmentation de leur solde de monnaie en jeu. S'il s'agit d'un élément intégré durable ou consommable, les utilisateurs doivent être dirigés vers l'endroit où l'élément a été déverrouillé ou vers l'endroit où il est disponible dans le jeu.

Détecter les éléments reçus en dehors du jeu

Si votre jeu utilise le système de facturation de Google Play, consultez Détecter et traiter les achats pour détecter les produits intégrés qui sont reçus en dehors du jeu.

Afficher une confirmation de distribution

Lorsque les utilisateurs utilisent des points Play en échange d'un élément, ils s'attendent à ce qu'un message s'affiche dans le jeu ou à voir une notification qui les informe que l'élément est en cours de traitement. Consultez Informer l'utilisateur pour confirmer l'achat.

Mises à jour pour des moteurs de jeu spécifiques

Voici quelques considérations à prendre en compte pour certains moteurs de jeu :

  • Si votre jeu est conçu avec Unity, nous vous recommandons de vérifier si l'implémentation IAP (achat via une application) que vous utilisez est déjà compatible avec les promotions Play Points.

  • Si votre jeu est conçu avec Cocos2d-x ou Unreal Engine (C/C++), vous devrez probablement écrire le code JNI qui appelle les API Java à partir de votre code C/C++.

Bonnes pratiques côté serveur

Cette section contient les bonnes pratiques côté serveur pour les promotions Play Points :

  • Si vous appelez le code Purchases.products: get sur votre serveur, vérifiez si vous devez gérer les éléments d'échange contre des récompenses Play et les autres produits intégrés séparément, en fonction des valeurs productId.

  • Si vous utilisez le code Inappproducts: list sur votre serveur, vérifiez si vous devez séparer les éléments d'échange contre des récompenses Play des autres produits intégrés en fonction des valeurs productId.

  • Consultez les bonnes pratiques suivantes pour vérifier si vous devez apporter des modifications supplémentaires :

Dépannage

Cette section contient des recommandations sur les scénarios susceptibles d'entraîner des questions de la part des clients.

Plusieurs comptes utilisateur

Si un utilisateur possède plusieurs comptes Google sur son appareil et qu'il utilise des points Play sur le mauvais compte, Google ne peut pas transférer les éléments vers les autres comptes. De même, votre application ne peut pas transférer l'élément en appelant la méthode getPurchases(). Dans ce scénario, vous pouvez envisager de fournir manuellement à l'utilisateur les éléments intégrés à l'application à l'aide de votre service client.

Éléments en retard ou manquants

Si les récompenses arrivent en retard ou sont parfois manquantes, consultez le guide de dépannage pour les achats via une application dans la documentation d'aide de Google Play.