Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
El servicio de eventos de Google Play Juegos te permite recopilar datos acumulativos generados por los jugadores durante el juego y almacenarlos en los servidores de Google para las estadísticas del juego. Puedes definir de manera flexible los datos del jugador que el juego debe recopilar. Esto podría incluir métricas como la frecuencia con la que ocurre lo siguiente:
Los jugadores usan un elemento en particular.
Los jugadores alcanzan un nivel determinado.
Los jugadores realizan una acción específica del juego.
Puedes usar los datos de eventos como comentarios para mejorar el juego. Por ejemplo, puedes ajustar la dificultad de algunos niveles del juego que les resulten difíciles de completar a los jugadores.
Implementa la captura de eventos en el juego con las API de eventos. Por ejemplo, en tu código de Android, llama al método increment de eventos cada vez que en el juego se detecte que se activó un evento de interés.
Consulta los datos de eventos. Ve a la página Eventos de tu juego en Google Play Console a fin de ver las estadísticas de los eventos capturados.
Conceptos básicos sobre los eventos
Las API de eventos te proporcionan una manera de definir y recopilar métricas de juego interesantes y subirlas al SDK de Play Juegos.
Un evento del SDK de Play Juegos contiene las siguientes propiedades clave:
Propiedad
Descripción
ID
Una cadena única generada por Google Play Console para este evento.
Usa este ID único para hacer referencia al evento en los clientes de tu juego.
Nombre
Un nombre corto del evento. El nombre puede tener hasta 100 caracteres.
Google Play Console usa este valor, que se puede mostrar en el juego.
Ejemplos:
"Zombis asesinados"
"Gemas rojas obtenidas"
Descripción
Una descripción más larga del evento (por ejemplo, "Cantidad de veces que un jugador mató a un zombi" o "Cantidad total de gemas rojas que el jugador eliminó e hizo coincidir"). La descripción puede tener hasta 500 caracteres.
Google Play Console usa este valor, que se puede mostrar en el juego.
Tipo de evento
Un campo que declara el tipo de datos al que el evento le realiza un seguimiento.
Google Play Console usa este valor para brindar informes del Análisis del jugador.
Se admiten dos tipos de eventos:
Fuente de monedas premium
Selecciona este tipo para eventos que hacen un seguimiento de las fuentes de una moneda premium. Por ejemplo:
"Monedas de oro ganadas"
"Esmeraldas compradas"
Receptor de monedas premium
Selecciona este tipo para eventos que hacen un seguimiento de los receptores, o del consumo, de una moneda premium. Por ejemplo:
"Monedas de oro gastadas"
"Esmeraldas usadas"
Ícono
Un ícono cuadrado que se asociará al evento.
Cómo crear un evento
Si deseas crear un evento nuevo para tu juego, sigue estos pasos:
En Google Play Console, haz clic en el ícono de Servicios de juego ubicado a la izquierda y selecciona la entrada de tu juego.
Selecciona la pestaña Eventos que se encuentra a la izquierda y haz clic en el botón Agregar evento.
Completa los detalles del evento que deseas crear.
Haz clic en Guardar. Si no hay errores, el evento se coloca en el estado "Listo para publicar". Ahora puedes publicar los cambios del juego.
Cómo editar un evento
Si deseas editar un evento que creaste, sigue estos pasos:
En Google Play Console,
abre la pestaña Eventos y selecciona la
entrada del evento que quieres editar. Deberías ver el mismo formulario que usaste cuando creaste el evento.
Realiza los cambios que quieras.
Cuando termines de editar el evento, haz clic en el botón Guardar.
Puedes borrar eventos que estén en estado de borrador o que se hayan publicado. Si deseas borrar un evento en Google Play Console, haz clic en el botón Borrar en la parte inferior del formulario del evento.
Cómo restablecer datos de eventos
Puedes restablecer los datos de progreso del jugador para los verificadores de tus eventos.
Si deseas restablecer eventos en borrador en Google Play Console, haz clic en el botón Reset event progress en la parte inferior del formulario del evento.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-26 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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)"]]
