Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 :
Définissez des événements. Pour définir de nouveaux événements à capturer dans votre jeu :
Accédez à la page Events (Événements) de votre jeu dans la Google Play Console.
Cliquez sur le bouton Add new event (Ajouter un événement) et configurez les propriétés de l'événement.
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é.
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 :
Dans la Google Play Console, cliquez sur l'icône Services de jeux à gauche, puis sélectionnez l'entrée correspondant à votre jeu.
Sélectionnez l'onglet Événements à gauche, puis cliquez sur le bouton Ajouter un événement.
Saisissez les détails de l'événement que vous souhaitez créer.
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éé :
Dans la Google Play Console, ouvrez l'onglet Événements, puis 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.
Apportez les modifications souhaitées.
Lorsque vous avez terminé de modifier l'événement, cliquez sur le bouton Save (Enregistrer).
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.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/26 (UTC)."],[],[],null,["# Events\n\nThe Google Play Games events service allows you to collect cumulative\ndata generated by your players during gameplay and store them in Google's\nservers for game analytics. You can flexibly define what player data your game\nshould collect; this might include metrics such as how often:\n\n- Players use a particular item\n- Players reach a certain level\n- Players perform some specific game action\n\nYou can use the events data as feedback on how to improve your game. For\nexample, you can adjust the difficulty level of certain levels in your game\nthat players are finding too hard to complete.\n\nTo learn how to implement events for your platform, see\n[Client implementations](#implement-event).\n\nIntegrate events in your game\n-----------------------------\n\nThe following workflow describes how you can apply events in your\ngame:\n\n1. **Define events** . To define new events to capture in your game:\n 1. Go to the *Events* page for your game in the [Google Play Console](//play.google.com/apps/publish/).\n 2. Click the *Add new event* button and configure the [event properties](#event-basics).\n 3. Publish your event definitions by following the steps described in [Publishing your game changes](/games/pgs/console/publish).\n2. **Implement event capturing in your game using the events APIs** . For\n example, in your Android code, call the events `increment` method whenever\n your game detects that an event that it cares about has been triggered.\n\n | **Note:** On mobile clients, Play Games SDK updates events in batches, so you will see cumulative, rather than fine-grained, changes to your events. When using the REST API, implement your own batching to avoid sending event updates too frequently, as this might cause you to quickly exceed your [rate limits](/games/pgs/quota).\n3. **View events data** . Go to the *Events* page for your game in\n Google Play Console to view statistics for the captured events.\n\nEvent basics\n------------\n\nThe events APIs provide you with a way to define and collect interesting gameplay\nmetrics and upload these metrics to Play Games SDK.\n\nA Play Games SDK event contains these key properties:\n\n| Property | Description |\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **ID** | A unique string generated by Google Play Console for this event. Use this unique ID to refer to the event in your game clients. |\n| **Name** | A short name of the event. The name can be up to 100 characters. This value is used by Google Play Console and can be displayed in your game. Examples: - *\"Zombies Killed\"* - *\"Red Gems Collected\"* |\n| **Description** | A longer description of the event (for example, \"Number of times a player has killed a zombie\" or \"The total number of red gems the player has eliminated and matched\"). The description can be up to 500 characters. This value is used by Google Play Console and can be displayed in your game. |\n| **Event type** | A field that declares the type of data the event is tracking. This value is used by Google Play Console to support Player Analytics reporting. Two event types are supported: Premium currency source : Select this type for events that track sources of a premium currency. For example: - *\"Gold coins earned\"* - *\"Emeralds bought\"* Premium currency sink : Select this type for events that track sinks, or consumption, of a premium currency. For example: - *\"Gold coins spent\"* - *\"Emeralds used\"* \u003cbr /\u003e |\n| **Icon** | A square icon that will be associated with your event. |\n\n### Create an event\n\nTo create a new event for your game, follow these steps:\n\n1. In the [Google Play Console](https://play.google.com/apps/publish/), click the **Game services** icon on the left and select the entry for your game.\n2. Select the **Events** tab on the left, and click the **Add event** button.\n3. Fill in the details for the event you want to create.\n4. Click **Save** . If there are no errors, your event is placed in the \"Ready to publish\" state. You can now proceed to [publish your game changes](/games/pgs/console/publish).\n\n### Edit an event\n\nTo edit an event that you've created:\n\n1. In the [Google Play Console](https://play.google.com/apps/publish/), open the **Events** tab and select the entry for the event you want to edit. You should see the same form you used when creating the event.\n2. Make your edit changes.\n3. When you've finished editing the event, click the **Save** button.\n4. Test your game to verify the modified event. If it is working correctly, [republish your game changes](/games/pgs/console/publish).\n\n### Delete an event\n\nYou can delete events that are in draft state or that have been published. To\ndelete an event in Google Play Console, click the button labeled **Delete**\nat the bottom of the form for that event.\n\n### Reset event data\n\nYou can reset player progress data for testers of your events.\n\n- To reset draft events in Google Play Console, click the button labeled **Reset event progress** at the bottom of the form for that event.\n- To reset event data programmatically, call the [Management API `Events` methods](/games/services/management/api/events).\n\nClient implementations\n----------------------\n\nTo learn how to implement events for your platform, see the following resources:\n\n- [Android](/games/pgs/android/events)\n- [Web](/games/services/web/api/rest#rest-resource:-events)"]]
