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/tentativadi 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/tentativadi livello.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Registra un evento per quando un utente ha fallito un tentativo/tentativadi livello.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Registra un evento quando un utente ha iniziato un tentativo/tentativadi 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 inserisci / scrividi 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
The following sample tracks a Robux purchase of a 1000-coin bundle, using the IAP (in-app purchase) transaction type. Note the item name provided as an optional parameter when compared to the previous sample.
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"Coins",
1000, -- How many coins are in the bundle
1020, -- balance after transaction
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- Unique identifier of the coin bundle
)
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 Sessionedi 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 Sessionedel 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 Sessionedi 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
The following sample tracks some basic events for each user beginning the process to buy an item from an "armory" shop. Note the funnelSessionId used to distinguish between different sessions of the same user opening the shop.
local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
funnelSessionId = HttpService:GenerateGUID()
-- Log when the user opens the store
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Funnel name used to group steps together
funnelSessionId, -- Funnel session id for this unique checkout session
1, -- Step number
"Opened Store" -- Step name
)
-- Log when the user views an item
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Funnel name used to group steps together
funnelSessionId, -- Funnel session id for this unique checkout session
2, -- Step number
"Viewed Item" -- Step name
)
-- Log when the user views adds to cart
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Funnel name used to group steps together
funnelSessionId, -- Funnel session id for this unique checkout session
3, -- Step number
"Added to Cart" -- Step name
)
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 Sessionedi 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
The following sample demonstrates how to log two steps of an onboarding funnel. An onboarding funnel typically introduces players to the game's core loop.
local AnalyticsService = game:GetService("AnalyticsService")
-- Log the first step of the FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- Step number
"Joined Game" -- Step name
)
-- Log the second step of the FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- Step number
"Choose Class" -- Step name
)
LogProgressionCompleteEvent
Registra un evento per quando un utente ha completato un tentativo/tentativadi 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/tentativadi 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/tentativadi 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/tentativadi livello. Questo evento non viene attualmente visualizzato in nessuna tabella fornita da Roblox.
Parametri
Il giocatore che ha triggerato l'evento.