Logros

Los logros pueden ser una excelente manera de aumentar la participación de los usuarios dentro de tu juego. Puedes implementar logros en tu juego para motivar a los jugadores a experimentar con funciones que por lo general no usarían o a abordar tu juego con estilos completamente diferentes. Los logros también pueden ser una forma divertida para que los jugadores comparen sus progresos entre sí y participen en juegos de poca intensidad.

Si quieres aprender a implementar logros en tu plataforma, consulta Implementaciones de clientes.

Atributos

Para comprender cómo funcionan los logros, te recomendamos que te familiarices con algunos de los atributos asociados a estos.

Estos elementos básicos están asociados a cada logro:

• ID: Es una cadena única que genera Google Play Console. Utilizarás este ID único para hacer referencia al logro en los clientes de tu juego.
• Nombre: Es un nombre corto del logro (por ejemplo, "Pastelero"). El valor puede tener hasta 100 caracteres.
• Descripción: Es una descripción concisa de tu logro. Por lo general, le indica al jugador cómo obtener el logro (por ejemplo, "Prepara un pastel de merengue de limón antes del atardecer"). El valor puede ser de hasta 500 caracteres.
• Ícono: Es un ícono cuadrado que se asocia con tu logro. Si deseas conocer las prácticas recomendadas para la creación de íconos de logros, consulta la sección Lineamientos de los íconos.
• Orden de lista: Es el orden en el que aparecen los logros bloqueados cuando un jugador ve los que se relacionan con el juego. Puede estar en el orden que quieras. Los logros desbloqueados aparecen en la parte superior de la lista en el orden en el que se los alcanzó.

Estado

Los logros pueden estar en uno de los siguientes tres estados:

• Un logro oculto significa que el jugador no podrá ver los detalles de este. Los Servicios de juego de Play proporcionan una descripción y un ícono del marcador de posición genéricos para el logro mientras se encuentra oculto. Te recomendamos que ocultes un logro si contiene un spoiler que no deseas revelar sobre tu juego demasiado pronto (por ejemplo, "Descubre que fuiste un fantasma todo el tiempo").
• Un logro revelado significa que el jugador conoce el logro, pero aún no lo obtuvo. La mayoría de los logros comienzan en el estado revelado.
• Un logro desbloqueado significa que el jugador obtuvo el logro con éxito. Un logro se puede desbloquear sin conexión. Cuando el juego está en línea, se sincroniza con los Servicios de juego de Play para actualizar el estado del logro desbloqueado.

Logros incrementales

Los logros pueden designarse como estándar o incrementales. En general, un logro incremental implica un jugador que avanza de forma gradual para obtener el logro durante un período más largo. A medida que el jugador avanza para obtener el logro incremental, puedes informarle su progreso parcial a los Servicios de juego de Play.

El servicio de Google Play realiza un seguimiento de la información de progreso, le alerta al juego cuando el jugador cumple con los criterios necesarios para desbloquear ese logro y le informa qué tan lejos está de cumplir ese objetivo.

Los logros incrementales son acumulativos en todas las sesiones del juego, y no se puede quitar ni restablecer el progreso dentro de este. Por ejemplo, "Ganar 50 veces" calificaría como un logro incremental. "Ganar 3 veces seguidas" no calificaría, ya que el progreso del jugador se restablecería cuando pierda una vez. "Tener 5,000 fichas de póquer" tampoco calificaría, ya que un jugador podía ganar y perder fichas cuando juega. En los últimos dos logros, depende de ti realizar un seguimiento del estado de "Victorias consecutivas" o del total de fichas del jugador y desbloquear los logros estándar cuando el jugador los obtiene.

Cuando crees un logro incremental, deberás definir la cantidad total de pasos necesarios para desbloquearlo (debe ser un número entre 2 y 10,000). A medida que el usuario avanza para desbloquear el logro, debes informar a los Servicios de juego de Play la cantidad de pasos adicionales que el usuario realizó. Una vez que la cantidad total de pasos alcanza el valor de desbloqueo, el logro se desbloquea (incluso si estaba oculto). No es necesario que guardes el progreso acumulado del usuario.

Puntos

Los logros tienen una puntuación asociada. La puntuación del jugador debe ser un múltiplo de 5, y un juego nunca puede tener un total de más de 1,000 puntos para todos sus logros (aunque puede tener menos). Además, ningún logro puede tener más de 200 puntos.

Haz un seguimiento de los puntos de experiencia (XP)

Además, los jugadores pueden ganar niveles en su perfil de juego cuando obtienen logros en los juegos habilitados para Play Juegos. Por cada punto asociado a un logro, el jugador ganará 100 puntos de experiencia (XP) cuando obtenga ese logro. En otras palabras:

XP for an achievement = 100 * (point value for the achievement)

Los Servicios de juego de Play hacen un seguimiento de los XP que gana cada jugador y envían una notificación a la app de Google Play Juegos cuando el jugador obtuvo suficientes puntos para "subir de nivel". Los jugadores pueden consultar su nivel y el historial de XP en la página de perfil de la app de Google Play Juegos.

Logros mínimos

Un juego que integra logros debe tener al menos cinco antes de publicarse. Puedes probar con menos de cinco logros, pero te recomendamos que tengas al menos cinco creados antes de publicar el juego.

Logros máximos

La cantidad de logros está restringida por los límites y la distribución de puntos. Si la cantidad máxima de puntos se establece en 1,000 y a cada logro se le asigna 5 puntos, la cantidad máxima de logros es 200. Sin embargo, si a los logros se les asignan más puntos, como resultado, la cantidad de logros disponible disminuye.

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 sin publicar, 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 publicar el juego.

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.

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.

Publicar tu juego

Una vez que pruebes y publiques el juego, todos sus logros se publicarán con él.

Edita un logro

Para editar un logro que ya creaste, selecciónalo en la pestaña Logros de Google Play Console. En este punto, verás el mismo formulario que usaste cuando creaste el logro por primera vez y podrás editar cualquiera de los campos según lo necesites.

Cuando termines de editar un logro, haz clic en el botón Guardar como borrador. El logro que acabas de editar estará en la etapa de "listo para probar", y podrás realizar pruebas. Si funciona de forma correcta, selecciona Volver a publicar en la lista desplegable. De esta manera, se vuelve a publicar el juego para el público, junto con todos los logros actualizados.

Deshace una edición

Si decides que no te gusta tu logro actual y deseas cambiarlo a como era antes, selecciona Revertir en la lista desplegable de Google Play Console, y todos tus logros volverán a la versión publicada anteriormente.

Borra un logro

Una vez que se publica el logro, no se puede borrar.

Solo puedes borrar un logro en un estado publicado previamente si haces clic en el botón Borrar en la parte inferior del formulario para ese logro.

Restablece un logro

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

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

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 los íconos de logros se muestran en los avisos de Android, se superponen con un círculo y se ocultan las esquinas exteriores. Asegúrate de que tu ícono se vea bien, incluso en estas circunstancias.

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 él.

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:

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:

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 configuraciones regionales. 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:

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:

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 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 íconos

Los íconos a los que haces referencia en el archivo AchievementsIconMappings.csv deben existir en el archivo ZIP actual que importas. Para obtener más información, consulta Lineamientos de los íconos.

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:

• Android
• Unity
• Web
• Prácticas recomendadas para implementar logros