AnalyticsService
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
AnalyticsService è una raccolta di metodi che consente agli sviluppatori di tracciare come gli utenti interagiscono con le loro esperienze, in particolare la progressione del giocatore, l'economia in-experience, i funnel e gli eventi personalizzati.
Sommario
Proprietà
Metodi
Registra un evento utilizzato per tracciare le metriche personalizzate di un utente in esperienza.
- LogEconomyEvent(player : Player,flowType : Enum.AnalyticsEconomyFlowType,currencyType : string,amount : number,endingBalance : number,transactionType : string,itemSku : string,customFields : Dictionary):()
Registra un evento utilizzato per tracciare le azioni del giocatore relative all'esperienza.
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):()
Registra un evento utilizzato per tracciare le azioni dell'utente che passano attraverso un funnel pre-pianificato.
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):()
Registra un evento utilizzato per tracciare le azioni dell'utente che passa attraverso un funnel di onboarding.
- LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Registra un evento quando un utente ha completato un tentativo di livello.
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):()
Registra un evento quando un utente ha iniziato, completato o fallito un tentativo di livello.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Registra un evento per quando un utente ha fallito un tentativo di livello.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Registra un evento quando un utente ha iniziato un tentativo di livello.
Proprietà
Metodi
LogCustomEvent
Registra un evento utilizzato per tracciare le metriche personalizzate di un utente in esperienza. Per ulteriori informazioni, vedi Eventi personalizzati.
Parametri
L'utente che ha attivato l'evento.
Il nome dell'evento personalizzato.
Il valore dell'evento che verrà utilizzato in aggregazione.
Dizionario opzionale di campi personalizzati che fornirà ripartizioni nelle chart fornite da Roblox.Solo chiavi specifiche, fornite da Enum.AnalyticsCustomFieldKeys , verranno utilizzate per questi riepiloghi.Limitato a 8.000 combinazioni uniche di valori attraverso i tre campi personalizzati per esperienza.
Restituzioni
Campioni di codice
This example uses AnalyticsService:LogCustomEvent() to log two custom events: MissionStarted and MissionCompletedDuration.
local AnalyticsService = game:GetService("AnalyticsService")
-- Log when the mission starts
AnalyticsService:LogCustomEvent(
player,
"MissionStarted" -- Custom event name
)
-- Log when the mission is completed with the time it took
AnalyticsService:LogCustomEvent(
player,
"MissionCompletedDuration", -- Custom event name
120 -- Event value used in aggregation
)LogEconomyEvent
Registra un evento utilizzato per tracciare le azioni del giocatore relative all'esperienza.
Parametri
L'utente che ha attivato l'evento.
Dovrebbe specificare la direzione in cui il valuta fluisce utilizzando Enum.AnalyticsEconomyFlowType .
Il nome della valuta aggiunta o rimossa, ad esempio "gold" , "gems" , o "energy" .Limitato a 5 tipi di valuta unici per esperienza.
La quantità di valuta aggiunta o rimossa. Questo valore dovrebbe essere sempre positivo.
L'equilibrio dell'utente dopo che è stata aggiunta o rimossa la valuta. Questo valore dovrebbe essere sempre maggiore o uguale a 0.
Il tipo di transazione che si è verificata.Mentre sei libero di utilizzare qualsiasi tipo di transazione, è consigliato utilizzare i tipi forniti da Enum.AnalyticsEconomyTransactionType come "IAP" o "ContextualPurchase" per abilitare future analisi degli strumenti e delle chart di Roblox.
Poiché questo tipo di campo è una stringa, dovrai passare il valore Name dell'enumero. Ad esempio Enum.AnalyticsEconomyTransactionType.IAP.Name.
Limitato a 20 tipi unici per esperienza.
SKU opzionale dell'articolo o del pacchetto acquistato.Questo è un identificatore univoco per l'articolo acquistato.Limitato a 100 SKU unici per esperienza.
Dizionario opzionale di campi personalizzati che fornirà ripartizioni nelle chart fornite da Roblox.Solo chiavi specifiche, fornite da Enum.AnalyticsCustomFieldKeys , verranno utilizzate per questi riepiloghi.Limitato a 8.000 combinazioni uniche di valori attraverso i tre campi personalizzati per esperienza.
Restituzioni
Campioni di codice
Il seguente esempio traccia un acquisto di Robux di un pacchetto di 1000 monete, utilizzando il tipo di transazione IAP (acquisto in-app).Nota il nome dell'elemento fornito come parametro opzionale rispetto al precedente campione.
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"Coins",
1000, -- Quante monete ci sono nel pacchetto
1020, -- equilibrio dopo la transazione
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- Identificatore univoco del pacchetto di monete
)LogFunnelStepEvent
Registra un evento utilizzato per tracciare le azioni dell'utente che passano attraverso un funnel pre-pianificato.Le interruzioni del flusso considereranno solo i valori utente e evento del primo passo in una sessione di flusso.
Parametri
L'utente che ha attivato l'evento.
Il nome del funnel. Questo dovrebbe essere lo stesso per tutti i passi nel funnel. Limitato a 10 funnel unici per esperienza.
Identificatore univoco opzionale per la sessione del funnel. Questo dovrebbe essere lo stesso per tutti i passaggi nel funnel.
Nota che questo campo è necessario solo per ricorrenti flussi, ad esempio un flusso di acquisto o un flusso di aggiornamento dell'articolo.Se non hai un identificatore di sessione del funnel naturale, è consigliato utilizzare HttpService:GenerateGUID() .
Il numero di passo nella funzione. Questo dovrebbe essere unico per ogni passo nella funzione. Tutte le funzioni iniziano al passo 1. Limitato ai passi 1-100.
Passaggi ripetuti dallo stesso utente nella stessa sessione di funnel, o quando funnelSessionId è nil verranno ignorati.
Si noti che se vengono saltati dei passaggi, i passaggi intermedi saranno considerati completati.
Nome opzionale dello step nella funzione. Questo campo viene utilizzato solo per scopi di visualizzazione nelle chart fornite da Roblox.
Dizionario opzionale di campi personalizzati che fornirà ripartizioni nelle chart fornite da Roblox.Solo chiavi specifiche, fornite da Enum.AnalyticsCustomFieldKeys , verranno utilizzate per questi riepiloghi.Limitato a 8.000 combinazioni uniche di valori attraverso i tre campi personalizzati per esperienza.
Restituzioni
Campioni di codice
Il seguente esempio traccia alcuni eventi di base per ogni utente che inizia il processo di acquisto di un oggetto da un negozio "armory".Nota l'ID sessione funnel utilizzato per distinguere tra diverse sessioni dello stesso utente che apre il negozio.
local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
funnelSessionId = HttpService:GenerateGUID()
-- Registra quando l'utente apre il negozio
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Nome del funnel utilizzato per raggruppare i passaggi insieme
funnelSessionId, -- ID sessione del funnel per questa sessione di checkout unica
1, -- Numero del passo
"Opened Store" -- Nome del passo
)
-- Registra quando l'utente visualizza un oggetto
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Nome del funnel utilizzato per raggruppare i passaggi insieme
funnelSessionId, -- ID sessione del funnel per questa sessione di checkout unica
2, -- Numero del passo
"Viewed Item" -- Nome del passo
)
-- Registra quando l'utente visualizza aggiunge al carrello
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Nome del funnel utilizzato per raggruppare i passaggi insieme
funnelSessionId, -- ID sessione del funnel per questa sessione di checkout unica
3, -- Numero del passo
"Added to Cart" -- Nome del passo
)LogOnboardingFunnelStepEvent
Registra un evento utilizzato per tracciare le azioni dell'utente che passa attraverso un funnel di onboarding.Le interruzioni del flusso considereranno solo i valori utente e evento del primo passo in una sessione di flusso.
Parametri
L'utente che ha attivato l'evento.
Il numero di passo nella funzione. Questo dovrebbe essere unico per ogni passo nella funzione. Tutte le funzioni iniziano al passo 1. Limitato ai passi 1-100.
Si noti che se vengono saltati dei passaggi, i passaggi intermedi saranno considerati completati.
Nome opzionale dello step nella funzione. Questo campo viene utilizzato solo per scopi di visualizzazione nelle chart fornite da Roblox.
Dizionario opzionale di campi personalizzati che fornirà ripartizioni nelle chart fornite da Roblox.Solo chiavi specifiche, fornite da Enum.AnalyticsCustomFieldKeys , verranno utilizzate per questi riepiloghi.Limitato a 8.000 combinazioni uniche di valori attraverso i tre campi personalizzati per esperienza.
Restituzioni
Campioni di codice
L'esempio seguente mostra come registrare due passaggi di un funnel di onboarding.Un funnel di onboarding introduce di solito i giocatori al ciclo principale del gioco.
local AnalyticsService = game:GetService("AnalyticsService")
-- Registra il primo passo del FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- Numero del passo
"Joined Game" -- Nome del passo
)
-- Registra il secondo passo del FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- Numero del passo
"Choose Class" -- Nome del passo
)LogProgressionCompleteEvent
Registra un evento per quando un utente ha completato un tentativo di livello. Questo evento non viene attualmente visualizzato in nessuna tabella fornita da Roblox.
Parametri
Il giocatore che ha triggerato l'evento.
Restituzioni
LogProgressionEvent
Registra un evento quando un utente ha iniziato, completato o fallito un tentativo di livello. Questo evento non viene attualmente visualizzato in nessuna tabella fornita da Roblox.
Parametri
Il giocatore che ha triggerato l'evento.
Restituzioni
LogProgressionFailEvent
Registra un evento per quando un utente ha fallito un tentativo di livello. Questo evento non viene attualmente visualizzato in nessuna tabella fornita da Roblox.
Parametri
L'utente che ha attivato l'evento.
Restituzioni
LogProgressionStartEvent
Registra un evento per quando un utente ha iniziato un tentativo di livello. Questo evento non viene attualmente visualizzato in nessuna tabella fornita da Roblox.
Parametri
Il giocatore che ha triggerato l'evento.