> ## 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.
# Recursos de eventos do PlayStream
> Explore os recursos do pipeline de eventos do PlayStream, incluindo o mecanismo de regras em tempo real, a segmentação ao vivo, o depurador de eventos, webhooks e as APIs WriteEvent personalizadas.
O PlayStream oferece aos desenvolvedores de jogos uma variedade de recursos que permitem analisar os dados coletados de eventos no jogo, obter insights valiosos e aumentar o engajamento dos jogadores, e também pode ser usado para LiveOps. Este documento fornece uma análise detalhada de cada um desses recursos.
## Recursos do PlayStream
* **Um pipeline de eventos** - Unifica todo o fluxo de dados do seu jogo em um único fluxo de dados. Os Serviços de Jogos do PlayFab inserem eventos automaticamente no PlayStream, e você pode adicionar eventos personalizados usando os métodos de cliente e servidor da nossa API WriteEvent. Nossos Complementos do Marketplace também geram eventos automaticamente. Os eventos são gerenciados como dados JSON.
* **Um mecanismo de regras em tempo real** - Avalia regras complexas em resposta a eventos recebidos por meio do PlayStream e dispara várias ações, incluindo o CloudScript.
* **Um sistema de segmentação em tempo real** - Agrupa jogadores em segmentos com base em várias propriedades dos jogadores. Os segmentos são calculados em tempo real e estão sempre atualizados. Ações podem ser disparadas automaticamente à medida que os jogadores entram ou saem dos segmentos.
* **Uma visualização em tempo real dos dados de eventos** - Inclui um depurador de eventos em tempo real.
* A capacidade de enviar alguns ou todos os eventos para **serviços Web externos por meio de webhooks** - Eles podem ser configurados automaticamente instalando Complementos do Marketplace ou configurados manualmente para enviar eventos para seus próprios servidores.
* **Um arquivo de eventos** - Onde você pode filtrar, pesquisar e exibir eventos históricos, incluindo o histórico de entrega de eventos.
O PlayStream agora oferece suporte a **eventos de entidade**, bem como aos eventos clássicos do PlayStream. Para saber mais, consulte o artigo [PlayStream com eventos de entidade](/pt-BR/services/playfab/data-analytics/ingest-data/playstream-with-entity-events) depois de concluir este.
Vamos examinar os recursos do PlayStream com mais detalhes.
### Pipeline e monitor de eventos do PlayStream
A maneira mais fácil de ver o pipeline de eventos em ação é por meio do Depurador do PlayStream. Você notará o monitor assim que selecionar a seção **Title Overview** e entrar na guia **PlayStream Monitor** do seu jogo.
O monitor do PlayStream é um fluxo em tempo real de todos os eventos do seu jogo, incluindo os eventos personalizados que você optar por enviar usando os métodos da nossa API WriteEvent.
Isso é extremamente valioso durante o desenvolvimento, pois oferece uma maneira de ver imediatamente o que está acontecendo no back-end enquanto você testa seu código do lado do cliente e do servidor. Ele também leva você diretamente às contas dos jogadores, para que você possa verificá-las em relação à lógica do jogo em que está trabalhando.
Há vários campos selecionáveis em cada evento. Se você selecionar o círculo de informações "(i)", verá os dados JSON brutos do evento.
Você também pode selecionar a ID do jogador para ir diretamente ao perfil do jogador. Alguns outros eventos também têm campos selecionáveis.
Quando estiver na exibição de um jogador específico, você pode selecionar a guia **PlayStream**, que deve mostrar a exibição do monitor em tempo real filtrada por esse jogador específico.
### Segmentação de jogadores e ações
Usando esses eventos, você pode configurar segmentos, que definem jogadores entre seus usuários, com base na maioria das propriedades dos jogadores. Tudo isso acontece em tempo real, portanto não deve haver atraso perceptível, mesmo em grande escala.
Se você puder vincular um evento ao elemento que deseja usar como fator de diferenciação, poderá criar um segmento para ele. E os segmentos se aplicam retroativamente a *todos* os jogadores, com base nos dados de seus perfis. Portanto, se você definir um segmento de jogadores em que XP > 3.000, todos os jogadores com XP > 3.000 passarão a estar nesse segmento.
Esse segmento específico será avaliado sempre que a estatística chamada "Total\_XPGained" for alterada. Se a condição (> 3000) for avaliada como **TRUE**, o jogador entrará no segmento "High XP Players" e as ações correspondentes serão disparadas. Nesse caso, uma notificação por push será enviada e ouro será concedido ao jogador.
Você também pode disparar diferentes ações personalizadas quando o jogador sai de um segmento, permitindo fazer quaisquer outras alterações necessárias como resultado.
Há várias ações básicas disponíveis, incluindo conceder um item ao jogador, conceder moeda virtual, alterar estatísticas, banir um jogador, enviar um email ao jogador ou enviar uma notificação por push. Você também pode disparar a execução de um CloudScript personalizado.
### Regras e ações
O mesmo sistema de ações mostrado acima também pode ser utilizado para responder a eventos específicos vindos do seu jogo. Por exemplo, a regra mostrada abaixo demonstra como, quando um evento personalizado (**Client\_StoreVisit**) é detectado, o jogador recebe um pouco de moeda virtual e uma notificação por push agradecendo pela visita.
Usando regras e ações, você pode influenciar os comportamentos de LiveOps no seu jogo sem fazer nenhuma alteração no cliente do jogo.
### Webhooks
Você também pode configurar Webhooks, de modo que alguns ou todos os eventos que passam pelo PlayStream sejam enviados por push para um serviço externo.
Por exemplo, você pode usar o recurso mostrado abaixo para chamar seu próprio servidor de back-end em qualquer logon de jogador.
Os Webhooks do PlayStream são chamadas POST para o ponto de extremidade fornecido por você, que transmitem todos os dados do evento no corpo da chamada. Usando esse mecanismo, você pode habilitar ações personalizadas adicionais nos seus dados em tempo real, usando seus próprios serviços personalizados.
### Data Explorer
Por padrão, os eventos são mantidos por um determinado período que depende do seu nível de serviço. Você pode exibir todo o histórico de eventos em dois lugares: pode exibir todos os eventos do seu title na guia **Data Explorer Basic** ou na guia **Data Explorer Advanced**. Ambas estão na seção **Data** do **Game Manager**.
### Marcas personalizadas
O recurso [Marcas Personalizadas](/pt-BR/services/playfab/data-analytics/ingest-data/playstream-custom-tags) permite que os desenvolvedores de jogos enriqueçam ainda mais seus eventos padrão do PlayStream com metadados específicos do negócio.
Esse é um recurso de qualidade de vida projetado para tornar o desenvolvimento com base no PlayFab mais fácil e extensível.
### Propriedades personalizadas
Esse recurso permite armazenar e acessar pontos de dados importantes adicionais sobre seus jogadores.
Por exemplo, você pode usar propriedades personalizadas para salvar e recuperar dados relacionados às preferências dos jogadores, como seus modos de jogo ou tipos de personagem favoritos. Com isso, você pode criar uma segmentação mais direcionada que possibilita experiências personalizadas para seus jogadores, em Segmentos, ações associadas como o CloudScript ou com Experimentos.
## Eventos V1 vs. V2
O PlayStream oferece eventos V1 e V2, e a tabela abaixo fornece uma comparação de recursos para cada tipo de evento:
| Recurso | V1 (Jogador/Title/Personagem) | V2 (Baseado em entidade) |
| - | - | - |
| Event Explorer | Sim | Sim |
| Conexões de Dados | Sim | Sim |
| Depurador do PlayStream | Sim | Sim |
| Ações | Execute Function
Send Email
Push Notification
CloudScript
Player Ban Action
GrantVC
Delete Player
Increment Statistic | Execute Function
Send Email
Inventory/AddVC
Inventory/GrantItem |
| Segmentos | Sim | Não |
| Regras disparadas por eventos | Sim | Sim |
| Webhooks | Sim | Não |
| Propriedades personalizadas | Sim | Sim |
| Arquivador S3 (Herdado) | Sim | Não |
## Como o PlayStream pode ajudar a impulsionar seu jogo
Estes são alguns exemplos de como você pode usar o PlayStream para impulsionar seu jogo e liberar todo o seu potencial:
* Dispare ações, como conceder itens e moeda virtual, quando os jogadores fizerem logon, concluírem níveis de tutorial ou atingirem marcos específicos, e use esses dados para personalizar a experiência do jogador.
* Sinalize ou bana automaticamente jogadores que apresentem comportamento de trapaça.
* Colete dados sobre a progressão dos jogadores, a mecânica de jogo e a dificuldade dos níveis. Use esses dados para tomar decisões informadas sobre o balanceamento e o ajuste do jogo, garantindo uma experiência desafiadora, porém agradável, para os jogadores.
* Incentive e recompense interações sociais positivas no jogo.
* Envie notificações por push ou emails automáticos quando os jogadores atingirem marcos, fizerem compras ou concluírem níveis.
## Related topics
- [Tabelas de classificação com PlayStream e Telemetry](/pt-BR/services/playfab/community/leaderboards/leaderboards-with-playstream-and-telemetry.md)
- [PlayStream com eventos de entidade](/pt-BR/services/playfab/data-analytics/ingest-data/playstream-with-entity-events.md)
- [Referência do modelo de eventos do PlayStream para o PlayFab](/pt-BR/services/playfab/api-references/events/index.md)
- [Estatísticas com PlayStream e telemetria](/pt-BR/services/playfab/player-progression/statistics/statistics-with-playstream-and-telemetry.md)
- [Eventos do PlayStream](/pt-BR/services/playfab/data-analytics/ingest-data/playstream-events.md)