Integra los logros

En este documento, se explica cómo integrar logros en tu juego con Google Play Console o llamadas a la API. Abarca los elementos y estados esenciales de los logros, y describe cómo crearlos, importarlos y administrarlos.

Antes de comenzar

Crea o importa nuevos logros

Para implementar logros desde cero, sigue estos pasos:

Agregar logros

Existen dos maneras de crear logros por primera vez con Google Play Console:

  • Crear un logro: Agrega definiciones y metadatos para cada logro de a uno por vez.
  • Importar logros: Importa definiciones y otros metadatos de múltiples logros en un solo paso.

Crea un logro

Si deseas crear un logro para un juego nuevo y no publicado, completa estos pasos:

  1. En Google Play Console, selecciona un juego.
  2. En la página Servicios de juego de Play - Logros (Crecimiento > Servicios de juego de Play > Configuración y administración > Logros), selecciona Crear logro.
  3. En la página Agregar logros, completa el formulario.
  4. Haz clic en Guardar como borrador.
  5. Después de crear un logro, debes publicarlo.
Importa logros

Para agregar múltiples logros a tu juego a la vez, sigue estos pasos:

  1. Crea un archivo ZIP que contenga tus logros.
  2. Sube el archivo.

Para obtener más información sobre el archivo ZIP, consulta los Lineamientos para archivos ZIP.

Para importar logros, sigue estos pasos:

  1. En Google Play Console, selecciona un juego.
  2. En la página Servicios de juego de Play - Logros (Crecimiento > Servicios de juego de Play > Configuración y administración > Logros), selecciona Importar logros.
  3. En la página Importar logros, haz clic en Subir.
  4. Selecciona el archivo ZIP que quieres subir.
  5. Haz clic en Guardar como borrador.
  6. Después de importar los logros, deberás publicar el juego.

Lineamientos para archivos ZIP

Puedes importar múltiples logros 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 Valores aceptados
AchievementsMetadata.csv Obligatorio Incluye metadatos de cada logro. Consulta Atributos.
AchievementsLocalizations.csv Opcional Proporciona traducciones de los nombres y las descripciones de los logros.
AchievementsIconMappings.csv Opcional Asigna los logros a sus archivos de íconos.
Archivos de íconos Opcional Son íconos en formato PNG, JPEG o JPG.

Requisitos de los archivos ZIP:

  • No debe haber subdirectorios.
  • Deben tener nombres de archivo únicos.
  • Solo se deben incluir archivos CSV, PNG, JPEG o JPG.
  • Los archivos CSV no deben tener una fila de encabezado.
  • Cada archivo debe tener menos de 1 MB.
  • El archivo ZIP no debe contener más de 203 archivos.
  • El tamaño total del archivo ZIP debe ser inferior a 200 MB.
Formato AchievementsMetadata.csv

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

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

Estos campos se describen en la siguiente tabla:

Encabezados de columnas de CSV Obligatorio u opcional Valores aceptados
Nombre Obligatorio De 100 caracteres como máximo
Descripción Opcional De 500 caracteres como máximo
Valor incremental Opcional True o False
Pasos necesarios Obligatorio si Incremental Value es True. Número (sin fracciones ni decimales)
Estado inicial Obligatorio Hidden o Revealed
Puntos Obligatorio Número múltiplo de 5; el valor debe estar entre 5 y 200
Orden en la 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 en blanco.
  • Los campos Name y Description se usan como la configuración regional predeterminada.
  • El campo Name debe ser único en todos los logros.
  • Los siguientes campos no deben contener comas: Name y Description.

Archivo AchievementsMetadata.csv de ejemplo:

  Achievement1,Achievement One,True,100,Hidden,5,20
  Achievement2,Achievement Two,False,,Revealed,10,30
Formato de AchievementsLocalizations.csv

El archivo AchievementsLocalizations.csv es opcional y configura todos los datos necesarios para describir cada logro a los usuarios en diferentes idiomas. Los logros se traducen de acuerdo con los idiomas especificados para el juego.

El archivo debe incluir la información como valores separados por comas en el siguiente orden: 

   Name, Localized name, Localized description, locale

Estos campos se describen en la siguiente tabla:

Encabezados de columnas de CSV Obligatorio u opcional Descripción Valores aceptados
Nombre Obligatorio Debe coincidir con la columna Name de AchievementsMetadata.csv. De 100 caracteres como máximo
Nombre localizado Obligatorio Es el nombre localizado del logro. De 100 caracteres como máximo
Descripción localizada Opcional Es la descripción localizada del logro en el idioma especificado. De 500 caracteres como máximo
Idioma Obligatorio Es el código de configuración regional, como en-US. 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.

Requisitos del archivo AchievementsLocalizations.csv:

  • Los nombres de los logros dentro de un juego deben ser únicos por idioma.

    Por ejemplo, si un juego admite los idiomas en-US y fr-FR, un logro llamado "Logro1" para en-US también puede llamarse "Logro1" para fr-FR.

  • Cada fila debe tener cuatro valores. Si deseas omitir el valor de la descripción localizada, déjalo 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 opcional y se usa para asignar tus logros con el ícono determinado. El archivo debe incluir la información como valores separados por comas en el siguiente orden: 

Name, icon filename

Estos campos se describen en la siguiente tabla:

Encabezados de columnas de CSV Obligatorio u opcional Descripción
Nombre Obligatorio Debe coincidir con la columna Name de AchievementsMetadata.csv.
Nombre del archivo del ícono Obligatorio Es el nombre del archivo del ícono.

Requisitos del archivo AchievementsIconMappings.csv:

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

Un archivo AchievementsIconMappings.csv de muestra:

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

Lineamientos de los íconos

Los íconos deben crearse como archivos PNG, JPEG o JPG de 512 x 512. Solo debes proporcionarnos el ícono del logro desbloqueado. Generaremos una versión en escala de grises automáticamente para el ícono revelado. Por ese motivo, te recomendamos que los íconos de logros incluyan elementos coloridos, de modo que los usuarios puedan distinguir con facilidad los logros revelados y desbloqueados.

Cuando un ícono de logro se muestra en un [aviso][a] de Android, se superpone con un círculo y se ocultan las esquinas exteriores. Asegúrate de que tu ícono se vea bien, incluso en estas circunstancias.

Ejemplo de un ícono de logro
Ejemplo de un ícono de logro.

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.

Archivos de íconos

Los íconos a los que haces referencia en el archivo AchievementsIconMappings.csv deben existir en el archivo ZIP actual que importas.

Actualiza juegos con logros existentes

Puedes agregar más logros a un juego y actualizar los existentes en Google Play Console.

Cómo agregar más logros

Si ya tienes logros existentes y quieres agregar más, sigue estos pasos:

  1. En Google Play Console, selecciona un juego.
  2. En la página Servicios de juego de Play - Logros (Crecimiento > Servicios de juego de Play > Configuración y administración > Logros), selecciona Agregar logros.
Cómo editar logros

Si ya tienes logros existentes y quieres editarlos, sigue estos pasos:

  1. En Google Play Console, selecciona un juego.
  2. En la página Servicios de juego de Play - Logros (Crecimiento > Servicios de juego de Play > Configuración y administración > Logros), selecciona un logro.
  3. Puedes editar cualquiera de los campos.
  4. Haz clic en Guardar como borrador.
  5. En la página Servicios de juego de Play - Logros, el logro editado tiene el estado "Disponible para verificadores".
  6. Después de probar el logro, haz clic en Revisar y publicar.

    De esta manera, se vuelve a publicar el juego, junto con todos los logros actualizados.
Borra un logro

Una vez que se publica el logro, no se puede borrar. Solo puedes borrar un logro en un estado publicado previamente

  1. En la página Servicios de juego de Play - Logros, selecciona un logro.
  2. Para borrar el logro, haz clic en Borrar logro.
Restablece un logro

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

  1. En la página Servicios de juego de Play - Logros, selecciona un logro.
  2. Para restablecer los logros, haz clic en Restablecer progreso.
  3. Para restablecer los datos de logros de manera programática, llama a los métodos Achievements de la API de Management.

Agrega traducciones para los logros

Puedes especificar tus propias traducciones de los logros que se relacionan con el juego. Antes de hacerlo, primero asegúrate de completar los pasos que se describen en Cómo agregar traducciones para tu juego.

Existen dos formas de agregar traducciones para un 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 que ya existen.

  • Puedes agregar traducciones para cada logro del juego. Para agregar tu propia traducción para cada logro, sigue estos pasos:

    1. En Google Play Console, abre la pestaña Logros de tu juego y, luego, selecciona un logro existente.
    2. En la página de detalles de los logros, selecciona la pestaña de un idioma que agregaste anteriormente en la pestaña Detalles del juego.
    3. En la página de detalles del logro correspondiente a ese idioma, edita el formulario con las traducciones pertinentes.
    4. Haz clic en Guardar para almacenar los detalles del logro traducidos.

Implementaciones de cliente

A fin de obtener información para implementar logros en tu plataforma, consulta los siguientes recursos:

Prueba de logros

Para verificar que los logros funcionen según lo previsto, sigue los pasos para probarlos:

  • Configura un segmento de pruebas internas.
  • Agrega cuentas de prueba a tu proyecto de juego para los verificadores.
  • Crea un perfil de Servicios de juego de Play 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 juego de Play.
  • Verifica que el mensaje "Bienvenido" de los Servicios de juego de Play se muestre en la pantalla como confirmación de la autenticación automática exitosa al iniciar el juego.
  • Juega y completa los pasos necesarios para desbloquear los logros.

  • Para verificar los logros, sigue estos pasos:

    • Verifica que se muestre la ventana emergente "Logro desbloqueado" en la pantalla cuando se complete el logro.

    • Abre la app de Play Store y verifica que la sección de logros en YouTab muestre los logros completados y los que están en curso (con detalles del progreso).

Realiza un seguimiento del rendimiento de los logros en Play Console

A continuación, te indicamos cómo encontrar las estadísticas rápidas de los logros individuales.

  • En Google Play Console
  • Ve a Configuración> Proyectos de juegos.
  • Selecciona un juego.
  • En el menú de la izquierda, haz clic en Logros.
  • En la página Logros, puedes encontrar estadísticas para comprender si los jugadores están desbloqueando los logros. En el caso de quienes no ocultan sus logros, puedes ver qué porcentaje los desbloquea. En el caso de los logros de etapas iniciales, el porcentaje de desbloqueo suele ser cercano al 100%.

También puedes hacer un seguimiento del rendimiento de las series temporales de los logros en la página Crecimiento > Servicios de juego de Play > Estadísticas del juego.

Publica los logros

Cuando termines de probar el juego, deberás publicarlo. Todos los logros del juego se publican con él. Publicar logros es un paso obligatorio para que funcionen correctamente.

Para publicar, sigue estos pasos:

  1. En Google Play Console, selecciona un juego.
  2. En la página Servicios de juego de Play - Logros (Crecimiento > Servicios de juego de Play > Configuración y administración > Logros), haz clic en Revisar y publicar.
  3. En la página Servicios de juego de Play - Publicación (Crecimiento > Servicios de juego de Play > Configuración y administración > Publicación), revisa las acciones y corrige los problemas.
  4. Haz clic en Publicar.

    Se publican todos los logros del juego.

Errores comunes que se deben evitar

Estos puntos destacan los errores comunes que se deben evitar al implementar logros en un juego. Enfatizan la importancia de lo siguiente:

  • En Play Console, ve a Crecimiento > Servicios de juego de Play > Configuración y administración > Logros.

    • Antes de publicar, verifica que los logros configurados en Play Console no estén en estado "Borrador".
    • No agregues valores de ID de logros de Play Console al código del juego. En su lugar, usa las implementaciones del cliente.

  • Asegúrate de haber implementado también la lógica de desbloqueo en tu cliente.

    • Los jugadores no pueden omitir el paso de activación en el que se llama a la API de desbloqueo. Por ejemplo, completar el instructivo es un logro, pero los jugadores pueden omitirlo.