Eventos

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.

A fin de obtener información para implementar eventos en tu plataforma, consulta Implementaciones de clientes.

Cómo integrar eventos en tu juego

En el siguiente flujo de trabajo, se describe cómo puedes aplicar eventos en tu juego:

  1. Define eventos. Para definir nuevos eventos que se capturarán en el juego, haz lo siguiente:
    1. Ve a la página Eventos de tu juego en Google Play Console.
    2. Haz clic en el botón Agregar evento nuevo y configura las propiedades del evento.
    3. Publica las definiciones de eventos mediante los pasos que se describen en Cómo publicar los cambios en los juegos.
  2. 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.

  3. Consulta los datos de eventos. Ve a la página Eventos de tu juego en la Google Play Console para ver las estadísticas de los eventos capturados.

Conceptos básicos sobre los eventos

Las APIs de eventos te ofrecen una manera de definir y recopilar elementos de juego interesantes y subirlas a los Servicios de juego de Google Play.

Un evento de los Servicios de juego de Google Play 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 compatibilidad con el reproductor Informes de Analytics

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.

Crea un evento

Si deseas crear un evento nuevo para tu juego, sigue estos pasos:

  1. Agrega tu juego a Google Play Console si aún no lo has hecho.
  2. En Google Play Console, haz clic en el ícono de Servicios de juego que se encuentra a la izquierda y selecciona la entrada de tu juego.
  3. Selecciona la pestaña Eventos que se encuentra a la izquierda y haz clic en el botón Agregar evento.
  4. Completa los detalles del evento que deseas crear.
  5. 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:

  1. En Google Play Console, abre la pestaña Eventos y selecciona la entrada para el evento que deseas editar. Deberías ver el mismo formulario que usaste cuando creaste el evento.
  2. Realiza los cambios que quieras.
  3. Cuando termines de editar el evento, haz clic en el botón Guardar.
  4. Prueba tu juego a fin de verificar el evento modificado. Si funciona correctamente, vuelve a publicar los cambios del juego.

Elimina un evento

Puedes borrar eventos que estén en estado de borrador o que se hayan publicado. Para borrar un evento en Google Play Console, haz clic en el botón Borrar en en la parte inferior del formulario de ese evento.

Restableciendo datos de eventos

Puedes restablecer los datos de progreso del jugador para los verificadores de tus eventos.

  • Para restablecer los eventos en borrador en Google Play Console, haz clic en el botón Restablece el progreso del evento en la parte inferior del formulario para ese evento.
  • Para restablecer los datos del evento de manera programática, llama a los métodos Events de la API de Management.

Implementaciones de cliente

Si quieres aprender a implementar eventos para tu plataforma, consulta los siguientes recursos: