Configuração de segmentos

A página Segment configuration, acessada pela guia Players no Game Manager, permite configurar um segmento novo ou existente ajustando o nome, definindo filtros e atribuindo tarefas. Cada segmento permite definir grupos de jogadores úteis ou interessantes e executar ações exclusivas nesse grupo.

​

Como criar e acessar um segmento

Para acessar a configuração de segmentos:

1. Selecione Players no menu à esquerda.
2. Selecione a guia Segments.

Em seguida, você pode optar por:

3. Usar o botão New Segment para criar e configurar um novo Segment.
4. Localizar um Segment existente e selecionar o rótulo do nome para configurar o Segment.

​

Como configurar um segmento

Pré-requisitos: Para configurar um segmento como o do exemplo deste tutorial, você precisará de:

• Jogadores com e sem uma característica distintiva definida no PlayFab.
• Um gancho do PlayStream do CloudScript definido.

Neste exemplo, vamos:

• Configurar um segmento usando esta característica definidora: todos os jogadores que vêm do Canadá.
• Executar uma função do CloudScript helloWorld para cada jogador que entrar no segmento.

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.

A localização do jogador é uma das muitas opções possíveis e só é exigida especificamente neste 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ções a serem executadas quando um jogador entra ou sai do segmento. O CloudScript é, de longe, a ação mais flexível, concedendo controle total sobre as informações do jogador e da segmentação no momento da transição de segmento. Use o segundo parâmetro, Context, no manipulador do CloudScript 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, moeda virtual, dados do jogador ou estatísticas. Neste caso específico, a configuração do segmento exige 4 etapas simples:

1. Atribua um nome adequado ao segmento. É uma boa ideia usar um nome que incorpore sua característica definidora: Canada Players.
2. Atribua as condições que um jogador precisa atender para entrar no segmento. Neste caso, queremos um filtro Location (country/region) com o valor estrito: Canada.
3. Adicione uma ação do CloudScript para o gatilho de entrada no segmento. Configure a ação para executar a função desejada. Neste exemplo, queremos helloWorld.
4. Confirme selecionando o botão Save Segment.

Quando um segmento é definido, você tem várias opções de ações a serem executadas quando um jogador entra ou sai do segmento. O CloudScript é, de longe, a ação mais flexível, concedendo controle total sobre as informações do jogador e da segmentação no momento da transição de segmento. Use o segundo parâmetro, Context, no manipulador do CloudScript 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, moeda virtual, dados do jogador ou estatísticas. Neste caso específico, a configuração do segmento exige 4 etapas simples:

1. Atribua um nome adequado ao segmento (é uma boa ideia usar um nome que incorpore sua característica definidora: Canada Players).
2. Atribua as condições que um jogador precisa atender para entrar no segmento. Neste caso, queremos um filtro Location (country/region) com o valor estrito: Canada.
3. Adicione uma ação do CloudScript para o gatilho de entrada no segmento. Configure a ação para executar a função desejada. Neste exemplo, queremos: helloWorld.
4. Confirme selecionando o botão Save Segment.

O Group (2) é um conjunto de jogadores que atendem a todas as condições definidas, chamadas Filters (3). Em outras palavras, para fazer parte de um segmento, um jogador precisa fazer parte de pelo menos 1 grupo. Para fazer parte de um grupo, um jogador precisa atender a todas as condições (filtros). Isso é indicado pelos operadores OR/AND: os filtros são combinados com o operador AND, enquanto os grupos são combinados com o operador OR. A captura de tela abaixo mostra um exemplo de como um segmento pode ser definido. Esse segmento consiste em 2 grupos. O primeiro grupo é definido por 2 filtros:

• O jogador deve ser do Canadá.
• O jogador deve ter Push notifications enabled da Apple.

O segundo grupo também é para jogadores do Canadá, mas eles devem ter Push notifications enabled do Google.
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 estão disponíveis:

• O filtro All players: esse filtro não tem configuração e é único, pois permite criar um segmento com todos os jogadores. Isso é útil quando você quer executar operações automáticas para cada novo jogador (as ações de segmento são descritas na seção Como gerenciar ações, mais adiante neste tutorial).
• O filtro First login (date): permite filtrar com base na data e hora do primeiro login. Por exemplo, jogadores que fizeram o primeiro login após 1/1/2017.
• O filtro First login (timespan): permite filtrar com base no intervalo de tempo do primeiro login em relação à data e hora atuais. Por exemplo, jogadores que entraram pela primeira vez há 20 minutos (a partir de agora).
• O filtro Last login (date): permite filtrar com base na data e hora do último login. Por exemplo, jogadores que não entram desde 1/1/2017.
• O filtro Last login (timespan): permite filtrar com base no intervalo de tempo do último login em relação à data e hora atuais. Por exemplo, jogadores que não entram há uma semana (a partir de agora).
• O filtro Linked user account to: permite filtrar com base nas contas vinculadas dos usuários. Por exemplo, jogadores que têm uma conta do Steam vinculada a uma conta de email.
• O filtro Location (country/region): permite filtrar com base no país/região do jogador. Por exemplo, jogadores do Canadá.
• O filtro Push notifications enabled with: permite filtrar com base nas configurações e recursos de push do jogador. Por exemplo, jogadores que têm as notificações por push do Google habilitadas.
• O filtro Statistics value: permite filtrar com base no seu próprio atributo de estatística personalizado. Por exemplo, jogadores que causaram 20000 de dano no total.
• O filtro Tag: permite filtrar com base em se um jogador tem ou não uma determinada marca. Por exemplo, jogadores que têm a marca cheater.
• O filtro Total value to date in US: permite filtrar com base em quanto em USD um jogador gastou no seu jogo. Por exemplo, jogadores que gastaram mais de US$ 30.
• O filtro Value to date: permite filtrar com base em quanto de uma determinada moeda um jogador gastou no seu jogo. Por exemplo, jogadores que gastaram 50 RUB.
• O filtro User origination: permite filtrar com base no primeiro método de autenticação que um jogador usou para começar a jogar.

• O filtro Virtual currency balance: permite filtrar com base no depósito de moeda virtual personalizada de um jogador. Por 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 na página. Às vezes, porém, você precisa selecionar um gatilho, ou seja, um evento que faz com que uma ação seja executada. Um gatilho define o contexto da ação. Por exemplo, um gatilho player entered segment passa a você o contexto que contém uma referência ao jogador. O fluxo de trabalho geral do painel Actions é:

1. Selecione uma Event condition, também conhecida como gatilho.
2. Selecione um Type de ação. O PlayFab oferece várias 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 (específica de cada Type de ação).
4. Selecione REMOVE para remover a ação do gatilho.
5. Selecione Add Action para adicionar uma ação ao gatilho.

​

Como inspecionar os segmentos do jogador

É possível consultar a quais segmentos um jogador pertence por meio da página Player Segments. Para acessar a página Player Segments:

1. Selecione Players no menu da barra lateral.
2. Em seguida, selecione a guia Players.
3. Localize o jogador que você deseja inspecionar e selecione o rótulo ID.
4. Por fim, selecione Segments na Players Toolbar.

Na página Player Segments, observe o seguinte:

1. O rótulo Player ID identifica o jogador que você está inspecionando no momento.
2. A tabela Segments contém uma lista de todos os segmentos aos quais um jogador pertence. Selecione o rótulo Segment name para configurar um segmento.