Pular para o conteúdo principal
Este tópico descreve como o serviço de conquistas baseadas em eventos usa a telemetria da Data Platform para acompanhar as conquistas dos jogadores.
Se o seu título usa conquistas baseadas em eventos (anteriormente chamadas de Achievements 2013) e você quer oferecer suporte a várias plataformas daqui em diante, deverá continuar usando conquistas baseadas em eventos. Isso é necessário para que os usuários possam manter suas conquistas em todas as plataformas.
Para ajudar desenvolvedores e publicadores a gerenciar seus títulos como serviço, o serviço de conquistas é criado sobre a Data Platform baseada em eventos dos serviços XBOX. A Data Platform baseada em eventos consiste em um único modelo de dados e pipeline orientados a eventos que os desenvolvedores de títulos podem usar para coletar telemetria de uso e criar experiências do usuário com base nesses dados. Uma das principais inovações da Data Platform é uma taxonomia comum de estatísticas de usuário com semântica compartilhada, que os publicadores podem usar para obter insights profundos sobre o comportamento dos seus jogadores. Todas as conquistas são derivadas de estatísticas de usuário, em vez de exigirem chamadas diretas de API do título. Isso foi feito por dois motivos.
  1. Os desenvolvedores podem adicionar conquistas após o lançamento do título sem exigir alterações adicionais no código nem atualizações do título. Se um título estiver bem instrumentado no lançamento, o desenvolvedor poderá adicionar novas conquistas atualizando a configuração de serviço do título na nuvem.
  2. O título pode fazer menos chamadas de serviço para o mesmo comportamento do usuário no título. Por exemplo, o título pode registrar um único evento cujas estatísticas de usuário se aplicam a várias áreas. O evento pode, em última instância, contribuir para uma conquista, um leaderboard e relatórios de business intelligence (BI).

​
Pipeline de dados

As etapas a seguir fornecem uma visão de alto nível dos principais estágios do uso do serviço de conquistas.
  1. Configuração Crie e publique a configuração do título que especifica os dados pertinentes que os serviços XBOX devem processar ou armazenar.
  2. Instrumentação Implemente o registro de eventos no título para que os dados sejam codificados e transmitidos corretamente.
  3. Coleta O título usa a biblioteca de registro do cliente para alimentar a Data Platform com eventos. Seus serviços processam os eventos para agregar, correlacionar, rotear e armazenar estatísticas conforme apropriado, com base na configuração do título.
  4. Processamento de conquistas O serviço processa as alterações recebidas nas estatísticas para detectar quando os objetivos das conquistas são atingidos. Com base na configuração do título, o serviço desbloqueia conquistas, alerta os sistemas de recompensa apropriados e armazena os registros de conquistas.
  5. Notificações O serviço de conquistas comunica a atividade de desbloqueio aos usuários (por meio de notificações do sistema), aos títulos, aos clientes XBOX e a outros serviços XBOX para viabilizar experiências e recursos adicionais.
  6. Análise A plataforma de relatórios online e BI que os publicadores usam para entender como os jogadores estão usando seu título.

​
Principais recursos do serviço de conquistas

Os serviços XBOX expandiram muito o serviço de conquistas, o que dá aos desenvolvedores de títulos mais opções e controle sobre como podem usar conquistas para impulsionar o engajamento dos usuários. O serviço de conquistas baseadas em eventos introduziu os seguintes recursos:
  • Desbloqueios disparados pela nuvem
  • Desafios
  • Uso de deep links em conquistas
  • Progressão de conquistas

​
Desbloqueios disparados pela nuvem

Com as conquistas baseadas em eventos, os títulos não fazem chamadas específicas de conquistas aos serviços XBOX para desbloquear uma conquista. Em vez disso, desenvolvedores e publicadores agora configuram as regras de desbloqueio da conquista online, na configuração de serviço na nuvem. Os serviços XBOX lidam com o processamento dessas regras em tempo real na nuvem. Isso permite que desenvolvedores e publicadores adicionem novas conquistas e desafios após o lançamento de um título sem precisar atualizá-lo.

​
Desafios (conquistas por tempo limitado)

Os desafios não estão mais disponíveis no serviço mais moderno de conquistas gerenciadas pelo título, e o uso de desafios não é mais recomendado. Para obter mais informações, veja Conquistas baseadas em eventos vs. gerenciadas pelo título. Os desafios são conquistas com limite de tempo que os usuários só podem desbloquear durante uma janela de tempo especificada. Eles são configurados exatamente como as conquistas, com um ícone, regras de desbloqueio e a opção de ficarem ocultos, exceto que também exigem a definição de uma janela de tempo elegível. Quando um usuário conclui um desafio, ele é armazenado como uma conquista desbloqueada no histórico de conquistas do usuário. Se um usuário participou de um desafio, mas o desafio não foi desbloqueado durante a janela de tempo elegível, esse registro não é salvo no histórico de conquistas do usuário. Um título pode usar o esquema de conquistas para especificar um deep link que é exibido nos detalhes da conquista. O deep link aponta para o local no jogo onde a conquista pode ser obtida. O link é formatado como uma cadeia de caracteres passada ao jogo durante a ativação de protocolo. O título deve analisar a cadeia de caracteres para determinar para onde ir no jogo. Por exemplo, uma conquista relacionada à conclusão de uma fase do jogo pode incluir nos detalhes da conquista um deep link que passa uma cadeia de caracteres ao jogo. Isso informa ao jogo para ir para essa fase.

​
Progressão de conquistas

O serviço de conquistas do XBOX mede o progresso das conquistas e fornece dados que os títulos podem usar para exibir esse progresso aos jogadores. O serviço de conquistas fornece detalhes de progressão por regra de conquista. Se uma conquista tiver vários requisitos que precisam ser atendidos para desbloqueá-la, a resposta do serviço incluirá detalhes de progressão para cada requisito. Se uma conquista tiver um requisito baseado em várias estatísticas, o serviço retornará um único valor de progressão que combina as estatísticas subjacentes.

​
Objeto de progressão

Consultar uma lista de conquistas do usuário retorna um objeto de progressão. Ele contém os dados detalhados sobre a regra (requisito) da conquista e o estado atual de progressão do usuário para atender a esse requisito. Para obter mais informações, veja a referência de XblAchievementProgression.
Última modificação em 8 de outubro de 2026