Campos personalizados

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

Você pode usar até três campos personalizados para filtrar seus eventos de economia, funil e personalizados por dimensões únicas específicas para o seu jogo. Alguns exemplos incluem:

  • Níveis — 1, 2, 3, . . .
  • Classe de jogador — Guerreiro, Mago, Arqueiro
  • Tipo de arma — SMG, Pistola, Lança-Rocket

O parâmetro customFields é um dicionário que permite enviar até três valores personalizados usando os Enum.AnalyticsCustomFieldKeys fornecidos como chaves, acessando-os como Enum.AnalyticsCustomFieldKeys.CustomField{01, 02, 03}.Name. Qualquer coisa diferente de CustomField01.Name, CustomField02.Name e CustomField03.Name é ignorada. Você pode ter até 8.000 combinações únicas de valores através dos três campos personalizados.

Usando um jogo relacionado a fantasia como exemplo, você pode rastrear um evento de economia relacionado ao tipo de equipamento, classe de jogador e nível com o seguinte:

Rastreando Campos Personalizados

local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Sink,
"Moedas", -- Nome da moeda
80, -- Custo
20, -- Saldo após a transação
Enum.AnalyticsEconomyTransactionType.Shop.Name,
"Espada de Obsidiana", -- SKU do item
{
[Enum.AnalyticsCustomFieldKeys.CustomField01.Name] = "Categoria - Arma",
[Enum.AnalyticsCustomFieldKeys.CustomField02.Name] = "Classe - Guerreiro",
[Enum.AnalyticsCustomFieldKeys.CustomField03.Name] = "Nível - 10",
} -- Dicionário de campos personalizados
)

Incluir o nome da dimensão no valor não é obrigatório, mas pode ajudar você a lembrar o contexto mais tarde ao revisar seus gráficos. Outras chaves na tabela customFields são ignoradas.

©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.