Événements

Le service Événements de Google Play Jeux vous permet de collecter les données cumulatives générées par vos joueurs pendant le jeu, et de les stocker sur les serveurs de Google afin de les analyser. Vous pouvez définir en toute flexibilité les données relatives aux joueurs que votre jeu doit collecter. Cela peut inclure des métriques telles que la fréquence à laquelle les joueurs :

  • utilisent un élément particulier ;
  • atteignent un certain niveau ;
  • effectuent une action spécifique dans le jeu.

Vous pouvez utiliser les données d'événement pour améliorer votre jeu. Par exemple, vous pouvez ajuster le niveau de difficulté de certains niveaux de votre jeu que les joueurs ne parviennent pas à terminer.

Pour apprendre à implémenter des événements sur votre plate-forme, consultez Implémentations client.

Intégrer des événements dans votre jeu

Le workflow suivant explique comment appliquer des événements dans votre jeu :

  1. Définissez des événements. Pour définir de nouveaux événements à capturer dans votre jeu :
    1. Accédez à la page Events (Événements) de votre jeu dans la Google Play Console.
    2. Cliquez sur le bouton Add new event (Ajouter un événement) et configurez les propriétés de l'événement.
    3. Publiez vos définitions d'événement en suivant la procédure décrite dans Publier les modifications apportées à votre jeu.

  2. Implémentez la capture d'événement dans votre jeu à l'aide des API Events. Par exemple, dans votre code Android, appelez la méthode increment chaque fois que votre jeu détecte qu'un événement qui l'intéresse a été déclenché.

  3. Affichez les données d'événement. Accédez à la page Événements de votre jeu dans la Google Play Console afin d'afficher les statistiques des événements capturés.

Informations de base sur les événements

Les API d'événements vous permettent de définir et de collecter des métriques de jeu intéressantes, et de les importer dans les services de jeux Google Play.

Un événement des services de jeux Google Play contient les propriétés clés suivantes:

Propriété Description
ID Chaîne unique générée par la console Google Play pour cet événement. Utilisez cet ID unique pour faire référence à l'événement dans vos clients de jeu.
Nom Nom court de l'événement. Il peut compter jusqu'à 100 caractères. Cette valeur est utilisée par la Google Play Console et peut être affichée dans votre jeu.

Exemples :

  • "Zombies tués"
  • "Gemmes rouges collectées"
Description Description plus longue de l'événement (par exemple, "Nombre de fois où un joueur a tué un zombie" ou "Nombre total de gemmes rouges que le joueur a fait disparaître et a combinées"). Elle peut compter jusqu'à 500 caractères. Cette valeur est utilisée par la Google Play Console et peut être affichée dans votre jeu.
Event type (Type d'événement)

Champ indiquant le type de données suivi par l'événement. Cette valeur est utilisée par la Google Play Console pour générer des rapports sur les statistiques relatives aux joueurs.

Deux types d'événements sont pris en charge :

Source de devise premium
Sélectionnez ce type pour les événements qui suivent les sources d'une devise premium. Par exemple :
  • "Pièces d'or gagnées"
  • "Émeraudes achetées"
Dépense de devise premium
Sélectionnez ce type pour les événements qui suivent les dépenses (ou l'utilisation) d'une devise premium. Par exemple :
  • "Pièces d'or dépensées"
  • "Émeraudes utilisées"
Icône Icône carrée associée à votre événement.

Créer un événement

Pour créer un événement dans votre jeu, procédez comme suit :

  1. Ajoutez votre jeu dans la Google Play Console, si ce n'est pas déjà fait.
  2. Dans la Google Play Console, cliquez sur l'icône des services de jeux sur la gauche et sélectionnez l'entrée de votre jeu.
  3. Sélectionnez l'onglet Events (Événements) à gauche, puis cliquez sur le bouton Add event (Ajouter un événement).
  4. Saisissez les détails de l'événement que vous souhaitez créer.
  5. Cliquez sur Enregistrer. En l'absence d'erreurs, l'état de votre événement est défini sur "Prêt pour la publication". Vous pouvez maintenant publier les modifications apportées à votre jeu.

Modification d'un événement

Pour modifier un événement que vous avez créé :

  1. Dans la Google Play Console, ouvrez l'onglet Événements et sélectionnez l'entrée de l'événement que vous souhaitez modifier. Le formulaire utilisé pour créer l'événement doit s'afficher.
  2. Apportez les modifications souhaitées.
  3. Lorsque vous avez terminé de modifier l'événement, cliquez sur le bouton Save (Enregistrer).
  4. Testez votre jeu pour vérifier l'événement modifié. S'il fonctionne correctement, publiez à nouveau les modifications apportées à votre jeu.

Suppression d'un événement

Vous pouvez supprimer les événements à l'état de brouillon ou qui ont été publiés. Pour supprimer un événement dans la Google Play Console, cliquez sur le bouton Supprimer en bas du formulaire correspondant.

Réinitialisation des données d'événement...

Vous pouvez réinitialiser les données de progression de joueur pour les testeurs de vos événements.

  • Pour réinitialiser le brouillon des événements dans la Google Play Console, cliquez sur le bouton Réinitialiser la progression de l'événement en bas du formulaire de cet événement.
  • Pour réinitialiser des données d'événement par programmation, appelez les méthodes Events de l'API Management.

Implémentations client

Pour découvrir comment implémenter des événements sur votre plate-forme, consultez les ressources suivantes :