​

Segmentação avançada com propriedades personalizadas (versão prévia pública)

​

Criar segmentos com propriedades personalizadas do jogador

​

Por meio da API

• Use a API Create Segment para criar um segmento.
• Adicione predicados de propriedades personalizadas usando a API Update Segment.

​

Por meio do Game Manager

• Entre no Game Manager.
• Acesse a página Players.
• Acesse a guia Segments.
• Crie ou atualize um segmento.
• Adicione predicados de propriedades personalizadas selecionando Add filter em Player.
• Salve o segmento.

​

Exportar jogadores de um segmento com propriedades personalizadas

1. Crie um segmento que faça referência a predicados de propriedades personalizadas.
2. Use a API ExportPlayersInSegment para exportar perfis de jogador

​

Tarefas agendadas

1. Execute uma tarefa agendada em um segmento usando predicados de propriedades personalizadas.

​

Cenários de início rápido

​

Configurar o catálogo e o inventário do Economy V2

1. Crie uma moeda Gold Bar como um item.
2. Crie uma moeda Chocolate Bar como um item.
   • Parâmetros obrigatórios: Friendly ID, Title e Start Date (1º de março)\
3. Crie um item de catálogo Chocolate Bar:
   3a. Navegue até Settings -> Economy (V2) -> Catalog (V2).
   3b. Em Catalog Settings, adicione um novo Content Type, Chocolate Bar, e selecione Save. 3c. Acesse Engage -> Economy -> Catalog (V2) -> Items e selecione New item para adicionar. 3d. Selecione Chocolate Bar em ContentType, defina Start date, Time e Title e, em seguida, selecione Save and Publish.

​

1. Criar um segmento para usuários que gastam entre 25 e 50 Gold Bars (moeda virtual gasta)

1. Navegue até a página PlayStream Rules em Automation -> Rules.
2. Crie uma regra para o evento items_subtracted com a seguinte configuração: Condições:
   • Payload.ItemId == <id of Gold Bar currency>
   • Opcional: Payload.Amount entre 25 e 50 para evitar a substituição por outros valores
   Ações:
   • Atualizar propriedades personalizadas
     • AmountSpent = Payload.Amount
     • ItemName = Payload.ItemId
   
3. Navegue até a página Segments em Players -> Segments.
4. Crie um novo segmento com a seguinte configuração:
   • A propriedade personalizada (string) ItemName é <Gold Bar id>
   • A propriedade personalizada (numérica) AmountSpent é >= 25
   • A propriedade personalizada (numérica) AmountSpent é <= 50
   

​

2. Criar um segmento para usuários que receberam Chocolate Bars e usaram todas elas (10) após 1º de abril de 2025 (inventário concedido)

1. Navegue até a página PlayStream Rules em Automation -> Rules.
2. Crie uma regra para o evento playfab.inventory.items_granted com a seguinte configuração: Condições:
   • Payload.ItemId == <Chocolate Bars id>
   Ações:
   • Atualizar propriedades personalizadas do jogador
     • AmountSpent = Payload.Amount
     • ItemUpdateDate = Timestamp
   
3. Navegue até a página Segments em Players -> Segments.
4. Crie um segmento com a seguinte configuração:
   • Propriedade personalizada (string) ItemName = <Chocolate Bars id>
   • Propriedade personalizada (datetime) ItemUpdateDate > 4/1/2025
   • Propriedade personalizada (numérica) ItemAmountSpent >= 10
   
5. Como funciona: a regra atualizará a propriedade personalizada do jogador com o valor de cada evento individual; ela não acumulará nem somará valores ao longo do tempo. Por exemplo, se um jogador gastar 1 chocolate bar em dez ocasiões separadas, a propriedade ItemAmountSpent será definida como 1 a cada vez, e não 10. Como resultado, o jogador não será incluído no segmento que filtra por ItemAmountSpent >= 10. Se você precisar acompanhar valores cumulativos ou agregados (por exemplo, o total de itens gastos em vários eventos), recomendamos implementar uma lógica personalizada usando uma Azure Function ou o CloudScript para calcular e atualizar o total.
6. Observação: as Gold Bars do cenário 1 e as Chocolate Bars do cenário 2 gravam na mesma propriedade ItemName. Se quiser acompanhar vários valores, você precisará de vários nomes de propriedade para evitar que um jogador fique alternando entre 2 segmentos.

​

3. Criar um segmento para usuários que compraram 1 Chocolate Bar em uma única compra (compra de catálogo)

1. Navegue até a página PlayStream Rules em Automation -> Rules.
2. Crie uma regra para o evento playfab.inventory.items_purchased com a seguinte configuração: Condições:
   • Payload.ItemType == ChocolateBar
   • Payload.Amount >= 1
   • Timestamp >= 5 minutes ago
   Ações:
   • Atualizar propriedades personalizadas
     • ChocolateBarPurchased = Payload.Amount
   
3. Navegue até a página Segments em Players -> Segments.
4. Crie um segmento com a seguinte configuração:
   • Propriedade personalizada (numérica) ChocolateBarPurchased >= 1
   
5. Como funciona: sempre que um jogador compra uma Chocolate Bar, a condição da regra é disparada, executando a ação para adicionar a propriedade personalizada. Em seguida, o jogador entra no segmento e pode receber a recompensa ou a notificação configurada.