Funciones de los Servicios de Juegos de Google Play

Los Servicios de Juegos de Google Play te permiten añadir atractivas funciones sociales y multijugador a tus juegos.

Selecciona una de las funciones que aparecen a continuación para obtener información general y acceder a la documentación sobre la implementación de los Servicios de Juegos de Google Play.

Empezar

Integrar el SDK de los Servicios de Juegos de Google Play

Para consultar cómo integrar el SDK de los Servicios de Juegos de Google Play, visita el sitio de Google Developers, donde encontrarás instrucciones y ejemplos sobre cómo empezar.

Crear la ficha de un juego

Para utilizar los Servicios de Juegos de Google Play, crea una ficha del juego en Play Console. La ficha del juego es independiente de la página Ficha de Play Store de tu aplicación.

Para añadir una nueva ficha del juego, sigue estos pasos:

1. Abre Google Play Console.
2. Ve a Configuración > Proyectos de juegos.
3. Cerca de la parte superior derecha, haz clic en Añadir juego nuevo.

Funciones

Logros

Los logros te ayudan a retener a los jugadores concediéndoles recompensas por alcanzar determinados objetivos en el juego. Los jugadores pueden ganar puntos de experiencia (XP) cuando consiguen logros en el juego.

Visita el sitio de Google Developers para obtener más información sobre los logros.

Nota: Los logros no se pueden eliminar una vez que se han publicado.

Añadir logros

Hay dos formas de crear logros por primera vez con Google Play Console:

• Crear un logro: añade definiciones y metadatos de cada logro uno a uno.
• Importar logros: importa definiciones y otros metadatos de varios logros a la vez en un solo paso.

Nota: Usa APIs para desbloquear logros del jugador que haya iniciado sesión. De esta forma, se mostrarán los logros ocultos al jugador.

Crear un logro

Si quieres crear un logro para un juego nuevo y sin publicar, sigue estos pasos en Google Play Console:

1. En Google Play Console, selecciona un juego.
2. En la página Servicios de Juegos de Google Play - Logros (Crecimiento > Servicios de Juegos de Google Play > Configuración y gestión > Logros), selecciona Crear logro.
3. En la página Añadir logros, rellena el formulario.
4. Haz clic en Guardar como borrador.

Una vez que hayas creado un logro, tendrás que publicar tu juego.

Añadir más logros

Si ya tienes logros y quieres añadir más, sigue estos pasos:

1. En Google Play Console, selecciona un juego.

2. En la página Servicios de Juegos de Google Play - Logros (Crecimiento > Servicios de Juegos de Google Play > Configuración y gestión > Logros), selecciona Añadir logros.

Importar logros

Para añadir varios logros a tu juego a la vez, sigue estos pasos:

1. Crea un archivo ZIP que contenga tus logros.

1. Sube el archivo.

Para obtener más información sobre el archivo ZIP, consulta las directrices de archivos ZIP.

Si quieres importar logros, sigue estos pasos:

1. En Google Play Console, selecciona un juego.
2. En la página Servicios de Juegos de Google Play - Logros (Crecimiento > Servicios de Juegos de Google Play > Configuración y gestión > Logros), selecciona Importar logros.
3. En la página Importar logros, haz clic en Subir.
4. Selecciona el archivo ZIP que quieras subir.
5. Haz clic en Guardar como borrador.
6. Una vez que hayas importado los logros, tendrás que publicar el juego.

Publicar tu juego

Una vez que pruebes y publiques tu juego, todos los logros del juego se publicarán con él.

Editar un logro

Para editar un logro que ya hayas creado, selecciónalo en la pestaña Logros de Google Play Console. En este momento, verás el mismo formulario que usaste para crear el logro por primera vez. Puedes editar cualquiera de los campos según sea necesario.

Cuando hayas terminado de editar un logro, haz clic en el botón Guardar como borrador. El logro que acabas de editar pasará a la fase "Listo para probar" y podrás probarlo. Si funciona correctamente, selecciona Volver a publicar en la lista desplegable. De esta forma, tu juego se volverá a publicar junto con todos tus logros actualizados.

Nota: Una vez que se publica un logro, su estado inicial (oculto o revelado) y su tipo (incremental o estándar) quedan fijados y no se pueden cambiar.

Deshacer un cambio

Si decides que no te gusta el logro actual y quieres volver a su versión anterior, selecciona Deshacer en la lista desplegable de Google Play Console y todos tus logros volverán a la versión publicada anteriormente.

Eliminar un logro

Una vez que se haya publicado tu logro, no se puede eliminar.

Solo puedes eliminar un logro que esté en un estado previo a la publicación haciendo clic en el botón Eliminar situado en la parte inferior del formulario del logro correspondiente.

Restablecer un logro

Solo puedes restablecer los datos de progreso de los jugadores en los logros en borrador.

• Para restablecer los logros en Google Play Console, haz clic en el botón Restablecer progreso del logro situado en la parte inferior del formulario del logro correspondiente.
• Para restablecer los datos de logros de forma programática, llama a los métodos de logros de la API Management.

Directrices para iconos

Los iconos deben crearse como archivos PNG, JPEG o JPG de 512x512 píxeles. Solo tienes que proporcionarnos el icono del logro desbloqueado. Generaremos automáticamente una versión en escala de grises del icono revelado. Por este motivo, te recomendamos que los iconos de los logros incluyan elementos coloridos para que los usuarios puedan distinguir entre los logros revelados y los desbloqueados.

Cuando se muestra el icono de un logro en una notificación del sistema de Android, el icono se superpone con un círculo y sus esquinas exteriores quedan ocultas. Asegúrate de que tu icono se vea bien en esas circunstancias.

Ejemplo de icono de logro.

Se utiliza el mismo icono en todas las configuraciones regionales, por lo que no te recomendamos que incluyas texto ni contenido localizado.

Directrices de archivos ZIP

Puedes importar varios logros a la vez usando un archivo ZIP. Consulta la tabla para ver los nombres de archivo exactos que debes usar en tu archivo ZIP:

Nombre de archivo	Obligatorio u opcional	Valores aceptados
AchievementsMetadata.csv	Obligatorio	Metadatos de cada logro. Consulta Atributos.
AchievementsLocalizations.csv	Opcional	Proporciona traducciones de los nombres y descripciones de los logros.
AchievementsIconMappings.csv	Opcional	Asigna los logros a los archivos de iconos.
Archivos de iconos	Opcional	Iconos en formato PNG, JPEG o JPG.

Requisitos de los archivos ZIP:

• No deben tener subdirectorios.
• Los nombres de archivo deben ser únicos.
• Solo se admiten archivos CSV, PNG, JPEG o JPG.
• El archivo CSV no debe tener ninguna fila de encabezado.
• Cada archivo debe tener un tamaño inferior a 1 MB.
• El número total de archivos debe ser inferior a 203.
• El tamaño total del archivo ZIP debe ser inferior a 200 MB.

Formato de AchievementsMetadata.csv

El archivo AchievementsMetadata.csv contiene los metadatos de cada logro. Debe incluir la información como valores separados por comas en el siguiente orden:

Nombre,Descripción,Valor incremental,Pasos necesarios,Estado inicial,Puntos,Orden de lista

Estos campos se describen en la siguiente tabla:

Encabezados de columnas CSV	Obligatorio u opcional	Valores aceptados
Nombre	Obligatorio	Longitud máxima de 100 caracteres
Descripción	Opcional	Longitud máxima de 500 caracteres
Valor incremental	Opcional	Verdadero o falso
Pasos necesarios	Obligatorio (si el valor incremental es verdadero)	Número (sin fracciones ni decimales)
Estado inicial	Obligatorio	Oculto o visible
Puntos	Obligatorio	Número múltiplo de 5 que esté comprendido entre 5 y 200
Orden de lista	Opcional	Número (sin fracciones ni decimales, y mayor que cero)

Requisitos del archivo AchievementsMetadata.csv:

• Cada fila debe tener siete valores. Si quieres omitir un valor, déjalo vacío.
• Los campos de nombre y descripción se utilizan como configuración regional predeterminada.
• El campo de nombre debe ser único en todos los logros.
• Los campos de nombre y descripción no deben contener comas.

Archivo AchievementsMetadata.csv de ejemplo:

Logro1,,True,100,Hidden,5,20

Logro2,,False,,Revealed,10,30

Formato de AchievementsLocalizations.csv

El archivo AchievementsLocalizations.csv es un archivo opcional que configura todos los datos necesarios para describir cada logro a los usuarios de diferentes configuraciones regionales. Los logros se traducen de acuerdo con las configuraciones regionales especificadas para el juego.

Debe incluir la información como valores separados por comas en el siguiente orden:

Nombre, nombre localizado, descripción localizada, configuración regional

Estos campos se describen en la siguiente tabla:

Encabezados de columnas CSV	Obligatorio u opcional	Descripción	Valores aceptados
Nombre	Obligatorio	Debe coincidir con la columna de nombre del archivo AchievementsMetadata.csv.	Longitud máxima de 100 caracteres
Nombre localizado	Obligatorio	Nombre localizado del logro.	Longitud máxima de 100 caracteres
Descripción localizada	Opcional	Descripción localizada del logro en la configuración regional especificada.	Longitud máxima de 500 caracteres
Configuración regional	Obligatorio	El código de la configuración regional (por ejemplo, "en-US").	Añade traducciones para tu juego antes de especificar una configuración regional. Ten en cuenta que no puedes especificar la configuración regional predeterminada. Los códigos de las configuraciones regionales admitidas se pueden encontrar en la lista de idiomas admitidos.

Requisitos del archivo AchievementsLocalizations.csv:

• Los nombres de logros de un juego deben ser únicos para cada configuración regional. Por ejemplo, si un juego admite las configuraciones regionales en-US y fr-FR, un logro llamado "Achievement1" en en-US también puede llamarse "Achievement1" en fr-FR.
• Cada fila debe tener cuatro valores. Si quieres omitir el valor de la descripción localizada, deja el campo en blanco.

Archivo AchievementsLocalizations.csv de ejemplo:

Achievement1,Achievement One,This is the description of achievement one in English.,en-US

Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR

Achievement2,Achievement Two,Description of achievement two.,en-US

Achievement2,Logro Dos,Descripción del logro dos.,es-ES

Achievement3,Achievement Three,,en-US

Achievement3,Erfolg Drei,,de-DE

Formato de AchievementsIconMappings.csv

El archivo AchievementsIconMappings.csv es un archivo opcional que se utiliza para asignar tus logros al icono correspondiente. Debe incluir la información como valores separados por comas en el siguiente orden:

Nombre, nombre de archivo del icono

Estos campos se describen en la siguiente tabla:

Encabezados de columnas CSV	Obligatorio u opcional	Descripción
Nombre	Obligatorio	Debe coincidir con la columna de nombre del archivo AchievementsMetadata.csv.
Nombre de archivo del icono	Obligatorio	El nombre de archivo del icono.

Requisitos del archivo AchievementsIconMappings.csv:

• Cada fila debe tener dos valores.
• Los archivos de iconos solo pueden estar en formato PNG o JPEG.

Archivo AchievementsIconMappings.csv de ejemplo:

Valid Achievement,valid-achievement-icon.png

Incremental Achievement,incremental-achievement-icon.jpeg

No Description,no-description-icon.png

Hidden Initial State,hidden-initial-state-icon.png

Large Point Value,large-point-value-icon.jpeg

Archivos de iconos

Los iconos a los que hagas referencia en el archivo AchievementsIconMappings.csv deben estar presentes en el archivo ZIP que importes. Consulta más información en las directrices de iconos.

Añadir traducciones de logros

Puedes especificar tus propias traducciones de los logros asociados a tu juego. Antes de hacerlo, asegúrate de completar los pasos que se describen en Añadir traducciones a un juego.

Hay dos formas de añadir traducciones a tu juego:

• Puedes usar la opción Importar logros para subir traducciones de muchos logros nuevos a la vez. No puedes usar esta opción para subir traducciones de logros existentes.
• Puedes añadir traducciones para cada logro de tu juego. Si quieres añadir tu propia traducción de cada logro:
  1. En Google Play Console, abre la pestaña Logros de tu juego y selecciona un logro ya creado.
  2. En la página de detalles de los logros, selecciona la pestaña del idioma que hayas añadido anteriormente en la pestaña Información del juego.
  3. En la página de detalles del logro correspondiente a ese idioma, edita el formulario con tus traducciones.
  4. Haz clic en Guardar para guardar los detalles traducidos del logro.

Marcadores

Los marcadores te permiten ofrecer a los jugadores la posibilidad de comparar su puntuación con la de sus amigos y competir con los mejores jugadores.

Nota: No es posible restablecer la puntuación de los marcadores, pero puedes eliminar u ocultar los marcadores en cualquier momento.

Para ocultar puntuaciones sospechosas en los marcadores, puedes activar la protección contra manipulaciones en la página Marcadores del juego en Play Console.

Crear un marcador

Para crear un marcador de un juego nuevo y sin publicar, sigue estos pasos:

1. En Google Play Console, selecciona un juego.
2. Ve a Crecimiento > Servicios de Juegos de Google Play > Configuración y gestión > Marcadores y haz clic en el botón Crear marcador.
3. Rellena la información necesaria para este marcador.
4. Haz clic en Guardar como borrador, y el marcador estará disponible en el estado "Borrador".
5. Cuando publiques tu juego, también se publicarán todos sus marcadores.

Crear un marcador para un juego publicado

Para crear un marcador adicional de un juego que ya se haya publicado, sigue los pasos que se indican más arriba. Si quieres obtener más información sobre cómo probar una versión actualizada de un juego, consulta Publicar cambios en un juego.

Una vez que hayas probado tu marcador y te guste el resultado, puedes volver a publicar tu juego con los nuevos marcadores.

Editar un marcador

Para editar un marcador que ya hayas creado, haz clic en él en la pestaña Marcadores de Google Play Console. En este momento, verás el mismo formulario que usaste para crear el marcador por primera vez. Podrás editar cualquiera de los campos que necesites.

Cuando hayas terminado de editar un marcador, haz clic en el botón Guardar como borrador. El marcador recién editado tendrá el estado "Borrador", lo que te permitirá probarlo.

Si funciona correctamente, selecciona Publicar cambios en el cuadro situado en la parte superior del formulario del marcador y podrás volver a publicar tu juego, junto con todos tus marcadores, para los usuarios.

Deshacer un cambio

Si decides que no te gusta el marcador que acabas de editar y quieres volver a la versión anterior, solo tienes que seleccionar la opción Deshacer en el cuadro situado en la parte superior del formulario del marcador. El marcador volverá a la versión ya publicada.

Eliminar un marcador

Puedes eliminar marcadores que estén en estado "Borrador" o que se hayan publicado. Para eliminar un marcador en Google Play Console, ve al formulario del marcador y haz clic en Eliminar marcador en la parte superior del formulario.

También puedes llamar a Players.hide para ocultar el marcador de un jugador en la aplicación.

Restablecer un marcador

Solo puedes restablecer los datos de progreso de los jugadores en los marcadores en borrador.

• Para restablecer los marcadores en Google Play Console, haz clic en Borrar progreso en la parte superior del formulario del marcador en cuestión.
• Para restablecer los datos del marcador de forma programática, llama a los métodos de puntuaciones de la API Management.

Añadir traducciones de marcadores

Puedes especificar tus propias traducciones para los marcadores asociados a tu juego. Antes de hacerlo, asegúrate de completar los pasos que se describen en Añadir traducciones a un juego. También debes haber creado uno o varios marcadores para tu juego.

Para añadir tus propias traducciones a los marcadores, abre la pestaña Marcadores de tu juego en Google Play Console y selecciona un marcador ya creado. En la página de detalles del marcador, haz clic en la pestaña del idioma que hayas añadido anteriormente en la pestaña Información del juego. En la página de detalles del marcador correspondiente a ese idioma, edita el formulario con tus traducciones. Haz clic en Guardar para guardar los detalles traducidos del marcador.

Ocultar las puntuaciones de un marcador

Servicios de Juegos de Google Play ofrece una función de protección contra manipulaciones en los marcadores que comprueba puntuaciones que se puedan haber manipulado y las oculta automáticamente. Esta función solo está disponible para juegos Android.

La protección contra manipulaciones está habilitada de forma predeterminada en los nuevos marcadores que crees para tu juego Android, pero está inhabilitada en los marcadores ya creados. Para habilitar la protección contra manipulaciones en los marcadores ya publicados, sigue estos pasos:

1. En Google Play Console, abre la pestaña Servicios de Juegos y selecciona tu juego en la lista.
2. Abre la pestaña Marcadores y, a continuación, selecciona la instancia del marcador en el que quieres habilitar la protección contra manipulaciones.
3. Activa la opción Habilitar protección contra manipulaciones en el marcador.
4. Haz clic en Guardar y continúa.
5. Publica tu juego.

Una vez que se haya habilitado la protección contra manipulaciones en un marcador en Google Play Console, esta función puede tardar hasta 24 horas en aplicarse. Las puntuaciones enviadas antes de habilitar la protección contra manipulaciones no se ocultan de forma retroactiva.

En algunas situaciones, recomendamos inhabilitar la protección contra manipulaciones (por ejemplo, si tu juego también se ejecuta en la Web además de en Android y los marcadores se comparten entre ambas plataformas).

Partidas guardadas

Los juegos guardados te permiten ofrecer a los jugadores la posibilidad de guardar fácilmente su progreso en el juego. El progreso y los metadatos de los jugadores se sincronizan en los distintos dispositivos que utilizan los Servicios de Juegos de Google Play.

Consulta el sitio de Google Developers para ver cómo implementar partidas guardadas.

Habilitar Partidas guardadas

Para habilitar el servicio Partidas guardadas, sigue estos pasos en Play Console:

1. En Google Play Console, selecciona un juego.
2. En la página Servicios de Juegos de Google Play - Configuración (Crecimiento > Servicios de Juegos de Google Play > Configuración y gestión > Configuración), selecciona Editar propiedades.
3. Activa la opción Partidas guardadas.
4. Haz clic en Guardar.

Después de seguir estos pasos, puede que Servicios de Juegos de Google Play tarde hasta 24 horas en activar el servicio Partidas guardadas en tu juego. Si quieres probarlo de inmediato, borra los datos manualmente en la aplicación Servicios de Google Play en tu dispositivo de prueba.

Para borrar los datos almacenados en caché en Android, abre Ajustes > Aplicaciones > Servicios de Google Play, haz clic en Gestionar espacio y, a continuación, en Borrar todos los datos.

Para obtener más información sobre el servicio Partidas guardadas, consulta la Guía de Partidas guardadas en juegos.

Añadir traducciones

Puedes configurar tus propias traducciones para la información del juego, como el nombre visible, la descripción y los recursos gráficos. También puedes especificar tus propias traducciones de los logros y los marcadores asociados a tu juego.

Para añadir tus propias traducciones de la información del juego:

1. En Google Play Console, selecciona un juego.
2. Ve a la página Servicios de Juegos de Google Play - Configuración (Crecimiento > Servicios de Juegos de Google Play > Configuración y gestión > Configuración).
3. Selecciona Editar propiedades.
4. Selecciona Gestionar traducciones > Gestionar mis traducciones.
5. Selecciona los idiomas en los que vas a proporcionar traducciones y haz clic en Aplicar para confirmar tu selección. En la página Propiedades, los idiomas que hayas seleccionado estarán disponibles en el selector de idioma.
6. Selecciona el idioma que quieras editar en el selector de idioma y, a continuación, edita el formulario con tus traducciones para el nombre visible, la descripción y los recursos gráficos.
7. Haz clic en Guardar cambios para guardar la información traducida del juego.

Para obtener más información sobre cómo añadir traducciones de logros y marcadores, consulta las guías sobre logros y marcadores.

Al mostrar las cadenas de información, marcadores y logros del juego, Servicios de Juegos de Google Play usa el idioma admitido por el juego más parecido al idioma solicitado por el usuario. Por ejemplo, si el idioma del dispositivo del usuario es el francés (Canadá) (fr-CA), pero el juego solo admite el inglés (Estados Unidos) (en-US) y el francés (Francia) (fr-FR), Servicios de Juegos de Google Play mostrará las cadenas de fr-FR, ya que es el idioma más parecido.

Conceder permisos de edición a los usuarios

Para editar los ajustes de Servicios de Juegos de Google Play en Play Console, debes asegurarte de que tu equipo tenga los permisos adecuados para gestionar Servicios de Juegos de Google Play. Consulta Añadir usuarios de la cuenta de desarrollador y gestionar permisos para obtener más información sobre los permisos en Play Console.

API Google Play Games Services Publishing

Para automatizar la configuración de las aplicaciones e integrar versiones en herramientas y procesos automatizados, utiliza la API Google Play Games Services Publishing. Aquí se indica cómo activar el acceso a esta API con Play Console.

1. Abre Google Play Console.
2. Ve a Configuración > Acceso a APIs.
3. Si aún no lo has hecho, crea un proyecto vinculado.
4. Junto a la opción de la API de configuración de Play Juegos, haz clic en el botón Sí.

Gestionar varios usuarios

Si en tu cuenta de desarrollador hay varios usuarios que gestionan juegos, tendrás que gestionar los permisos desde la página Usuarios y permisos de Play Console.