> ## 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 de eventos no portal

> Crie, edite, copie e exclua definições de eventos do XBOX Live no Partner Center para que seu título possa enviar telemetria que atualiza estatísticas e conquistas.

<a id="top" />

<Note>
  Este tópico 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.
</Note>

<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 eventos na configuração de serviço do Partner Center para um título. Se um título usa estatísticas baseadas em eventos, os eventos são os principais dados enviados pelo título aos serviços XBOX para atualizar estatísticas e leaderboards e desbloquear conquistas.

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

Este tópico aborda o seguinte:

* [O que é um evento?](#ID4EKB)
* [Configurar um evento](#ID4EYM)
* [Criar um evento](#ID4EUB)
* [Alterar um evento](#ID4EYE)
* [Copiar um evento](#ID4EBG)
* [Excluir um evento](#ID4EBL)

<a id="ID4EKB" />

## O que é um evento?

Um *evento* é qualquer coisa que acontece durante o jogo e pode ser *capturada*. Um jogador adquirindo uma arma é um evento, assim como derrotar um inimigo usando essa arma.

Um evento consiste no nome do evento, uma descrição do evento e vários campos que contêm dados relacionados ao evento. Quando um título grava um evento, ele é armazenado no dispositivo local até que possa ser enviado aos serviços XBOX. O serviço recebe o evento e o usa para criar e atualizar estatísticas, leaderboards, conquistas e outros recursos das estatísticas baseadas em eventos, de acordo com as regras que você define na configuração de serviço.

Para obter mais detalhes sobre eventos, veja [Visão geral dos eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/events/live-game-events).

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

<a id="ID4EYM" />

## Configurar um evento

1. Entre na sua conta no [Partner Center](https://developer.microsoft.com/dashboard/windows/overview).

2. Selecione seu título e, em seguida, selecione **XBOX services** > **Gameplay settings** no painel de navegação à esquerda.

3. Selecione o link **Player stats** > **Stat rules**.

4. Na página **Events and stat rules**, mostrada a seguir, configure os eventos e as regras de estatística de acordo com os eventos.

   <img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/events-and-stat-rules-1.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=53345d0eb82e9e60332ffa25b1a14054" alt="Captura de tela da página Events and stat rules no Partner Center." width="959" height="654" data-path="images/gdk/services/events-and-stat-rules-1.png" />

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

<a id="ID4EUB" />

## Criar um evento

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

2. Selecione **New event**. A caixa de diálogo **Add new event** é exibida, conforme mostrado a seguir.

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-add-new-event-dbox.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=25f2ab8246896159d606bf501295cdff" alt="Captura de tela da caixa de diálogo Add new event no Partner Center." width="800" height="532" data-path="images/gdk/services/pctr-add-new-event-dbox.png" />

3. Especifique os valores dos campos a seguir.

   * **Base event**: na lista suspensa, mostrada a seguir, selecione o evento base sobre o qual você deseja criar seu novo evento. O evento base selecionado controla os campos padrão com os quais seu novo evento é pré-preenchido. Você pode adicionar outros campos, mas não pode remover os campos padrão.

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-base-event-list.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=bb49035ec3df875ea0727bef1393f243" alt="Captura de tela da lista Base event no Partner Center." width="800" height="534" data-path="images/gdk/services/pctr-base-event-list.png" />

   * **Event name**: insira um nome que caracterize o evento e que você possa lembrar e reconhecer facilmente. O nome do evento não precisa corresponder ao nome do evento base selecionado para o novo evento. Os nomes de eventos não são exibidos ao jogador e são internos ao código e ao estúdio de jogos. Os nomes de eventos devem ser exclusivos dentro de um namespace de provedor: os estúdios de jogos não podem ter nomes de eventos duplicados.

   * **Description**: insira uma breve descrição do evento. Esse texto é opcional e fica oculto para o jogador. A captura de tela a seguir mostra a caixa de diálogo **Add new event** com informações adicionadas aos seus campos.

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-add-new-event-dbox-filled-in.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=b9f6f2325b76a22de9c7ca8d6da63f4b" alt="Captura de tela da caixa de diálogo Add new event com informações adicionadas aos seus campos no Partner Center." width="800" height="535" data-path="images/gdk/services/pctr-add-new-event-dbox-filled-in.png" />

   * **Event fields**:
     * Os campos desta lista, mostrados a seguir, representam os dados que serão capturados em conexão com o novo evento.
     * Para adicionar um campo de evento, selecione **Add event field** e, em seguida, especifique o nome em **Field** e o **DataType**.
     * Os tipos de campo têm limites de caracteres. São os seguintes.

       * Nome da conquista: 44
       * Nome da regra da conquista: 44
       * Descrição bloqueada: 100
       * Descrição desbloqueada: 100
       * Nome da recompensa no aplicativo: 57
       * Descrição da recompensa no aplicativo: 90
       * Nome da recompensa de arte: 57
       * Descrição da recompensa de arte: 90
       * Rich presence: 44
       * Nome da hero stat: 44

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-add-event-field.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=871e9f749f6af12e6ac3ab9408bf9195" alt="Captura de tela da adição de um campo de evento no Partner Center" width="800" height="535" data-path="images/gdk/services/pctr-add-event-field.png" />

4. Selecione **Save** para criar o evento e fechar a caixa de diálogo, conforme mostrado a seguir.

   <img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/add-event-dialog.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=99d9aff3f2e437f4f91988f317ab3803" alt="Captura de tela da caixa de diálogo Add new event com um novo evento base Basic no Partner Center." width="597" height="631" data-path="images/gdk/services/add-event-dialog.png" />

Seu novo evento agora está listado na página **Events and stat rules**, conforme mostrado a seguir.

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/events-and-stat-rules-2.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=1bac3e1ee375b5735643f078f684afc4" alt="Captura de tela da página Events and stat rules com o evento RecruitUnit adicionado no Partner Center." width="1082" height="750" data-path="images/gdk/services/events-and-stat-rules-2.png" />

Agora que você definiu um evento, pode selecionar o lado direito da linha **Events** para definir uma regra de estatística que use o evento. Para obter mais informações, veja [Configuração no portal de estatísticas baseadas em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-eb-portal).

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

<a id="ID4EYE" />

## Alterar um evento

<Info>
  * Depois que um título passa pela Certificação Final, os eventos existentes nesse título não podem ser alterados, exceto para adicionar novos campos de evento.

  * É possível excluir campos de evento personalizados, mas *não* os campos de evento padrão fornecidos automaticamente quando o evento foi criado.
</Info>

1. Na página **Events and stat rules**, em **Events**, selecione o nome do evento que você deseja alterar.

2. Faça as alterações na caixa de diálogo **Update event**.

3. Selecione **Save**.

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

<a id="ID4EBG" />

## Copiar um evento

Você pode criar um novo evento copiando um evento existente e modificando suas informações.

1. Na página **Events and stat rules**, em **Events**, selecione **Copy** para o evento que você deseja copiar.

2. Insira o **Event name** do seu novo evento.

3. Atualize a descrição e, em seguida, adicione ou remova os campos de evento conforme necessário.

4. Selecione **Save** para criar o evento e fechar a caixa de diálogo.

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

<a id="ID4EBL" />

## Excluir um evento

<Info>
  * Depois que um título passa pela Certificação Final, os eventos existentes nesse título não podem ser excluídos.

  * Excluir um evento exclui todas as dependências encadeadas que ele possa ter. Antes de excluir um evento, verifique se você também deseja excluir todas as dependências dele.

  * Você pode excluir eventos enquanto seu título está em desenvolvimento, mas *não* depois que ele sair da Certificação Final, ou seja, depois que você lançar seu título.
</Info>

1. Na página **Events and stat rules**, em **Events**, selecione **Delete** para o evento que você deseja excluir.

2. Na caixa de diálogo **Confirmation**, selecione **Delete** ou **Cancel**.

O diagrama a seguir mostra como a exclusão de um evento exclui as dependências encadeadas.

<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 como a exclusão de um evento exclui as dependências encadeadas." 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 de eventos no portal](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/events/config/live-events-config-nav.md)
- [Configuração](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/events/config/index.md)
- [Configuração no portal de estatísticas baseadas em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-eb-portal.md)
- [Configuração no portal de conquistas baseadas em eventos](/pt-BR/services/xbox-services/player-data/achievements/event-based/config/live-achievements-eb-config-nav.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)
