Eventos de economia

Eventos de economia permitem que você rastreie a economia do seu jogo, como:

• Principais gastos — Em que os usuários gastam recursos do jogo?
• Principais fontes — Onde os usuários ganham recursos?
• Saldo médio da carteira — Quantos recursos os usuários estão segurando?

Uma vez que seu jogo comece a rastrear eventos de economia, você desbloqueará a página de Economia do painel de Análises no Creator Hub.

Rastrear eventos de economia

Para desbloquear o painel de Economia, você precisa rastrear alguns eventos de economia no seu jogo. Comece identificando onde os usuários sourcem (ou seja, ganham) e gastam (ou seja, usam) recursos no seu jogo. Esses eventos são representados no código por Enum.AnalyticsEconomyFlowType, que pode ser Source ou Sink.

Tipos de transação

Cada evento de fonte e gasto requer um tipo de transação, codificado com Enum.AnalyticsEconomyTransactionType. Por padrão, as opções são:

• IAP (fonte) - Compras dentro do aplicativo trocando Robux por recursos, por exemplo, pacote inicial.
• TimedReward (fonte) - Ganhar recursos em um cronograma, por exemplo, bônus diário.
• Onboarding (fonte) - Obter recursos ao começar, por exemplo, bônus de boas-vindas.
• Shop (fonte ou gasto) - Trocar recursos na loja, por exemplo, compra de item.
• Gameplay (fonte ou gasto) - Ganhar ou gastar recursos a partir do gameplay, por exemplo, conclusão de missão.
• ContextualPurchase (gasto) - Gastar recursos em um impulso específico de contexto, por exemplo, vidas extras.

Esses tipos aparecem no painel. É uma boa ideia começar com as categorias padrão, mas se necessário, você também pode fornecer seus próprios nomes de tipos de transação ao registrar um evento.

Rastrear fontes

O seguinte exemplo usa AnalyticsService.LogEconomyEvent para registrar dois eventos de economia diferentes quando os usuários completam o primeiro e o segundo níveis do jogo e ganham algumas moedas.

local AnalyticsService = game:GetService("AnalyticsService")

-- Após a conclusão do nível 1
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins", -- Nome da moeda
    50, -- Quantidade ganha
    50, -- Saldo atual
    Enum.AnalyticsEconomyTransactionType.Gameplay.Name -- Tipo de transação
)

-- Após a conclusão do nível 2
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins", -- Nome da moeda
    50, -- Quantidade ganha
    100, -- Saldo após a transação
    Enum.AnalyticsEconomyTransactionType.Gameplay.Name -- Tipo de transação
)

O seguinte exemplo rastreia uma compra de Robux de um pacote de 1000 moedas, usando o tipo de transação IAP (compra dentro do aplicativo), desta vez com um itemSKU, seu identificador único para o item. itemSKU é opcional. Se você não especificá-lo, os painéis de Economia exibirão N/A na tabela de fontes e gastos.

local AnalyticsService = game:GetService("AnalyticsService")

AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins",
    1000, -- Quantas moedas estão no pacote
    1020, -- Saldo após a transação
    Enum.AnalyticsEconomyTransactionType.IAP.Name,
    "1000CoinBundle" -- Identificador único SKU do item do pacote de moedas
)

Neste exemplo, se você tiver muitos pacotes de moedas, pode também querer adicionar um campo personalizado para rastrear a categoria do pacote de moedas em relação a outras categorias.

Rastrear gastos

O seguinte exemplo registra um evento quando os usuários gastam moedas para comprar um DoubleJumpUpgrade. Note o tipo de fluxo Sink e o tipo de transação Shop em comparação com os exemplos de rastreamento de fonte.

Lembre-se de que a quantidade (custo) deve sempre ser um número positivo, independentemente de o evento ser uma fonte ou um gasto. Os gráficos do painel de economia mostrarão automaticamente os gastos como números negativos.

local AnalyticsService = game:GetService("AnalyticsService")

-- Após a conclusão do nível 2
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Sink,
    "Coins", -- Nome da moeda
    80, -- Custo
    20, -- Saldo após a transação
    Enum.AnalyticsEconomyTransactionType.Shop.Name,
    "DoubleJumpUpgrade" -- SKU do item
)

Para informações sobre as limitações de AnalyticsService, veja Limitações de rastreamento de eventos.

Usar campos personalizados

Eventos de economia também permitem a segmentação em campos personalizados para facilitar a comparação entre segmentos. Por exemplo, você pode fornecer nomes de missões para cada evento para ver quais estão gerando mais dinheiro para os usuários, ou anexar locais de loja para ver se os usuários preferem um local em relação a outro.

Você pode segmentar por campos personalizados usando o seletor de segmentação.

Para mais informações, veja Campos personalizados.

Usar a economia para crescer seu jogo

O painel de Economia inclui cinco gráficos para ajudá-lo a tomar medidas para aumentar sua receita. Você pode adicionar até cinco moedas de recursos, e todos os gráficos podem ser filtrados por várias categorias de usuários (gênero, idade, plataforma, etc.) e até três campos personalizados específicos para o seu jogo.

• Total de fontes e gastos por categoria - Use este gráfico para equilibrar a economia do seu jogo. O total de fontes menos o total de gastos deve estar próximo de zero. Você também pode ver suas principais fontes e gastos por categoria. Se seu total líquido estiver crescendo, considere adicionar mais gastos.

  

• Saldo médio da carteira - Use este gráfico para ver quantos recursos os usuários, pagadores e não pagadores possuem em média. Se o saldo médio estiver crescendo, especialmente para pagadores, considere adicionar novos gastos.

  

• Principais fontes e gastos - Use isso para identificar onde seus usuários ganham e gastam seus recursos. Se os usuários não estão obtendo recursos de compras dentro do aplicativo, considere reduzir preços ou oferecer novas opções. Se os usuários não estão gastando o suficiente de um determinado recurso, considere adicionar novos gastos para esse recurso.

  

• Todas as fontes e gastos - Use isso para obter uma visão combinada por categoria para o intervalo de datas selecionado.

  

Para mais dicas sobre como equilibrar a economia dentro da sua experiência, veja Equilibrar economias virtuais.