En este documento, se explica cómo integrar Estadísticas del juego en tu juego con Google Play Console. Abarca los formatos esenciales de archivos CSV y ZIP, y describe cómo crearlos, importarlos y administrarlos.
Cómo crear eventos
Si deseas crear un evento para un juego nuevo y sin publicar, completa estos pasos:
- Crea el archivo CSV de eventos PlayerGameEvent.csv
- En Google Play Console, selecciona un juego.
- En la página Servicios de Play Games - Estadísticas de juego (Aumenta la cantidad de usuarios > Servicios de Play Games > Configuración y administración > Estadísticas de juego), selecciona Configurar eventos.
- En la página Configuración de eventos, suelta el archivo CSV que deseas subir.
- Después de crear un evento, debes configurar las estadísticas.
Cómo configurar las estadísticas
Después de crear un evento, debes configurar las estadísticas:
- Crea el archivo ZIP que contiene las estadísticas, las localizaciones y los archivos de íconos Lineamientos para el archivo ZIP de estadísticas.
- En Google Play Console, selecciona un juego.
- En la página Servicios de Play Games - Estadísticas de juego (Aumenta la cantidad de usuarios > Servicios de Play Games > Configuración y administración > Estadísticas de juego), selecciona Configurar estadísticas.
- En la página Configuración de estadísticas del juego, suelta el archivo ZIP que deseas subir.
- Después de subir todas las estadísticas, puedes publicar el juego.
Estadísticas de juegos de prueba
Para verificar que las estadísticas de juego funcionen según lo previsto, sigue los pasos para probarlas:
- Configura un segmento de pruebas internas.
- Agrega cuentas de prueba a tu proyecto de juego para los verificadores.
- Crea un perfil de Servicios de Play Games para una de las cuentas de prueba con la app de Play Juegos.
- Abre el juego con la misma cuenta de prueba para la que creaste el perfil de Servicios de Play Games.
- Verifica que el aviso "Bienvenido" de los Servicios de Play Games se muestre en la pantalla como confirmación de la autenticación automática exitosa al iniciar el juego.
- El usuario de la cuenta de prueba puede jugar para activar los eventos. Verifica la respuesta de la API para saber si se registraron los eventos.
Publica las estadísticas del juego
Cuando termines de probar el juego, deberás publicarlo. Todos los eventos y las estadísticas del juego se publican con él.
Para publicar, sigue estos pasos:
- En Google Play Console, selecciona un juego.
- En la página Servicios de Play Games - Estadísticas de juego (Aumenta la cantidad de usuarios > Servicios de Play Games > Configuración y administración > Estadísticas de juego), haz clic en Revisar y publicar.
- En la página Servicios de Play Games - Publicación (Aumenta la cantidad de usuarios > Servicios de Play Games > Configuración y administración > Publicación), revisa las acciones y corrige los problemas.
- Haz clic en Publicar. Se publicarán todas tus estadísticas de videojuegos.
Borrar estadísticas del juego
Una vez que se publican las estadísticas del juego, no se pueden borrar.
Lineamientos para los archivos CSV de eventos
La primera fila del archivo CSV es una fila de encabezado. Debes importar eventos con el archivo CSV de eventos, por ejemplo, PlayerGameEvent.csv.
Formato de PlayerGameEvent.csv
El CSV contiene el evento declarado y sus propiedades como valores separados por comas en el siguiente orden:
Event Name,Property Name,Property Type
Si envías el evento progressUpdate para el progressionStat, agrega una fila para este evento. Este evento debe contener, al menos, una propiedad currentProgress de tipo INT o STRING, además de cualquier otra propiedad que desees enviar.
Estos campos se describen en la siguiente tabla:
| Encabezados de columnas de CSV | Obligatorio u opcional | Accepted values |
|---|---|---|
| Nombre del evento | Obligatorio | Máximo de 50 caracteres Solo debe contener letras, números y guiones bajos. Si se usa el nombre de evento especial |
| Nombre de la propiedad | Obligatorio | Máximo de 50 caracteres Solo debe contener letras, números y guiones bajos. Único por evento: Los nombres de las propiedades deben ser únicos dentro del mismo evento. No uses las siguientes palabras clave reservadas: |
| Tipo de propiedad | Obligatorio | Cadena de enumeración que distingue mayúsculas de minúsculas y coincide con uno de los tipos de datos admitidos: INT64, DOUBLE, STRING, BOOL
|
Requisitos del archivo PlayerGameEvent.csv:
- El archivo admite un máximo de 20 nombres de eventos únicos, con hasta 20 propiedades por evento.
- El contenido del archivo no puede estar vacío y debe tener al menos 1 fila.
Tabla de ejemplos
| Nombre del evento | Nombre de la propiedad | Tipo de propiedad |
|---|---|---|
| matchCompleted | duración | DOUBLE |
| matchCompleted | mata | INT64 |
| matchCompleted | isWinner | BOOL |
| matchCompleted | matchType | STRING |
| itemCollected | coinsAmount | INT64 |
| itemCollected | weaponType | STRING |
| progressUpdate | currentProgress | INT64 |
Lineamientos para archivos ZIP de estadísticas
Puedes importar estadísticas a la vez con un archivo ZIP. Consulta la tabla para conocer los nombres de archivo precisos que debes usar en tu archivo ZIP:
| Nombre del archivo | Obligatorio u opcional | Accepted values |
|---|---|---|
RepetitiveStatsConfig.csv
|
Obligatorio | Una estadística repetitiva representa las acciones en el juego que realizan los jugadores con regularidad. |
ProgressionStatConfig.csv
|
Obligatorio | Una estadística de progresión representa el progreso de un jugador en un juego. |
StatLocalizations.csv
|
Opcional | Proporciona traducciones para los nombres y las descripciones de las estadísticas del juego. |
| Archivos de íconos | Obligatorio | Íconos en formato PNG, JPEG o JPG de 512 x 512 |
El archivo ZIP debe cumplir con los siguientes requisitos:
- Límite de tamaño del archivo ZIP: El tamaño total máximo sin comprimir es de 10 MB.
- Cantidad máxima de archivos: Un máximo de 53 archivos en total (3 CSV y 50 íconos) dentro del archivo ZIP.
- Límite máximo de estadísticas combinadas: Máximo de 50 estadísticas totales en
ProgressionStatConfig.csvyRepetitiveStatsConfig.csv. - Archivos CSV admitidos:
ProgressionStatConfig.csv,RepetitiveStatsConfig.csvyStatLocalizations.csv(opcional). Si solo quieres subir estadísticas de progresión, no incluyas el archivo CSV de estadísticas repetitivas en el archivo ZIP. De lo contrario, la consola emitirá un error. Lo mismo se aplica si solo quieres subir estadísticas repetitivas. - Archivos de imagen de ícono: PNG (.png) o JPEG (.jpg, .jpeg)
- Todos los íconos a los que se hace referencia en los archivos CSV deben existir en la raíz del archivo ZIP.
- Al menos una estadística debe hacer referencia a todos los archivos de imagen presentes en el archivo ZIP.
- Estructura de directorios: Todos los archivos deben residir en la raíz del archivo ZIP. No se permiten subdirectorios.
Formato de RepetitiveStatsConfig.csv
El CSV contiene el evento declarado y sus propiedades como valores separados por comas en el siguiente orden:
Stat Id,Event Name,Event Property Name,Aggregation Type,Stat Display Name,Stat Description,Filter Property,Filter Operator,Filter Value,Is Competitive,Min limit,Max limit,Icon File Name,Good value direction,Unit
Estos campos se describen en la siguiente tabla:
| Encabezados de columnas de CSV | Obligatorio u opcional | Accepted values |
|---|---|---|
| ID de la estadística | Obligatorio | Máximo de 100 caracteres Solo debe contener letras, números y guiones bajos. Debe ser único en todas las estadísticas del juego. |
| Nombre de la propiedad del evento | Obligatorio | Máximo de 50 caracteres |
| Nombre visible de la estadística | Obligatorio | Máximo de 50 caracteres Nombre visible predeterminado para la estadística (configuración regional predeterminada). Debe ser único en todas las estadísticas. |
| Descripción de la estadística | Obligatorio | Máximo de 500 caracteres Es la descripción predeterminada de la estadística. |
| Tipo de agregación | Obligatorio | Máximo de 50 caracteres SUM, MAX, MIN, COUNT. |
| Propiedad de filtro | Opcional | Máximo de 50 caracteres Debe ser un nombre de propiedad definido en PlayerGameEvent.csv. |
| Operador de filtro | Opcional | =, !=, >, <, >=, <=Operadores de comparación de filtros. |
| Valor del filtro | Opcional | Se compara con la propiedad del filtro.
El valor del filtro debe ser INT64, DOUBLE, BOOL, STRING.
|
| Es competitivo | Obligatorio | true, false
|
| Límite mín. | Obligatorio cuando Is Competitive es verdadero | Es la puntuación mínima permitida para las estadísticas de la competencia. |
| Límite máximo | Obligatorio cuando Is Competitive es verdadero | Es la puntuación máxima permitida para las estadísticas de la competencia. |
| Nombre del archivo del ícono | Obligatorio | Nombre de archivo de la imagen del ícono incluida en la raíz del archivo ZIP. No puede entrar en conflicto con los nombres de los archivos de íconos que se usan en las estadísticas repetitivas. |
| Buena dirección de valor | Obligatorio | Especifica si son mejores los valores más altos INCREASING o los valores más bajos DECREASING.
|
| Unidad | Opcional | Unidad de medida para los valores numéricos o de duración sin procesar. Por ejemplo, KILOMETER, SECOND, PERCENTAGE, UNITLESS. |
En caso de que no quieras usar la condición de filtro, deja la celda en blanco.
Tabla de ejemplos
| ID de la estadística | Nombre del evento | Nombre de la propiedad | Agregación | Nombre visible de la estadística | Descripción de la estadística | Propiedad del filtro (opcional) | Operador de filtro (opcional) | Valor del filtro (opcional) | Es competitivo | minLimit | maxLimit | Nombre del archivo del ícono | Número de secuencia | Buena dirección de valor | unidad |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | matchCompleted | duración | MAX | Supervivencia de la coincidencia más larga | Esto denota el tiempo de supervivencia de un jugador en cualquier partida. | isWinner | = | TRUE | TRUE | 0 | 50 | stat1.png | 1 | En disminución | segundos |
| 2 | matchCompleted | isWinner | COUNT | Partidos ganados | Indica la cantidad de partidos que ganó un jugador. | isWinner | = | TRUE | TRUE | 0 | 50 | stat3.png | 2 | En aumento | |
| 3 | matchCompleted | mata | SUM | Asesinatos en partidas 1 contra 1 | Cantidad de eliminaciones realizadas en los enfrentamientos 1 contra 1 | matchType | = | "1-on-1" | FALSO | stat4.png | 4 | En aumento | |||
| 4 | itemCollected | coinsAmount | SUM | Oro total recolectado | El jugador recolecta monedas mientras juega un partido | weaponType | = | "sword" | FALSO | stat2.png | 3 | En aumento |
Formato de ProgressionStatConfig.csv
El CSV contiene el evento declarado y sus propiedades como valores separados por comas en el siguiente orden:
Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit
La estadística de progresión se mostrará como la primera estadística para un jugador en su perfil de gamer.
Estos campos se describen en la siguiente tabla:
| Encabezados de columnas de CSV | Obligatorio u opcional | Accepted values |
|---|---|---|
| ID de la estadística | Obligatorio | Máximo de 100 caracteres Solo debe contener letras, números y guiones bajos. Debe ser único en todas las estadísticas del juego. |
| Nombre del evento | Obligatorio | Máximo de 50 caracteres Debe hacer referencia al nombre del evento definido en el formato PlayerGameEvent.csv. |
| Nombre de la propiedad del evento | Obligatorio | Máximo de 50 caracteres Debe ser un nombre de propiedad definido en PlayerGameEvent.csv. |
| Nombre visible de la estadística | Obligatorio | Debe ser un nombre único. |
| Descripción de la estadística | Obligatorio | Máximo de 50 caracteres Es la descripción predeterminada de la estadística. |
| Nombre del archivo del ícono | Obligatorio | Nombre de archivo de la imagen del ícono incluida en la raíz del archivo ZIP. No puede entrar en conflicto con los nombres de los archivos de íconos que se usan en las estadísticas repetitivas. |
| Buena dirección de valor | Obligatorio | Especifica si son mejores los valores más altos INCREASING o los valores más bajos DECREASING.
|
| Unidad | Opcional | Unidad de medida para los valores numéricos o de duración sin procesar. Por ejemplo, KILOMETER, SECOND, PERCENTAGE, UNITLESS. |
Tabla de ejemplos
| ID de la estadística | Nombre de la propiedad del evento | Nombre visible de la estadística | Descripción de la estadística | Nombre del archivo de ícono | Buena dirección de valor |
|---|---|---|---|---|---|
| 5 | currentProgress | Nivel | Los jugadores acumulan XP jugando partidos y suben de nivel. | Level.png | aumento |
Formato de StatLocalizations.csv
El CSV contiene el evento declarado y sus propiedades como valores separados por comas en el siguiente orden:
Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description
Estos campos se describen en la siguiente tabla:
| Encabezados de columnas de CSV | Obligatorio u opcional | Accepted values |
|---|---|---|
| ID de la estadística | Obligatorio | Máximo de 100 caracteres Solo debe contener letras, números y guiones bajos. Debe ser único en todas las estadísticas del juego. |
| Nombre visible de la estadística | Obligatorio | Debe ser un nombre único. |
| Configuración regional | Obligatorio | Es el código de idioma, como es-419. Agrega traducciones para tu juego antes de especificar una configuración regional. Ten en cuenta que no puedes especificar el idioma predeterminado. Puedes encontrar los códigos de configuración regional admitidos en la lista de idiomas admitidos. |
| Nombre visible de la métrica localizado | Opcional | Máximo 50 caracteres. Es el nombre visible de la métrica traducida para la configuración regional determinada. |
| Localized Stat Description | Opcional | Se admiten hasta 500 caracteres. Es la descripción traducida de la estadística para la configuración regional determinada. |
Tabla de ejemplos
| ID de la estadística | Nombre visible de la estadística | Código de idioma | Nombre de la estadística localizada (UTF-8) | Localized Stat Description (UTF-8) | 1 | Supervivencia de la coincidencia más larga | es | Supervivencia más larga en partidos | Esto denota el tiempo de supervivencia de una jugadora en cualquier partido. | 1 | Supervivencia de la coincidencia más larga | fr | Supervivencia del partido más largo | Indica la duración de supervivencia de un jugador en cualquier partido. | 4 | Oro total recolectado | es | Oro total recolectado | La jugadora recoge monedas mientras juega un partido. | 4 | Oro total recolectado | fr | Or total collecté | Le joueur collecte des pièces en jouant un match |
Archivos de íconos
Los íconos a los que haces referencia en el archivo .csv deben existir en el archivo ZIP actual que importas.
Las reglas de validación de íconos son las siguientes:
| Propiedad de validación | Restricción o regla aplicada |
|---|---|
| Tamaño máximo de los archivos | El tamaño máximo por archivo de ícono es de 1 MB (1,048,576 bytes). |
| Dimensiones | Exactamente 512 × 512 píxeles (ancho = 512, alto = 512) |
| Relación de aspecto | Estrictamente 1:1 (relación de aspecto cuadrada) |
| Formatos permitidos | PNG (.png) y JPEG (.jpg, .jpeg) |
| Posicionamiento en el código postal | Debe estar ubicado en el directorio raíz del archivo ZIP. |
| Verificación de referencia | Todos los nombres de archivo de íconos especificados en las columnas de nombre de archivo de ícono deben existir en el archivo ZIP. |
| Verificación de huérfanos | Al menos una estadística debe hacer referencia a todos los archivos de imagen dentro del archivo ZIP. |
| Verificación de conflictos | Los nombres de los archivos de íconos en ProgressionStatConfig.csv no deben entrar en conflicto con RepetitiveStatsConfig.csv.
|
| Duplicados visuales | Se marcan los íconos duplicados. |
Lineamientos de los íconos
Los íconos deben crearse como archivos PNG, JPEG o JPG de 512 x 512.
Se usa el mismo ícono en todos los parámetros de configuración regional, por lo que te recomendamos que no incluyas texto ni contenido localizado en un ícono.
Especificación de la unidad
Las columnas Unidad controlan cómo se formatean y localizan los valores de estadísticas sin procesar para los jugadores.
Propiedades de estadísticas numéricas (INT64, DOUBLE)
| Valor de unidad permitido | Ejemplo de valor sin procesar |
| (Vacío) / SIN UNIDADES / NINGUNO | 1234567 |
| % / PORCENTAJE / PORCENT | 0.857 |
| Distancia/Longitud: CENTÍMETRO, METRO, KILÓMETRO, PIE, PULGADA, MILLA, YARDA, MILÍMETRO, NANÓMETRO | 15 (KILÓMETRO) |
| Velocidad: KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR | 60 (MILE_PER_HOUR) |
Propiedades de estadísticas no numéricas (STRING, BOOL)
Las columnas de unidades deben dejarse vacías.