Saltar al contenido principal
En este tema se describe cómo el servicio de logros basados en eventos usa la telemetría de Data Platform para realizar el seguimiento de los logros de los jugadores.
Si su título usa logros basados en eventos (anteriormente denominados logros 2013) y quiere admitir varias plataformas en el futuro, debe seguir usando logros basados en eventos. Esto es necesario para que los usuarios puedan conservar sus logros en todas las plataformas.
Para ayudar a los desarrolladores y editores a administrar sus títulos como un servicio, el servicio de logros se basa en la plataforma de datos basada en eventos de los servicios XBOX. La plataforma de datos basada en eventos consta de un único modelo de datos y una canalización controlados por eventos que los desarrolladores de títulos pueden usar para recopilar telemetría de uso y crear experiencias de usuario basadas en estos datos. Una de las innovaciones clave de Data Platform es una taxonomía común de estadísticas de usuario que admite semánticas compartidas que los editores pueden usar para obtener información detallada sobre el comportamiento de sus jugadores. Todos los logros se derivan de las estadísticas de usuario en lugar de requerir llamadas directas a la API desde el título. Esto se hizo por dos motivos.
  1. Los desarrolladores pueden agregar logros después del lanzamiento del título sin necesidad de realizar cambios de código adicionales ni actualizaciones del título. Si un título está bien instrumentado en el lanzamiento, el desarrollador puede agregar nuevos logros actualizando la configuración de servicio del título en la nube.
  2. El título puede realizar menos llamadas al servicio para el mismo comportamiento del usuario dentro del título. Por ejemplo, el título podría registrar un único evento cuyas estadísticas de usuario se apliquen a varias áreas. En última instancia, el evento puede contribuir a un logro, a una tabla de clasificación y a informes de inteligencia empresarial (BI).

​
Canalización de datos

Los pasos siguientes proporcionan una vista de alto nivel de las etapas clave del uso del servicio de logros.
  1. Configuración Diseñe y publique la configuración del título que especifica los datos pertinentes que los servicios XBOX deben procesar o almacenar.
  2. Instrumentación Implemente el registro de eventos dentro del título para que los datos se codifiquen y transmitan correctamente.
  3. Recopilación El título usa la biblioteca de registro de cliente para introducir eventos en Data Platform. Sus servicios procesan los eventos para agregar, correlacionar, enrutar y almacenar las estadísticas según corresponda, en función de la configuración del título.
  4. Procesamiento de logros El servicio procesa los cambios entrantes en las estadísticas para detectar cuándo se cumplen los objetivos de los logros. En función de la configuración del título, el servicio desbloquea los logros, alerta a los sistemas de recompensas adecuados y almacena los registros de logros.
  5. Notificaciones El servicio de logros comunica la actividad de desbloqueo a los usuarios (mediante notificaciones del sistema), los títulos, los clientes de XBOX y otros servicios XBOX para impulsar experiencias y características adicionales.
  6. Análisis La plataforma en línea de informes y BI que los editores usan para comprender cómo los jugadores usan su título.

​
Características clave del servicio de logros

Los servicios XBOX han ampliado considerablemente el servicio de logros, lo que ofrece a los desarrolladores de títulos más opciones y control sobre cómo pueden usar los logros para impulsar la participación de los usuarios. El servicio de logros basados en eventos introdujo las siguientes características:
  • Desbloqueos activados desde la nube
  • Desafíos
  • Uso de vínculos profundos en los logros
  • Progresión de logros

​
Desbloqueos activados desde la nube

Con los logros basados en eventos, los títulos no realizan llamadas específicas de logros a los servicios XBOX para desbloquear un logro. En su lugar, los desarrolladores y editores ahora configuran las reglas de desbloqueo del logro en línea en la configuración de servicio en la nube. Los servicios XBOX se encargan del procesamiento de esas reglas en tiempo real en la nube. Esto permite a los desarrolladores y editores agregar nuevos logros y desafíos después del lanzamiento de un título sin tener que actualizarlo.

​
Desafíos (logros por tiempo limitado)

Los desafíos ya no están disponibles en el servicio de logros administrados por el título, más moderno, y ya no se recomienda usar desafíos. Para obtener más información, consulte Logros basados en eventos frente a logros administrados por el título. Los desafíos son logros con límite de tiempo que los usuarios solo pueden desbloquear durante un período de tiempo especificado. Se configuran igual que los logros, con un icono, reglas de desbloqueo y la opción de estar ocultos, salvo que también requieren que se defina un período de tiempo válido. Cuando un usuario completa un desafío, se almacena como un logro desbloqueado en el historial de logros del usuario. Si un usuario participó en un desafío, pero el desafío no se desbloqueó durante el período de tiempo válido, ese registro no se guarda en el historial de logros del usuario.

​
Uso de vínculos profundos en los logros

Un título puede usar el esquema de logros para especificar un vínculo profundo que se muestra en los detalles del logro. El vínculo profundo lleva al lugar del juego donde se puede obtener el logro. El vínculo tiene el formato de una cadena que se pasa al juego durante la activación de protocolo. El título debe analizar la cadena para determinar a qué parte del juego ir. Por ejemplo, un logro relacionado con completar un nivel del juego puede incluir en los detalles del logro un vínculo profundo que pasa una cadena al juego. Esto indica al juego que vaya a ese nivel.

​
Progresión de logros

El servicio de logros de XBOX mide el progreso de los logros y proporciona datos que los títulos pueden usar para mostrar ese progreso a los jugadores. El servicio de logros proporciona detalles de progresión por regla de logro. Si un logro tiene varios requisitos que deben cumplirse para desbloquearlo, la respuesta del servicio incluye detalles de progresión para cada requisito. Si un logro tiene un requisito que se basa en varias estadísticas, el servicio devuelve un único valor de progresión que combina las estadísticas subyacentes.

​
Objeto de progresión

Al consultar una lista de logros de usuario se devuelve un objeto de progresión. Contiene los datos detallados sobre la regla del logro (requisito) y el estado actual de progresión del usuario hacia el cumplimiento de ese requisito. Para obtener más información, consulte la referencia de XblAchievementProgression.
Última modificación el 5 de octubre de 2026