AnalyticsService

Visualizza obsoleti

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Non costruibile
Assistenza
Non Replicato

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

Metodi

Proprietà

Metodi

LogCustomEvent

()

Registra un evento utilizzato per tracciare le metriche personalizzate di un utente in esperienza. Per ulteriori informazioni, vedi Eventi personalizzati.

Parametri

player: Player

L'utente che ha attivato l'evento.

Valore predefinito: ""
eventName: string

Il nome dell'evento personalizzato.

Valore predefinito: ""
value: number

Il valore dell'evento che verrà utilizzato in aggregazione.

Valore predefinito: 1
customFields: Dictionary

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.

Valore predefinito: "nil"

Restituzioni

()

Campioni di codice

This example uses AnalyticsService:LogCustomEvent() to log two custom events: MissionStarted and MissionCompletedDuration.

Log Custom Event

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

player: Player

L'utente che ha attivato l'evento.

Valore predefinito: ""

Dovrebbe specificare la direzione in cui il valuta fluisce utilizzando Enum.AnalyticsEconomyFlowType .

Valore predefinito: ""
currencyType: string

Il nome della valuta aggiunta o rimossa, ad esempio "gold" , "gems" , o "energy" .Limitato a 5 tipi di valuta unici per esperienza.

Valore predefinito: ""
amount: number

La quantità di valuta aggiunta o rimossa. Questo valore dovrebbe essere sempre positivo.

Valore predefinito: ""
endingBalance: number

L'equilibrio dell'utente dopo che è stata aggiunta o rimossa la valuta. Questo valore dovrebbe essere sempre maggiore o uguale a 0.

Valore predefinito: ""
transactionType: string

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.

Valore predefinito: ""
itemSku: string

SKU opzionale dell'articolo o del pacchetto acquistato.Questo è un identificatore univoco per l'articolo acquistato.Limitato a 100 SKU unici per esperienza.

Valore predefinito: ""
customFields: Dictionary

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.

Valore predefinito: "nil"

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.

Tracking an in-app purchase

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

player: Player

L'utente che ha attivato l'evento.

Valore predefinito: ""
funnelName: string

Il nome del funnel. Questo dovrebbe essere lo stesso per tutti i passi nel funnel. Limitato a 10 funnel unici per esperienza.

Valore predefinito: ""
funnelSessionId: string

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() .

Valore predefinito: ""
step: number

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.

Valore predefinito: 1
stepName: string

Nome opzionale dello step nella funzione. Questo campo viene utilizzato solo per scopi di visualizzazione nelle chart fornite da Roblox.

Valore predefinito: ""
customFields: Dictionary

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.

Valore predefinito: "nil"

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.

Tracking Shop steps

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

player: Player

L'utente che ha attivato l'evento.

Valore predefinito: ""
step: number

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.

Valore predefinito: ""
stepName: string

Nome opzionale dello step nella funzione. Questo campo viene utilizzato solo per scopi di visualizzazione nelle chart fornite da Roblox.

Valore predefinito: ""
customFields: Dictionary

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.

Valore predefinito: "nil"

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.

Tracking onboarding steps

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

player: Player

Il giocatore che ha triggerato l'evento.

Valore predefinito: ""
progressionPathName: string
Valore predefinito: ""
level: number
Valore predefinito: ""
levelName: string
Valore predefinito: ""
customFields: Dictionary
Valore predefinito: "nil"

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

player: Player

Il giocatore che ha triggerato l'evento.

Valore predefinito: ""
progressionPathName: string
Valore predefinito: ""
Valore predefinito: ""
level: number
Valore predefinito: ""
levelName: string
Valore predefinito: ""
customFields: Dictionary
Valore predefinito: "nil"

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

player: Player

L'utente che ha attivato l'evento.

Valore predefinito: ""
progressionPathName: string
Valore predefinito: ""
level: number
Valore predefinito: ""
levelName: string
Valore predefinito: ""
customFields: Dictionary
Valore predefinito: "nil"

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

player: Player

Il giocatore che ha triggerato l'evento.

Valore predefinito: ""
progressionPathName: string
Valore predefinito: ""
level: number
Valore predefinito: ""
levelName: string
Valore predefinito: ""
customFields: Dictionary
Valore predefinito: "nil"

Restituzioni

()

Eventi