Eventos Econômicos

Os eventos de economia permitem que você rastreie sua economia na experiência, como:

• Top sinks Em que os usuários gastam recursos na experiência?
• Principais fontes Onde os usuários ganham recursos?
• Saldo médio da carteira Quantos recursos os usuários estão segurando?

Quando sua experiência começar a rastrear eventos de Economia, você desbloqueará a página de Economia do painel de Análises no Hub do Criador.

Acompanhando Eventos Econômicos

Para desbloquear o painel de economia, você precisa rastrear alguns eventos econômicos em sua experiência. Comece identificando onde os usuários geram (ou seja, ganham) e drenam (ou seja, gastam) recursos em sua experiência. Estes são representados em código por Enum.AnalyticsEconomyFlowType , que pode ser Source ou Sink .

Tipos de transação

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

• IAP (original) - Compras no aplicativo trocando Robux por recursos, por exemplo, pacote inicial.
• TimedReward (original) - Ganhe recursos em um cronograma, por exemplo, bônus diário.
• Onboarding (original) - Obtenha recursos ao começar, por exemplo, bônus de boas-vindas.
• Shop (fonte ou pia) - Troque recursos na comprar, por exemplo, comprarde itens.
• Gameplay (fonte ou pia) - Ganhe ou gaste recursos da jogabilidade, por exemplo, completar a missão.
• ContextualPurchase (sink) - Gaste recursos em um impulso específico do contexto, por exemplo, vidas extras.

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

Fontes de rastreamento

O exemplo a seguir usa AnalyticsService.LogEconomyEvent para registrar dois eventos econômicos diferentes quando os usuários completam o primeiro e o segundo níveis da experiência e ganham algumas moedas.

Rastreando um evento de Gameplay de origem
local AnalyticsService = game:GetService("AnalyticsService")
local Players = game:GetService("Players")
local currentPlayer = Players.LocalPlayer

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

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

O exemplo a seguir rastreia uma compra de Robux de um pacote de 1000 moedas, usando o digitarde transação IAP (comprarno aplicativo). O campo itemSKU é um parâmetro opcional adicionado aqui para comparar com a amostra anterior. Se você não especificar um itemSKU, os dashboards de Economia exibem N/A na tabela de fontes e sinks.

Rastreando uma comprarno aplicativo
local AnalyticsService = game:GetService("AnalyticsService")
local Players = game:GetService("Players")
local currentPlayer = Players.LocalPlayer

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

Sink de Rastreamento

O exemplo a seguir registra um evento quando os usuários gastam moedas para comprar um DoubleJumpUpgrade . Observe o Sink tipo de fluxo e o Shop tipo de transação quando comparado às amostras de rastreamento de fonte.

Tenha em mente que o valor (coste) deve sempre ser um número positivo, independentemente de o evento ser uma fonte ou uma pia. Os gráficos do painel de economia mostrarão automaticamente as pia como números negativos.

Rastreando um evento de Gameplay de pia
local AnalyticsService = game:GetService("AnalyticsService")
local Players = game:GetService("Players")
local currentPlayer = Players.LocalPlayer

-- Após a conclusão do nível 2
AnalyticsService:LogEconomyEvent(
    currentPlayer,
    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 obter informações sobre AnalyticsService limitações, consulte limitações de rastreamento de eventos.

Usando a economia para aumentar sua experiência

O painel Economia inclui cinco gráficos para ajudar você a tomar medidas para aumentar sua receita. Você pode adicionar até cinco moedas de recursos e todos os gráficos podem ser filtrados por gênero, faixa de grupo, plataforma, sistema operacional e até três campos personalizados específicos da sua experiência.

• Total de fontes e pias por categoria - Use este gráfico para equilibrar sua economia na experiência. As fontes totais menos as pias totais devem estar próximas de zero. Você também pode ver suas principais fontes e pias por categoria. Se o seu total líquido estiver crescendo, considere adicionar mais pias.

  

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

  

• Principais fontes e sumidouros - 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 no aplicativo, considere reduzir os 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 sumidouros para esse recurso.

  

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

  

Para mais dicas sobre como equilibrar sua economia na experiência, veja Balanceando Economias Virtuais .