Pular para o conteúdo principal
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.
Game Manager - Jogadores - Criar ou acessar segmentos

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.

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
  • 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 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, moeda virtual, dados do jogador ou estatísticas. 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.
Game Manager - jogadores - configuração de novo segmento

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). Game Manager - jogadores - filtragem avançada de segmentos 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.
  1. Configure a ação (3) (específica de cada tipo de ação).
  2. Remova uma ação (4) do gatilho.
  3. Use Add Action (5) para adicionar uma ação ao gatilho.
Game Manager - Jogadores - Painel Actions

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.
Game Manager - jogadores - acessar segmentos 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.
Game Manager - Jogadores - Acessar segmentos
Última modificação em 8 de outubro de 2026