Eventos personalizados

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Eventos personalizados permitem que você rastreie métricas específicas do seu jogo que outros eventos não capturam completamente. Isso inclui:

  • Adoção — Quantos usuários clicam em um componente de UI específico?
  • Comportamento do usuário — Qual é a habilidade mais utilizada em cada mapa?
  • Ciclo principal — Como as taxas de morte/morte se comparam entre diferentes armas?

Uma vez que seu jogo comece a rastrear eventos personalizados, você desbloqueará a página Explorar do painel de Análises no Creator Hub. Você pode adicionar até 100 eventos personalizados ao seu jogo.

Rastrear eventos personalizados

Para desbloquear a página Explorar, você deve primeiro rastrear eventos personalizados no seu jogo. Comece identificando quais métricas são mais importantes para monitorar e melhorar seu jogo. Os eventos são agregados diariamente, então pode levar até 24 horas para que os gráficos sejam preenchidos na página.

Contadores

Contadores são eventos únicos capturados sem um valor. Você pode usar contadores para rastrear o número de vezes que um evento específico ocorreu. Use contadores para ações únicas, como clicar em um botão, iniciar uma missão ou usar uma ferramenta.

Os eventos rastrearão automaticamente tanto a contagem de eventos quanto a contagem de usuários únicos. Para agregações de valores, os eventos de contador são tratados como eventos com um valor padrão de 1. Isso significa que agregações como máximo/mínimo/média sempre serão iguais a 1, e a soma será igual ao número total de eventos.


local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogCustomEvent(
player,
"MissãoIniciada" -- Nome do evento
)

Eventos com valores

Você também pode rastrear eventos com valores para métricas que requerem dados mais quantitativos no seu jogo, como taxas de morte/morte ou a quantidade de tempo que um usuário passa em uma missão. Isso também pode ser usado como uma maneira de enviar eventos em lotes para se manter abaixo dos limites de taxa, ou seja, enviar 10 zumbis mortos em vez de 1 zumbi morto dez vezes.


local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogCustomEvent(
player,
"DuraçãoMissãoConcluída", -- Nome do evento
120 -- Valor do evento
)

Agregações de eventos

Todas as métricas de eventos incluem as seguintes agregações e suporte a divisão:

  • Contagem
  • Contagem de usuários únicos
  • Valor médio
  • Soma de valores
  • Valor mínimo
  • Valor máximo
  • Valor médio por usuário

Visualize suas agregações de eventos na página Explorar selecionando o tipo de agregação.

Uma lista de todas as diferentes opções de agregação para filtrar seus dados de eventos personalizados.

Usar campos personalizados

Eventos personalizados também permitem a quebra em campos personalizados para suportar comparações mais fáceis entre segmentos. Por exemplo, você pode fornecer nomes de missões a cada evento para ver quais os usuários preferem mais, ou anexar a classe do jogador para ver se uma classe tem uma taxa de morte/morte significativamente maior.

Você pode fazer a quebra por campos personalizados usando o seletor de quebra.

Um dropdown indicando os três campos personalizados que você pode comparar, junto com quebras padrões como idade, gênero, sistema operacional e mais.

Você deve usar campos personalizados sempre que possível em vez de nomes de eventos, já que há um limite de cardinalidade muito mais rigoroso em nomes de eventos do que em campos personalizados. Usar campos personalizados também permite que você veja visualizações de eventos através dos valores dos campos.

Por exemplo, em vez de PlantarRepolho, PlantarNabo, PlantarPimenta como três eventos separados, você pode ter um único evento com o nome PlantarSemente e valores de campo personalizados Plantar - Repolho, Plantar - Nabo, e Plantar - Pimenta. Dessa forma, você pode visualizar tanto o número total de sementes plantadas quanto comparar cada planta na mesma visualização. Isso também reduz sua cardinalidade de nomes de eventos.

Para mais informações, veja Campos personalizados.

Usar eventos personalizados para crescer seu jogo

Eventos personalizados permitem que você rastreie métricas que mais importam, fornecendo insights sobre como os jogadores interagem com recursos e conteúdos específicos. Use esses eventos para descobrir padrões no comportamento dos jogadores e otimizar seu ciclo principal de jogo.

No jogo de referência Plantar, o ciclo principal com um evento ColherPlanta é acionado sempre que um jogador colhe uma planta madura. Usando eventos personalizados, você pode rastrear a média de plantas colhidas por jogador a cada dia, detalhada por tipo de planta como um campo personalizado:

Gráfico de Evento Personalizado para o jogo de referência Plantar.
  • Tente melhorar a diversidade de conteúdo dentro do seu jogo e incentive os jogadores a explorar outras opções como parte do ciclo principal para evitar repetição.
  • Explore por que os usuários preferem significativamente nabos em relação a outras plantas, e se há algum desequilíbrio que os nabos estão causando (como eventos de economia).
  • Adicione mais rastreamento de eventos dentro do seu ciclo, como plantar sementes, regar plantas e ir à loja, para rastrear melhor o comportamento do jogador e outras áreas de melhoria.
©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.