> ## 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 segmentos de jogadores
> Configure segmentos de jogadores do PlayFab para agrupar jogadores por dados, comportamento e regras de progressão que orientam ações direcionadas e análises.
A página de configuração de segmentos permite configurar segmentos novos ou existentes. Você pode:
* Ajustar o nome.
* Definir os filtros.
* Atribuir tarefas.
Cada segmento permite definir grupos úteis ou interessantes de jogadores e executar ações exclusivas nesse grupo.
## Como criar ou acessar um segmento
Para acessar a configuração de segmentos:
1. No lado esquerdo, selecione a área **Players**.
2. Selecione a guia **Segments**. A partir daí, você pode optar por:
* Usar o botão **New Segment** para criar e configurar um novo segmento\*.
* Localizar um segmento existente e selecionar o rótulo **Name** dele para configurar o segmento.
## Como configurar um segmento
### Pré-requisitos
Alguns itens já precisam existir para que você possa configurar um segmento. Já deve haver:
* Jogadores com e sem uma característica distintiva definida no PlayFab.
* Um gancho do PlayStream definido para o CloudScript.
Para saber mais sobre isso, consulte [Usando ações do CloudScript com o PlayStream](/pt-BR/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream).
### Configurando
Neste exemplo, vamos:
* Configurar um segmento usando a característica definidora: todos os jogadores do Canadá.
* Executar uma função do CloudScript **helloWorld** para cada jogador que entrar no segmento.
Uma *característica definidora* de um jogador pode ser:
[Configurar sua primeira moeda virtual](/pt-BR/services/playfab/economy-monetization/economy-v2/tutorials/currencies)
* Horário de login
* Tipo de dispositivo vinculado
* Marcas
* Uma localização no mundo real
* Os valores das estatísticas
* Os valores de moeda virtual
* Compras com dinheiro real etc.
A localização do jogador é apenas uma das *muitas* opções possíveis e só é necessária para este exemplo. Fique à vontade para substituir o requisito de país/região por outro filtro de sua escolha.
Quando um segmento é definido, você tem várias opções de ação para executar quando um jogador entra no segmento ou sai dele.
O CloudScript é, de longe, a ação mais flexível, concedendo controle total sobre as informações do jogador e do segmento no momento da transição de segmento.
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, você pode executar qualquer ação que desejar para o 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).
No exemplo mostrado aqui, a configuração do segmento exige quatro etapas simples.
1. Atribua um **Segment name (1)** apropriado (no nosso exemplo, **Canadian Players**).
2. Na área **Player (2)**, atribua as condições que o **jogador** deve atender para entrar no segmento. (No nosso exemplo, queremos um filtro **Location (country/region)** com um valor estrito: **Canada**.
3. Na área **Type**, adicione uma ação **Execute CloudScript (3)** para o gatilho de entrada no segmento.
4. Configure a ação para executar a função desejada (**helloWorld (3)**).
5. Use o botão **Save Segment** **(4)** para confirmar suas atividades.
## Filtragem avançada de segmentos
A filtragem de segmentos permite definir quais jogadores são incluídos no segmento.
Formalmente, a área **(1)** à esquerda da tela mostrada abaixo é um conjunto de jogadores que pertencem a pelo menos um grupo.
Um **Group (2)** é um conjunto de jogadores que atendem a todas as condições definidas, chamadas de **filters (3)**.
Portanto, para fazer parte de um segmento:
* Um jogador deve fazer parte de pelo menos um grupo.
* Para fazer parte de um grupo, um jogador deve atender a todas as condições (filtros).
* Isso é indicado pelos operadores OR/AND:
* Os filtros são combinados usando o operador AND.
* Os grupos são combinados usando o operador OR.
A captura de tela mostrada acima é um exemplo de como um segmento pode ser definido. Esse segmento consiste em dois grupos:
1. O primeiro grupo é definido por dois filtros:
* O jogador deve ser do Canadá.
a. E deve ter as notificações por push da Apple habilitadas.
* O segundo grupo *também* é para jogadores do Canadá, mas eles devem ter as notificações por push do Google habilitadas.
No final, temos um segmento de jogadores do Canadá com notificações por push do Google ou da Apple.
Cada filtro tem uma configuração e uma finalidade exclusivas. Em 30/04/2017, os seguintes filtros estavam disponíveis:
* Filtro **All Players**: este filtro não tem configuração e é exclusivo, pois permite criar um segmento de todos os jogadores. Ele é útil quando você deseja executar operações automáticas para cada novo jogador (as ações de segmento são descritas mais adiante neste tutorial).
* Filtro **First login (date)**: permite filtrar com base na data e hora do primeiro login (exemplo: jogadores que fizeram o primeiro login após 01/01/2017).
* Filtro **First login (timespan)**: permite filtrar com base no intervalo de tempo do primeiro login em relação à data e hora atuais (exemplo: jogadores que entraram pela primeira vez há 20 minutos \[a partir de agora]).
* Filtro **Last login (date)**: permite filtrar com base na data e hora do último login (exemplo: jogadores que não entram desde 01/01/2017).
* Filtro **Last login (timespan)**: permite filtrar com base no intervalo de tempo do último login em relação à data e hora atuais (exemplo: jogadores que não entram há uma semana \[a partir de agora]).
* Filtro **Linked user account to**: permite filtrar com base nas contas vinculadas dos usuários (exemplo: jogadores que têm uma conta da Steam vinculada com email).
* Filtro **Location (country/region)**: permite filtrar com base no país/região do jogador (exemplo: jogadores do Canadá).
* Filtro **Push notifications enabled with**: permite filtrar com base nas configurações e nos recursos de notificação por push do jogador (exemplo: jogadores que têm as notificações por push do Google habilitadas).
* Filtro **Statistics value**: permite filtrar com base no seu próprio atributo de estatística personalizado (exemplo: jogadores que causaram 20000 de dano no total).
* Filtro **Tag**: permite filtrar com base em se um jogador tem ou não determinada marca (exemplo: jogadores que têm a marca *cheater*).
* Filtro **Total value to date in USD**: permite filtrar com base em quanto um jogador gastou em USD no seu jogo (exemplo: jogadores que gastaram mais de US\$ 30).
* Filtro **Value to date**: permite filtrar com base em quanto de determinada moeda um jogador gastou no seu jogo (exemplo: jogadores que gastaram 50 RUB).
* Filtro **User Origination**: permite filtrar com base no primeiro método de autenticação que um jogador usou para começar a jogar.
O detalhe aqui é que um jogador pode começar com uma autenticação baseada, digamos, em uma ID de dispositivo iOS. Mais tarde, o jogador pode ter uma conta do GameCenter vinculada. Nesse caso, a origem do jogador será a ID de dispositivo iOS (exemplo: jogadores que entraram pela primeira vez usando uma ID de dispositivo iOS).
* Filtro **Virtual currency balance**: permite filtrar com base no saldo de uma moeda virtual personalizada do jogador (exemplo: jogadores que têm menos de 50 Crystal).
## Como gerenciar ações
Cada ação precisa de um *gatilho* para ser executada. Algumas ações são executadas manualmente, disparadas diretamente da página.
Mas, às vezes, *você* precisa selecionar um gatilho: um evento que faz com que uma ação seja executada. Um gatilho define o contexto da ação.
Por exemplo, o gatilho Player Entered Segment fornece o contexto que contém uma referência ao jogador.
O fluxo de trabalho geral do painel **Actions** é o seguinte:
1. Selecione uma **event condition (1)**, também conhecida como *gatilho*.
2. Selecione o **Type** de ação.
O PlayFab oferece uma variedade de ações. Se, em algum momento, você precisar de uma ação mais flexível, considere uma ação do CloudScript. Esse tipo de ação permite executar sua própria função do CloudScript.
3. **Configure a ação (3)** (específica de cada tipo de ação).
4. **Remova uma ação (4)** do gatilho.
5. Use **Add Action (5)** para adicionar uma ação ao gatilho.
## Como inspecionar os segmentos de jogadores
É possível consultar a quais segmentos um jogador pertence na página Player Segments.
Para acessar Player Segments:
1. Selecione a seção **Players**.
2. Selecione a guia **Players**.
3. Selecione o rótulo **ID** do jogador que você deseja inspecionar.
4. Selecione **Segments** na barra de ferramentas Players.
Na página Player Segments, você verá o seguinte:
* O rótulo **Player ID (1)** identifica o jogador que você está inspecionando no momento.
* A tabela **Segment** contém uma lista de todos os segmentos aos quais um jogador pertence.
* Selecione o rótulo **Segment name** **(2)** para configurar o segmento.
## Related topics
- [Segmentos de jogadores](/pt-BR/services/playfab/player-progression/player-data/player-segments.md)
- [Ofertas direcionadas do Economy V2](/pt-BR/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/targeted-offers.md)
- [Configuração de segmentos](/pt-BR/services/playfab/live-service-management/game-configuration/segmentation/segmentation-configuration.md)
- [Ações em massa para um Segmento de Jogadores inteiro](/pt-BR/services/playfab/data-analytics/acting-data/action-rules-bulk-actions-for-an-entire-player-segment.md)
- [Visão geral do gerenciamento de serviços ao vivo](/pt-BR/services/playfab/live-service-management/overview.md)