> ## 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.

# Configuração no portal de estatísticas baseadas em eventos

> Adicione, edite, copie e exclua regras de estatística baseadas em eventos do XBOX Live no Partner Center para que os eventos do jogo atualizem as estatísticas dos jogadores e alimentem os leaderboards.

<a id="top" />

<Note>
  Este tópico descreve recursos que estão disponíveis somente com as permissões adequadas. Para obter detalhes, fale com seu gerente de conta ou outro contato na Microsoft.
</Note>

Este tópico descreve os procedimentos para adicionar e alterar regras de estatística na configuração de serviço do Partner Center para um título. As estatísticas de jogador são criadas e atualizadas de acordo com as regras de estatística que são disparadas quando um jogo envia eventos para os serviços XBOX.

Para obter uma introdução à configuração dos serviços XBOX, veja [Visão geral da configuração no portal](/pt-BR/services/xbox-services/fundamentals/portal-config/live-portal-config-overview).

Para obter uma introdução à plataforma de dados 2013, veja [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).

Este tópico aborda o seguinte:

* [O que é uma regra de estatística?](#ID4EMB)
* [Preparar para configurar uma regra de estatística](#ID4ENC)
* [Criar uma regra de estatística](#ID4ELC)
* [Alterar uma regra de estatística existente](#ID4E2C)
* [Editar uma regra de estatística](#ID4ELE)
* [Copiar uma regra de estatística existente](#ID4EMS)
* [Excluir uma regra de estatística existente](#ID4EMF)

<a id="ID4EMB" />

## O que é uma regra de estatística?

As *regras de estatística* são disparadas quando um evento com um nome específico é recebido pelo serviço da plataforma de dados do XBOX. O disparo de uma regra de estatística (pelo envio de um evento apropriado) faz com que o serviço crie ou atualize uma ou mais estatísticas de jogador.

As estatísticas de jogador são definidas pelo desenvolvedor, calculadas pelo serviço da plataforma de dados dos serviços XBOX e armazenadas como pares nome-valor por usuário. Veja alguns exemplos de estatísticas de jogador.

* Número total de zumbis mortos com uma espingarda na dificuldade difícil
* Maior número de inimigos derrotados em uma partida
* Tempo mais rápido para concluir uma corrida
* Nome do carro dirigido mais recentemente

As estatísticas de jogador podem ser exibidas na interface do hub de jogo do jogador como estatísticas em destaque ou hero stats, exibidas em leaderboards e usadas para desbloquear conquistas.

Regras de estatística individuais podem ser configuradas para produzir um dos seguintes resultados:

* Uma única instância de uma estatística de jogador
* Várias instâncias de uma estatística de jogador baseadas em um modelo de estatística

Para obter informações sobre estatísticas e regras de estatística, veja os tópicos a seguir.

* [Visão geral das estatísticas baseadas em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview)
* [Visão geral das regras de estatística baseadas em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stat-rules)
* [Cenários de estatísticas de usuário](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stats-scenarios)

O diagrama a seguir mostra o fluxo de um evento que dispara regras de estatística que atualizam instâncias de estatística.

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/event-stat-rule-instance-template.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=6f4d1a70d3fd9a0695069b7bd042f138" alt="Imagem de um diagrama que mostra o fluxo de um evento que dispara regras de estatística que atualizam instâncias de estatística." width="800" height="450" data-path="images/gdk/services/event-stat-rule-instance-template.png" />

[Voltar ao início deste tópico.](#top)

<a id="ID4ENC" />

## Preparar para configurar uma regra de estatística

**Pré-requisito:** como as regras de estatística são baseadas em eventos, você deve criar um evento antes de poder criar uma regra de estatística. Para obter mais informações, veja [Configuração de eventos no portal](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/events/config/live-events-portal).

1. Entre na sua conta no [Partner Center](https://partner.microsoft.com/dashboard/). A página **Overview** é exibida, mostrando uma lista de produtos.

2. Localize e selecione seu título. A página **Game overview** é exibida, conforme mostrado a seguir.

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-product2013-gameoverview.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=ca66802159931973825dcdda5a0c5415" alt="Captura de tela da página Game overview no Partner Center." width="800" height="448" data-path="images/gdk/services/pctr-product2013-gameoverview.png" />

3. Na navegação à esquerda com fundo cinza, selecione **XBOX Live** para expandi-la e, em seguida, selecione **Gameplay settings**. A página **Gameplay Setting** é exibida, conforme mostrado a seguir.

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-gameplay-setting-page.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=e4039ad49909a9898ad54d538fe56e70" alt="Captura de tela da página Gameplay Setting no Partner Center." width="800" height="479" data-path="images/gdk/services/pctr-gameplay-setting-page.png" />

4. Na parte superior da página, selecione o menu **Player stats** e, em seguida, selecione **Stat rules**, conforme mostrado a seguir.
   Nessa interface do Partner Center, "player stats" significa "estatísticas de usuário baseadas em eventos".

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-stat-rules-menu.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=c34c095faeb6de3c53d98309df1aaa26" alt="Captura de tela do menu Player stats no Partner Center." width="800" height="482" data-path="images/gdk/services/pctr-stat-rules-menu.png" />

   Na página **Gameplay Setting**, a página **Events and stat rules** é exibida, conforme mostrado a seguir.

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-events-and-stat-rules-page.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=7011f4c8333bfef7d5b9ec476aa087ec" alt="Captura de tela da página Events and stat rules no Partner Center." width="800" height="532" data-path="images/gdk/services/pctr-events-and-stat-rules-page.png" />

   Inicialmente, a tabela na parte inferior da página está vazia: "No player stats configured".

5. Na página **Events and stat rules**, configure os eventos e as regras de estatística baseadas nesses eventos. Para obter detalhes, veja as seções a seguir.

[Voltar ao início deste tópico.](#top)

<a id="ID4ELC" />

## Criar uma regra de estatística

**Pré-requisito:** as regras de estatística são baseadas em eventos. Por isso, você deve criar um evento antes de poder criar uma regra de estatística. Para obter mais informações, veja [Configuração de eventos no portal](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/events/config/live-events-portal).

1. Vá para a página **Events and stat rules** conforme descrito na seção anterior.

2. Em uma linha de evento, na coluna **Actions** à direita, selecione o botão de reticências (...) e, em seguida, selecione **New stat rule**, conforme mostrado a seguir.

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/new-stat-rule-menuitem.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=109ee57f08b99f317c6eb2f71a6d336b" alt="Captura de tela da seleção de um evento para criar uma regra de estatística no Partner Center." width="828" height="650" data-path="images/gdk/services/new-stat-rule-menuitem.png" />

   A caixa de diálogo **Add stat rule** é exibida, conforme mostrado a seguir.

   <img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/add-stat-rule-dbox.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=469b04002c0bf6b93cb05e148e490256" alt="Captura de tela da caixa de diálogo Add stat rule no Partner Center." width="699" height="881" data-path="images/gdk/services/add-stat-rule-dbox.png" />

   * **Event fields added to the stat rule**
     * Use este campo opcional para selecionar campos incluídos no evento base como parte da regra de estatística.
     * Na lista suspensa, selecione um campo para adicionar à regra de estatística. Você pode adicionar vários campos dessa forma. Os campos selecionados são acrescentados ao nome raiz da regra de estatística e separados pelo caractere ponto (.).
     * Para remover um campo, selecione o **X** ao lado do nome dele.

   * **Stat rule name**
     Especifique um nome que caracterize a regra de estatística e que você possa lembrar e reconhecer facilmente. Os nomes das regras de estatística são compostos por um nome *raiz*, opcionalmente seguido por um ou mais *campos* separados pelo caractere ponto (.). Para obter mais informações sobre os requisitos de nomenclatura das regras de estatística, veja [Visão geral das regras de estatística baseadas em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stat-rules).

   * **Operator**
     Selecione um dos operadores a seguir.

     * **Sum**
       Incrementa o valor existente da estatística pelo valor especificado no campo **Parameter**.

     * **Min**
       Usa o mínimo entre o valor existente da estatística e o valor do campo **Parameter**.

     * **Max**
       Usa o máximo entre o valor existente da estatística e o valor do campo **Parameter**.

     * **Replace**
       Substitui o valor da estatística pelo valor especificado no campo **Parameter**.

       Essa opção destina-se principalmente a strings, e não recomendamos usar o operador **Replace** para estatísticas que acionam conquistas. Os eventos nem sempre são processados em ordem, e esse operador pode fazer com que uma conquista nunca seja desbloqueada. Em vez disso, use o operador **SUM**.

       Por esse motivo, quando a opção **Replace** é usada, a regra de estatística correspondente é marcada como *Deprecated* na interface do Partner Center.

   * **Parameter**
     Especifique o valor a ser usado no operador selecionado no campo **Operator**.

     * Se você quiser usar um número estático especificado por você, selecione o botão de opção **literal** e especifique o valor na caixa que segue o botão de opção.

     * Se você quiser usar o valor de um campo, selecione o botão de opção **field** e, na lista suspensa que segue o botão de opção, selecione o campo que deseja usar.

   * **Restrict other features like achievements and featured stats from accessing this info.**
     Marque esta caixa de seleção para tornar a regra de estatística privada.

   * **Only allow changes to this stat from a server event. Client events will be ignored.**
     Marque esta caixa de seleção para indicar que a regra de estatística é disparada somente por eventos enviados pela API de servidor para servidor, e não por clientes de jogo executados no console ou no PC.

Sua nova regra de estatística agora é listada na página **Events & Stat Rules** sempre que o evento da regra estiver selecionado.

[Voltar ao início deste tópico.](#top)

<a id="ID4E2C" />

## Alterar uma regra de estatística existente

<Info>
  Depois que um título passa pela Certificação Final, as regras de estatística existentes para um evento nesse título não podem ser alteradas nem excluídas.
</Info>

1. Na coluna **Stat rules** da página **Events and stat rules** da instância do produto, selecione a regra de estatística que você deseja alterar.

2. Faça as alterações na caixa de diálogo **Update stat rule** do evento.

3. Selecione **Save**.

[Voltar ao início deste tópico.](#top)

<a id="ID4ELE" />

## Editar uma regra de estatística

A edição de uma regra de estatística ocorre quando o nome de uma regra de estatística ou um campo de evento é removido, adicionado ou reordenado.
Essa operação será tratada como uma exclusão e a criação de uma nova regra de estatística. Todas as instâncias de estatística serão excluídas como parte da edição, de acordo com essa definição.

[Voltar ao início deste tópico.](#top)

<a id="ID4EMS" />

## Copiar uma regra de estatística existente

<Info>
  Depois que um título passa pela Certificação Final, as regras de estatística existentes para um evento nesse título não podem ser alteradas nem excluídas.
</Info>

1. Na página **Events and stat rules** da instância do produto, localize a linha com a regra de estatística que você deseja copiar.

2. Selecione **Copy** na coluna **Actions** dessa linha.

3. Faça as alterações na caixa de diálogo **Update stat rule** do evento.

4. Selecione **Save**.

[Voltar ao início deste tópico.](#top)

<a id="ID4EMF" />

## Excluir uma regra de estatística existente

<Info>
  * Depois que um título passa pela Certificação Final, as regras de estatística existentes para um evento nesse título não podem ser alteradas nem excluídas.

  * A exclusão de uma regra de estatística é uma ação permanente e não pode ser desfeita nem revertida.

  * Excluir uma regra de estatística exclui todas as dependências encadeadas que ela possa ter. Antes de excluir uma regra de estatística, verifique se você também deseja excluir todas as dependências dela.
</Info>

1. Na página **Events and stat rules** da instância do produto, localize a linha com a regra de estatística que você deseja excluir.

2. Selecione **Delete** na coluna **Actions** dessa linha.

3. Selecione **Delete** na caixa de diálogo **Confirmation**.

O diagrama a seguir mostra que excluir uma regra de estatística de evento exclui todas as dependências dessa regra.

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/event_delete_dependency.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=c62fbfb172b5b3ea07af12d6aca27bf6" alt="Imagem de um diagrama que mostra que excluir uma regra de estatística exclui todas as dependências dessa regra." width="624" height="297" data-path="images/gdk/services/event_delete_dependency.png" />

[Voltar ao início deste tópico.](#top)


## Related topics

- [Configuração](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/config/index.md)
- [Configuração no portal de estatísticas em destaque baseadas em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/featured-stats/config/live-featuredstats-eb-portal.md)
- [Configuração no portal de estatísticas e leaderboards baseados em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-statslb-eb-config-nav.md)
- [Configuração de eventos no portal](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/events/config/live-events-portal.md)
- [Configuração no portal de notificações de alteração de estatística](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stat-change-notif-portal.md)