Usar marcas personalizadas com eventos do PlayStream
As Marcas Personalizadas são uma coleção de pares chave-valor que os estúdios podem incluir opcionalmente em cada solicitação de API. Elas são úteis para enriquecer os eventos padrão do PlayStream com mais metadados específicos do estúdio (por exemplo, número do build, identificadores de rastreamento externos etc.). As Marcas Personalizadas ampliam as maneiras pelas quais você pode usar os eventos do PlayStream. O esquema básico do PlayStream é fixo e não tem extensibilidade, mas nos permitiu criar métricas e análises comuns. A natureza fixa do esquema limitava a capacidade dos estúdios de jogos de personalizar seus dados de maneira eficiente e econômica, bem como a capacidade de coletar pontos de dados específicos. As Marcas Personalizadas oferecem uma maneira de estender o esquema para permitir maior flexibilidade e funcionalidade.O que você pode fazer com as Marcas Personalizadas?
Há muitas coisas que você pode realizar usando as Marcas Personalizadas. Aqui estão algumas sugestões, mas fique à vontade para ser mais criativo ao usá-las.Automação
Os metadados do PlayStream podem atuar como critérios que disparam determinados eventos. Quando uma tarefa precisa ser realizada, um cliente do PlayFab pode configurar uma regra para dizer “se [Marcas Personalizadas] atender ao requisito xyz, dispare a ação A.” Você pode integrar o CloudScript às Marcas Personalizadas para obter automação. As Ações e Regras do CloudScript permitem disparar eventos automaticamente com base em determinados critérios. Por exemplo, se o seu estúdio de jogos estiver investindo em marketing de desempenho para o seu jogo e você estiver executando várias campanhas de marketing diferentes para adquirir novos jogadores, agora você pode rastrear a campanha de marketing que adquiriu um jogador e adicionar essa ID de campanha a todos os eventos do PlayStream. Em seguida, você pode usar essa ID de campanha para automatizar processos. Por exemplo, se o seu anúncio prometeu “1.000 moedas de ouro grátis por se inscrever”, envie o evento “novo jogador” e use a campanha de marketing para decidir qual incentivo dar ao jogador. Por exemplo, ‘se campanha de marketing = ‘FREE_GOLD_COINS’, dê ao jogador 1.000 moedas de ouro.Telemetria
Os metadados do PlayStream podem ajudar na coleta e na análise de dados. Por exemplo, você pode enviar Marcas Personalizadas como parte dos dados de eventos do PlayStream a partir de serviços que não são do PlayFab e acompanhá-los à medida que fluem pelos pipelines de dados. Se você já tem seu próprio sistema de análise (por exemplo, baseado em algum identificador), pode integrar e mesclar facilmente novos dados passando esse identificador nas Marcas Personalizadas como parte dos seus eventos do PlayStream. Você pode incluir IDs de campanha ou outros identificadores analíticos para analisar a receita, determinando qual campanha gerou a maior aquisição de novos jogadores, fluxo de receita ou valor do cliente.Fluxo de dados
Depois que as Marcas Personalizadas são recebidas da solicitação de API, os dados passam a fazer parte do evento do PlaySteam, que então flui pelos pipelines do PlaySteam para ser armazenado no Kusto, o data warehouse de back-end do PlayFab.Limitações
- As Marcas Personalizadas têm as seguintes restrições:
- No máximo 10 pares chave-valor
- Cada cadeia de caracteres de chave não pode ter mais de 64 caracteres utf8
- Cada cadeia de caracteres de valor não pode ter mais de 128 caracteres utf8
- Compatível somente com chamadas de API (ou seja, não compatível com a interface do usuário do Game Manager)
Introdução
A solicitação de exemplo a seguir mostra como adicionar Marcas Personalizadas à sua solicitação JSON. AsCustomTags acompanham os eventos relevantes do PlayStream à medida que fluem pelos pipelines de dados, e você pode acessar esses dados posteriormente para fins acionáveis e analíticos.
Solicitação de exemplo
Resposta de exemplo
Adicionar Marcas Personalizadas não altera a resposta que você recebe da chamada ao ponto de extremidade. A resposta depois que você adiciona oCustomTag node é idêntica à que você recebe quando o nó não está presente.