Eventi economici

Eventi economici ti permettono di tracciare l'economia del tuo gioco, come ad esempio:

• Punti di spesa principali — Su cosa spendono le risorse in-game gli utenti?
• Fonti principali — Dove guadagnano risorse gli utenti?
• Saldo medio del portafoglio — Quante risorse possiedono gli utenti?

Una volta che il tuo gioco inizia a tracciare gli eventi economici, sbloccherai la pagina Economia del pannello Analytics nel Creator Hub.

Traccia eventi economici

Per sbloccare il pannello Economia, è necessario tracciare alcuni eventi economici nel tuo gioco. Inizia identificando dove gli utenti ottengono (ossia guadagnano) e spendono (ossia consumano) risorse nel tuo gioco. Questi sono rappresentati nel codice da Enum.AnalyticsEconomyFlowType, che può essere Source o Sink.

Tipi di transazione

Ogni evento fonte e punto di spesa richiede un tipo di transazione, codificato con Enum.AnalyticsEconomyTransactionType. Per impostazione predefinita, le opzioni sono:

• IAP (fonte) - Acquisti in-app che scambiano Robux per risorse, ad esempio pacco iniziale.
• TimedReward (fonte) - Guadagna risorse in base a un programma, ad esempio bonus giornaliero.
• Onboarding (fonte) - Ottieni risorse quando inizi, ad esempio bonus di benvenuto.
• Shop (fonte o punto di spesa) - Scambia risorse nel negozio, ad esempio acquisto di un oggetto.
• Gameplay (fonte o punto di spesa) - Guadagna o spendi risorse dal gameplay, ad esempio completamento di una missione.
• ContextualPurchase (punto di spesa) - Spendi risorse per un impulso specifico del contesto, ad esempio vite extra.

Questi tipi appaiono nel pannello. È una buona idea partire dalle categorie predefinite, ma se necessario puoi anche fornire i tuoi nomi di tipo di transazione quando registri un evento.

Traccia fonti

Il seguente esempio utilizza AnalyticsService.LogEconomyEvent per registrare due diversi eventi economici quando gli utenti completano il primo e il secondo livello del gioco e guadagnano alcune monete.

Tracciamento di un evento Gameplay fonte
local AnalyticsService = game:GetService("AnalyticsService")

-- Dopo il completamento del livello 1
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Monete", -- Nome della valuta
    50, -- Importo guadagnato
    50, -- Saldo attuale
    Enum.AnalyticsEconomyTransactionType.Gameplay.Name -- Tipo di transazione
)

-- Dopo il completamento del livello 2
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Monete", -- Nome della valuta
    50, -- Importo guadagnato
    100, -- Saldo dopo la transazione
    Enum.AnalyticsEconomyTransactionType.Gameplay.Name -- Tipo di transazione
)

Il seguente esempio traccia un acquisto di Robux di un pacchetto da 1000 monete, utilizzando il tipo di transazione IAP (acquisto in-app), questa volta con un itemSKU, il tuo identificatore unico per l'oggetto. itemSKU è facoltativo. Se non lo specifichi, i pannelli sulle economie mostreranno N/A nella tabella delle fonti e dei punti di spesa.

Tracciamento di un acquisto in-app
local AnalyticsService = game:GetService("AnalyticsService")

AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Monete",
    1000, -- Quante monete ci sono nel pacchetto
    1020, -- Saldo dopo la transazione
    Enum.AnalyticsEconomyTransactionType.IAP.Name,
    "1000CoinBundle" -- Identificatore SKU unico del pacchetto di monete
)

In questo esempio, se hai molti pacchetti di monete, potrebbe essere utile aggiungere un campo personalizzato per tracciare la categoria del pacchetto di monete rispetto ad altre categorie.

Traccia punti di spesa

Il seguente esempio registra un evento quando gli utenti spendono monete per acquistare un DoubleJumpUpgrade. Nota il tipo di flusso Sink e il tipo di transazione Shop rispetto agli esempi di tracciamento delle fonti.

Tieni presente che l'importo (costo) deve sempre essere un numero positivo, indipendentemente dal fatto che l'evento sia una fonte o un punto di spesa. I diagrammi del pannello economico mostreranno automaticamente i punti di spesa come numeri negativi.

Tracciamento di un evento Gameplay punto di spesa
local AnalyticsService = game:GetService("AnalyticsService")

-- Dopo il completamento del livello 2
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Sink,
    "Monete", -- Nome della valuta
    80, -- Costo
    20, -- Saldo dopo la transazione
    Enum.AnalyticsEconomyTransactionType.Shop.Name,
    "DoubleJumpUpgrade" -- SKU dell'oggetto
)

Per informazioni sulle limitazioni di AnalyticsService, consulta Limitazioni del tracciamento degli eventi.

Usa campi personalizzati

Gli eventi economici consentono anche di suddividere sui campi personalizzati per supportare un confronto più semplice tra segmenti. Ad esempio, puoi fornire nomi di missioni per ogni evento per vedere quali consentono agli utenti di guadagnare di più, oppure allegare posizioni del negozio per vedere se gli utenti preferiscono una posizione rispetto a un'altra.

Puoi suddividere per campi personalizzati utilizzando il selettore di suddivisione.

Per ulteriori informazioni, consulta Campi personalizzati.

Usa l'economia per far crescere il tuo gioco

Il pannello Economia include cinque grafici che ti aiuteranno a intraprendere azioni per far crescere le tue entrate. Puoi aggiungere fino a cinque valute di risorse e tutti i grafici possono essere filtrati da varie categorie di utenti (genere, età, piattaforma, ecc.) e fino a tre campi personalizzati specifici per il tuo gioco.

• Fonti e punti di spesa totali per categoria - Usa questo grafico per bilanciare l'economia del tuo gioco. La somma totale delle fonti meno i punti di spesa totali dovrebbe essere vicina a zero. Puoi anche vedere le tue principali fonti e punti di spesa per categoria. Se il tuo totale netto sta crescendo, considera di aggiungere più punti di spesa.

  

• Saldo medio del portafoglio - Usa questo grafico per vedere quante risorse hanno in media gli utenti, i pagatori e i non pagatori. Se il saldo medio cresce, in particolare per i pagatori, considera di aggiungere nuovi punti di spesa.

  

• Fonti e punti di spesa principali - Usa questo per identificare dove i tuoi utenti guadagnano e spendono le loro risorse. Se gli utenti non stanno guadagnando risorse dagli acquisti in-app, considera di ridurre i prezzi o di offrire nuove opzioni. Se gli utenti non spendono abbastanza di una determinata risorsa, considera di aggiungere nuovi punti di spesa per quella risorsa.

  

• Tutte le fonti e i punti di spesa - Usa questo per ottenere una visione combinata per categoria per l'intervallo di date selezionato.