> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Segmentação de jogadores

> Defina segmentos de jogadores do PlayFab no Game Manager com base em estatísticas, marcas ou moeda e dispare ações do CloudScript quando os jogadores entrarem em um segmento.

A segmentação de jogadores é definida no [Game Manager](https://docs.xbox.com/pt-BR/services/playfab/live-service-management/gamemanager/quickstart.md). Os segmentos permitem definir grupos de jogadores úteis ou interessantes e executar ações exclusivas nesse grupo.

## Requisitos

* Jogadores com e sem uma característica distintiva definida no PlayFab.

* Um [gancho do PlayStream do CloudScript](https://docs.xbox.com/pt-BR/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream.md) definido.

### Caso de exemplo: executar um CloudScript personalizado para cada jogador que atingir uma meta no jogo

A *característica definidora* de um jogador pode ser:

* Horário de login
* Tipo de dispositivo vinculado
* Marcas
* Localização no mundo real
* Valores de estatísticas
* Valores de moeda virtual
* Compras com dinheiro real e muito mais.

Neste exemplo, nossa característica distintiva será uma estatística, especificamente jogadores que atingirem **50 str**.

> [!NOTE]
>
> As estatísticas são uma das muitas opções possíveis e só são exigidas especificamente neste exemplo. Fique à vontade para substituir o requisito de estatística por outro filtro de sua escolha.

Nossa ação será executar uma função do CloudScript. O CloudScript é, de longe, a opção de gatilho mais flexível, concedendo controle total sobre as informações do jogador e da segmentação no momento da transição de segmento.

Na tela do **Game Manager**:

* Navegue até seu **Title**.
* Selecione **Players** no menu à esquerda.
* Vá para a guia **Segments**.
* Selecione **New Segment**.

A tela mostrada abaixo é um exemplo do **Segment** descrito acima.

![Game Manager: players: segments: novo segmento](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/tutorials/game-manager-players-segments-new-segment.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=816790fcff260f025fe164429652ba7f)

A parte mais complexa deste exemplo é o CloudScript. Use o segundo parâmetro, *Context*, no seu [manipulador do CloudScript](https://docs.xbox.com/pt-BR/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream.md) para identificar o jogador e a transição de segmento.

Depois, execute qualquer ação que desejar no jogador, como conceder [itens de inventário](https://docs.xbox.com/pt-BR/services/playfab/player-progression/player-data/player-inventory.md), [moeda virtual](https://docs.xbox.com/pt-BR/services/playfab/economy-monetization/economy-v2/tutorials/currencies.md), [dados do jogador](https://docs.xbox.com/pt-BR/services/playfab/player-progression/player-data/quickstart.md) ou [estatísticas](https://docs.xbox.com/pt-BR/services/playfab/community/leaderboards/tournaments-leaderboards/using-player-statistics.md).

Confira também: [Práticas recomendadas para segmentação de lojas](https://docs.xbox.com/pt-BR/services/playfab/economy-monetization/economy-v2/overview.md)


## Related topics

- [Segmentação](https://docs.xbox.com/pt-BR/services/playfab/live-service-management/game-configuration/segmentation/segmentation-overview.md)
- [Lojas personalizadas para segmentos de jogadores no Economy (Legado)](https://docs.xbox.com/pt-BR/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments.md)
- [Documentação do gerenciamento de serviços ao vivo do PlayFab](https://docs.xbox.com/pt-BR/services/playfab/live-service-management/index.md)
- [Visão geral do gerenciamento de serviços ao vivo](https://docs.xbox.com/pt-BR/services/playfab/live-service-management/overview.md)
- [Recursos de eventos do PlayStream](https://docs.xbox.com/pt-BR/services/playfab/data-analytics/ingest-data/playstream-event-capabilities.md)