AnalyticsService
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
AnalyticsService è una collezione di metodi che consente agli sviluppatori di tracciare in che modo gli utenti interagiscono con le loro esperienze, in particolare la progressione degli utenti, l'economia in-experience, i funnel e gli eventi personalizzati.
Sommario
Proprietà
Metodi
Raccoglie un evento utilizzato per tracciare le metriche personalizzate di un utente nell'esperienza.
- LogEconomyEvent(player : Player,flowType : Enum.AnalyticsEconomyFlowType,currencyType : string,amount : number,endingBalance : number,transactionType : string,itemSku : string,customFields : Dictionary):void
Raccoglie un evento utilizzato per tracciare azioni del giocatore in relazione all'esperienza.
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):void
Registra un evento utilizzato per tracciare le azioni dell'utente che passa attraverso un funnel pre-planificato.
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):void
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):void
Registra un evento per quando un utente ha completato un tentativo/tentativadi livello.
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):void
Registra un evento per quando un utente ha iniziato, completato o fallito un tentativo/tentativadi livello.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Registra un evento per quando un utente ha fallito un tentativo/tentativadi livello.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Registra un evento per quando un utente ha iniziato un tentativo/tentativadi livello.
Proprietà
Metodi
LogCustomEvent
Logga un evento utilizzato per tracciare le metriche personalizzate di un utente nell'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 nell'aggregazione.
Dizionario opzionale di campi personalizzati che forniranno delle spiegazioni nei grafici forniti da Roblox. Solo le chiavi specifiche, fornite da Enum.AnalyticsCustomFieldKeys, saranno utilizzate per queste spiegazioni. Limitato a 8.000 combinazioni di valori 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
Raccoglie un evento utilizzato per tracciare azioni del giocatore in relazione all'esperienza.
Parametri
L'utente che ha attivato l'evento.
Dovrebbe specificare la direzione in cui si muove la valuta utilizzando Enum.AnalyticsEconomyFlowType .
Il nome della valuta che viene 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 sempre essere positivo.
L'importo dell'utente dopo che è stato aggiunto o rimosso la valuta. Questo valore dovrebbe sempre essere maggiore o uguale a 0.
Il tipo di transazione che si è verificato. Mentre sei libero di utilizzare qualsiasi inserisci / scrividi transazione, è consigliato utilizzare i tipi forniti da Enum.AnalyticsEconomyTransactionType come "IAP" o "ContextualPurchase" per abilitare future informazioni dalle strumentazioni e dalle mappe Roblox.
Poiché questo tipo di campo è una Stringa, dovrai passare il valore Name dell'enum. Ad esempio Enum.AnalyticsEconomyTransactionType.IAP.Name .
Limitato a 20 tipi unici per esperienza.
ID opzionale dell'elemento o del pacchetto che viene acquistato. Questo è un identificatore unico per l'elemento che viene acquistato. Limitato a 100 ID unici per esperienza.
Dizionario opzionale di campi personalizzati che forniranno delle spiegazioni nei grafici forniti da Roblox. Solo le chiavi specifiche, fornite da Enum.AnalyticsCustomFieldKeys, saranno utilizzate per queste spiegazioni. Limitato a 8.000 combinazioni di valori 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
Logga un evento utilizzato per tracciare le azioni dell'utente che passa attraverso un funnel pre-planificato. Le analisi dei funnel downgrade considereranno solo i valori dell'utente e dell'evento dalla prima fase in una Sessionefunnel.
Parametri
L'utente che ha attivato l'evento.
Il nome del funnel. Questo dovrebbe essere lo stesso per tutti gli step nel funnel. Limitato a 10 funnel unici per esperienza.
Identificatore unico opzionale per la Sessionedella funzione. Questo dovrebbe essere lo stesso per tutti gli step nella funzione.
Nota che questo campo è solo necessario per i funnel ricorsivi , ad esempio un funnel di acquisto o un funnel di aggiornamento di un oggetto. Se non hai un identificatore di sessione naturale, è consigliato utilizzare HttpService:GenerateGUID() .
Il numero di passo nella funzione. Questo dovrebbe essere unico per ciascun 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 saranno ignorati.
Nota che se qualche passaggio viene saltato, i passaggi intermedi saranno considerati completati.
Nome opzionale della fase nel funnel. Questo campo viene utilizzato solo per scopi di visualizzazione in Roblox-provided chart.
Dizionario opzionale di campi personalizzati che forniranno delle spiegazioni nei grafici forniti da Roblox. Solo le chiavi specifiche, fornite da Enum.AnalyticsCustomFieldKeys, saranno utilizzate per queste spiegazioni. Limitato a 8.000 combinazioni di valori 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
Logga un evento utilizzato per tracciare le azioni dell'utente che passa attraverso un funnel di integrazione. Le rilevazioni dei funnel down si baseranno solo sulle valutazioni dell'utente e dell'evento dalla prima fase in una Sessionefunnel.
Parametri
L'utente che ha attivato l'evento.
Il numero di passo nella funzione. Questo dovrebbe essere unico per ciascun passo nella funzione. Tutte le funzioni iniziano al passo 1. Limitato ai passi 1-100.
Nota che se qualche passaggio viene saltato, i passaggi intermedi saranno considerati completati.
Nome opzionale della fase nel funnel. Questo campo viene utilizzato solo per scopi di visualizzazione in Roblox-provided chart.
Dizionario opzionale di campi personalizzati che forniranno delle spiegazioni nei grafici forniti da Roblox. Solo le chiavi specifiche, fornite da Enum.AnalyticsCustomFieldKeys, saranno utilizzate per queste spiegazioni. Limitato a 8.000 combinazioni di valori 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 delle mappe fornite da Roblox.
Parametri
Il giocatore che ha attivato l'evento.
Restituzioni
LogProgressionEvent
Registra un evento per quando un utente ha iniziato, completato o fallito un tentativo/tentativadi livello. Questo evento non viene attualmente visualizzato in nessuna delle mappe fornite da Roblox.
Parametri
Il giocatore che ha attivato 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 delle mappe fornite 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 delle mappe fornite da Roblox.
Parametri
Il giocatore che ha attivato l'evento.