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 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

Metodi

Proprietà

Metodi

LogCustomEvent

void

Logga un evento utilizzato per tracciare le metriche personalizzate di un utente nell'esperienza. Per ulteriori informazioni, vedi Eventi personalizzati .

Parametri

player: Player

L'utente che ha attivato l'evento.

eventName: string

Il nome dell'evento personalizzato.

value: number

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

Valore predefinito: 1
customFields: Dictionary

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.

Valore predefinito: "nil"

Restituzioni

void

Campioni di codice

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

void

Raccoglie un evento utilizzato per tracciare azioni del giocatore in relazione all'esperienza.

Parametri

player: Player

L'utente che ha attivato l'evento.

Dovrebbe specificare la direzione in cui si muove la valuta utilizzando Enum.AnalyticsEconomyFlowType .

currencyType: string

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

amount: number

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

endingBalance: number

L'importo dell'utente dopo che è stato aggiunto o rimosso la valuta. Questo valore dovrebbe sempre essere maggiore o uguale a 0.

transactionType: string

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.

itemSku: string

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.

Valore predefinito: ""
customFields: Dictionary

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.

Valore predefinito: "nil"

Restituzioni

void

Campioni di codice

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

void

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

player: Player

L'utente che ha attivato l'evento.

funnelName: string

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

funnelSessionId: string

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

Valore predefinito: ""
step: number

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.

Valore predefinito: 1
stepName: string

Nome opzionale della fase nel funnel. Questo campo viene utilizzato solo per scopi di visualizzazione in Roblox-provided chart.

Valore predefinito: ""
customFields: Dictionary

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.

Valore predefinito: "nil"

Restituzioni

void

Campioni di codice

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

void

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

player: Player

L'utente che ha attivato l'evento.

step: number

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.

stepName: string

Nome opzionale della fase nel funnel. Questo campo viene utilizzato solo per scopi di visualizzazione in Roblox-provided chart.

Valore predefinito: ""
customFields: Dictionary

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.

Valore predefinito: "nil"

Restituzioni

void

Campioni di codice

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

void

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

player: Player

Il giocatore che ha attivato l'evento.

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

Restituzioni

void

LogProgressionEvent

void

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

player: Player

Il giocatore che ha attivato l'evento.

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

Restituzioni

void

LogProgressionFailEvent

void

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

player: Player

L'utente che ha attivato l'evento.

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

Restituzioni

void

LogProgressionStartEvent

void

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

player: Player

Il giocatore che ha attivato l'evento.

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

Restituzioni

void

Eventi