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

# 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](/pt-BR/services/playfab/live-service-management/gamemanager/quickstart). 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](/pt-BR/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream) 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.
</Note>

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.

<img src="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" alt="Game Manager: players: segments: novo segmento" width="1280" height="720" data-path="images/playfab/data-analytics/acting-data/tutorials/game-manager-players-segments-new-segment.png" />

A parte mais complexa deste exemplo é o CloudScript. Use o segundo parâmetro, *Context*, no seu [manipulador do CloudScript](/pt-BR/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream) 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](/pt-BR/services/playfab/player-progression/player-data/player-inventory), [moeda virtual](/pt-BR/services/playfab/economy-monetization/economy-v2/tutorials/currencies), [dados do jogador](/pt-BR/services/playfab/player-progression/player-data/quickstart) ou [estatísticas](/pt-BR/services/playfab/community/leaderboards/tournaments-leaderboards/using-player-statistics).

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


## Related topics

- [Segmentação](/pt-BR/services/playfab/live-service-management/game-configuration/segmentation/segmentation-overview.md)
- [Lojas personalizadas para segmentos de jogadores no Economy (Legacy)](/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](/pt-BR/services/playfab/live-service-management/index.md)
- [Visão geral do gerenciamento de serviços ao vivo](/pt-BR/services/playfab/live-service-management/overview.md)
- [Recursos de eventos do PlayStream](/pt-BR/services/playfab/data-analytics/ingest-data/playstream-event-capabilities.md)