É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 Events 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 Events vous permettent de définir et de collecter des métriques de jeu intéressantes, puis de les importer dans le SDK Play Jeux.

Un événement du SDK Play Jeux contient les propriétés clés suivantes :

Propriété Description
ID Chaîne unique générée par la Google Play Console pour cet événement. Utilisez cet identifiant unique pour faire référence à l'événement dans vos clients de jeu.
Name (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érer les rapports des 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. Si ce n'est déjà fait, ajoutez votre jeu dans la Google Play Console.
  2. Dans la Google Play Console, cliquez sur l'icône des services de jeux, à gauche, puis sélectionnez l'entrée correspondant à 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 Save (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.

Modifier un événement

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

  1. Dans la Google Play Console, ouvrez l'onglet Events (Événements) et sélectionnez l'entrée correspondant à 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.

Supprimer 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 Delete (Supprimer) au bas du formulaire de l'événement en question.

Réinitialiser 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 des brouillons d'événement dans la Google Play Console, cliquez sur le bouton Reset event progress (Réinitialiser la progression de l'événement) au bas du formulaire de l'événement en question.
  • 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 :