> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Visão geral dos eventos
> Como os eventos de jogo do XBOX Live alimentam o serviço User Statistics para atualizar estatísticas, leaderboards e matchmaking em títulos com Dados do jogador baseados em eventos.
**Observação:** este artigo só se aplica se você estiver usando estatísticas de usuário baseadas em eventos, e não estatísticas de usuário gerenciadas pelo título.
**Observação:** o Application Insights foi preterido. Use o [fiddler](https://learn.microsoft.com/windows/uwp/xbox-live/using-xbox-live/troubleshooting/how-to-set-up-fiddler-for-debugging) para monitorar eventos.
## Gravando eventos de jogo no serviço User Statistics dos serviços XBOX
Os momentos mais emocionantes dos jogos são quando algo significativo acontece: derrotar um oponente, ser derrotado, mover-se para um local, disparar uma arma, colher uma flor. Usando os serviços XBOX, os títulos podem compartilhar informações sobre os eventos importantes no jogo de um jogador. Os detalhes podem ser enviados aos serviços XBOX, que registram estatísticas sobre os usuários. Essas estatísticas podem ser recuperadas para uso em estatísticas de usuário, leaderboards e matchmaking.
Quando o evento, e todos os dados enviados como parte dele, chegam ao serviço, os serviços XBOX processam as regras que você definiu na configuração de serviço do seu título para criar ou atualizar estatísticas de usuário, leaderboards etc.
### Configuração no Partner Center
Primeiro, defina seus eventos no Partner Center na página Player Stats | Stat rules. Depois de ter um evento e uma estatística definidos no Partner Center, você pode executar as etapas a seguir para enviar um evento.
### Gravando um evento
Para um título do Microsoft Game Development Kit (GDK), a API para enviar um evento é diferente da usada em um título do XBOX One Software Development Kit, e o uso do arquivo de manifesto não é necessário.
A função [XblEventsWriteInGameEvent](/pt-BR/reference/live/xsapi-c/events_c/functions/xbleventswriteingameevent) é declarada como:
```cpp theme={null}
STDAPI XblEventsWriteInGameEvent(
_In_ XblContextHandle xboxLiveContext,
_In_z_ const char* eventName,
_In_opt_z_ const char* dimensionsJson,
_In_opt_z_ const char* measurementsJson
) XBL_NOEXCEPT;
```
`xboxLiveContext` é o identificador de contexto dos serviços XBOX.
`eventName` é o nome do evento conforme definido no Partner Center.
`dimensions` é um conjunto de propriedades correspondente às propriedades do evento que assumem um conjunto finito de valores. Por exemplo: fase, arma ou personagem.
`measurements` é um conjunto de propriedades correspondente às propriedades do evento que têm um conjunto indeterminado de valores. Por exemplo: quilômetros percorridos, inimigos mortos ou minutos jogados.
Dimensões e medidas são discutidas com mais detalhes a seguir.
#### Medidas e dimensões
Ao chamar [XblEventsWriteInGameEvent](/pt-BR/reference/live/xsapi-c/events_c/functions/xbleventswriteingameevent) para fins de eventos nos serviços XBOX, não há diferença se você passar uma propriedade de evento como dimensão ou medida. Essas diferenças só são relevantes se você estiver analisando os eventos no Application Insights para sua telemetria; isso não tem impacto na experiência de jogo. Há mais informações em [API do Application Insights para eventos e métricas personalizados](https://azure.microsoft.com/documentation/articles/app-insights-api-custom-events-metrics/).
As dimensões podem ser usadas para filtrar ou dinamizar seus eventos. Por exemplo: mostrar os usuários que concluíram a Fase 6 ou mostrar todos os eventos "Enemies Killed" em que a arma usada foi "Minigun".
As medidas podem ser exibidas graficamente ou fazer sentido em um leaderboard. Por exemplo: tempo de pista, rodadas consecutivas vencidas etc.
Mas, para fins de uso com os serviços XBOX, passar uma propriedade de evento como medida ou dimensão não faz diferença; ela será processada de forma idêntica para fins de desbloqueio de conquistas e outras funcionalidades relacionadas aos serviços XBOX.
### Depurando eventos dos serviços XBOX
Se os eventos do seu título não estiverem chegando aos serviços XBOX, as hero stats e os leaderboards não serão atualizados. Se você suspeitar que os eventos não estão sendo recebidos pelos serviços XBOX, tente as seguintes etapas:
* Verifique se sua sandbox está correta.
* Configure o Fiddler no dispositivo. No Fiddler, você deve ver eventos como os seguintes:
Procure chamadas para `v10.vortex-win.data.microsoft.com`. Você precisará decodificar o corpo da solicitação, conforme mostrado; em seguida, se observar o JSON, verá algo como o seguinte:
Você pode verificar se o nome do evento é o esperado. A ID do seu título será prefixada ao nome. Você também deve verificar se está recebendo um código de retorno 200.
## Veja também
[Estatísticas baseadas em eventos vs. gerenciadas pelo título](/pt-BR/services/xbox-services/player-data/stats-leaderboards/live-stats-eb-vs-tm#update-frequency).
## Related topics
- [Eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/events/live-events-nav.md)
- [Primeiros passos com estatísticas baseadas em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-first-glance.md)
- [Visão geral dos leaderboards baseados em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/live-leaderboards-eb-overview.md)
- [Visão geral dos Dados do jogador baseados em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/live-how-data-platform-works.md)
- [Visão geral dos conceitos de multiplayer](/pt-BR/services/xbox-services/multiplayer/concepts/live-multiplayer-concepts.md)