AnalyticsService
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
AnalyticsService ist eine Sammlung von Methoden, die es Entwicklern ermöglicht, zu verfolgen, wie Benutzer mit ihren Erlebnissen interagieren, insbesondere den Fortschritt von Spielern, die Wirtschaft im Erlebnis, Funnel und benutzerdefinierte Ereignisse.
Zusammenfassung
Methoden
Protokolliert ein Ereignis, das verwendet wird, um die benutzerdefinierten Metriken eines Benutzers in der Erlebniszu verfolgen.
- LogEconomyEvent(player : Player,flowType : Enum.AnalyticsEconomyFlowType,currencyType : string,amount : number,endingBalance : number,transactionType : string,itemSku : string,customFields : Dictionary):()
Protokolliert ein Ereignis, das verwendet wird, um Spieleraktionen im Zusammenhang mit der Erlebniszu verfolgen.
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):()
Protokolliert ein Ereignis, das verwendet wird, um die Aktionen eines Benutzers zu verfolgen, die durch einen vorab geplanten Funnel gehen.
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):()
Protokolliert ein Ereignis, das verwendet wird, um Benutzeraktionen zu verfolgen, die durch einen Onboarding-Funnel gehen.
- LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Protokolliert ein Ereignis, wenn ein Benutzer einen Versuchabgeschlossen hat.
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):()
Protokolliert ein Ereignis, wenn ein Benutzer einen Versuchgestartet, abgeschlossen oder fehlgeschlagen hat.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Protokolliert ein Ereignis, wenn ein Benutzer einen Versuchfehlgeschlagen hat.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Protokolliert ein Ereignis, wenn ein Benutzer einen Versuchgestartet hat.
Eigenschaften
Methoden
LogCustomEvent
Protokolliert ein Ereignis, das benutzerdefinierte Metriken eines Benutzers im Erlebnis verfolgt. Weitere Informationen finden Sie unter Benutereigene Ereignisse.
Parameter
Der Benutzer, der das Ereignis ausgelöst hat.
Der Name des benutzerdefinierten Events.
Der Wert des Events, das in der Aggregation verwendet wird.
Optionales Wörterbuch von benutzerdefinierten Feldern, die Zerlegungen in von Roblox bereitgestellten Diagrammen liefern.Nur spezifische Schlüssel, bereitgestellt von Enum.AnalyticsCustomFieldKeys, werden für diese Zusammenbrüche verwendet.Begrenzt auf 8.000 einzigartige Kombinationen von Werten über die drei benutzerdefinierten Felder pro Erlebnis.
Rückgaben
Code-Beispiele
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
Protokolliert ein Ereignis, das verwendet wird, um Spieleraktionen im Zusammenhang mit der Erlebniszu verfolgen.
Parameter
Der Benutzer, der das Ereignis ausgelöst hat.
Sollte die Richtung angeben, in die die Währung fließt, indem Enum.AnalyticsEconomyFlowType verwendet wird.
Der Name der Währung, die hinzugefügt oder entfernt wird, zum Beispiel "gold" , "gems" oder "energy".Begrenzt auf 5 einzigartige Währungstypen pro Erlebnis.
Die Menge der Währung, die hinzugefügt oder entfernt wird. Dieser Wert sollte immer positiv sein.
Das Konto des Benutzers nach der Hinzufügung oder Entfernung der Währung. Dieser Wert sollte immer größer als oder gleich 0 sein.
Die Art der Transaktion, die stattgefunden hat.Während du frei bist, jeden eingebenzu verwenden, wird empfohlen, die bereitgestellten Arten von Enum.AnalyticsEconomyTransactionType wie "IAP" oder "ContextualPurchase" zu verwenden, um zukünftige Einsichten mit Roblox-Tools und -Diagrammen zu aktivieren.
Da dieser Feldtyp ein String ist, musst du den Wert der Enumeration Name übergeben. Zum Beispiel Enum.AnalyticsEconomyTransactionType.IAP.Name.
Begrenzt auf 20 einzigartige Arten pro Erlebnis.
Optionale SKU des zu kaufenden Artikels oder Bündels.Dies ist eine eindeutige Kennung für das zu kaufende Element.Begrenzt auf 100 einzigartige SKUs pro Erlebnis.
Optionales Wörterbuch von benutzerdefinierten Feldern, die Zerlegungen in von Roblox bereitgestellten Diagrammen liefern.Nur spezifische Schlüssel, bereitgestellt von Enum.AnalyticsCustomFieldKeys, werden für diese Zusammenbrüche verwendet.Begrenzt auf 8.000 einzigartige Kombinationen von Werten über die drei benutzerdefinierten Felder pro Erlebnis.
Rückgaben
Code-Beispiele
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
Protokolliert ein Ereignis, das verwendet wird, um die Aktionen eines Benutzers zu verfolgen, die durch einen vorab geplanten Funnel gehen.Funnel-Abbruche betrachten nur die Benutzer- und Ereigniswerte vom ersten Schritt in einer Funnel-Sitzung.
Parameter
Der Benutzer, der das Ereignis ausgelöst hat.
Der Name des Kanals. Dies sollte für alle Schritte im Kanal gleich sein. Begrenzt auf 10 einzigartige Kanäle pro Erlebnis.
Optionale eindeutige Kennung für die Funnel-Sitzung. Dies sollte für alle Schritte im Funnel gleich sein.
Beachten Sie, dass dieses Feld nur für wiederkehrende Funnel erforderlich ist, zum Beispiel einen Kaufprozess-Funnel oder einen Artikel-Upgrade-Funnel.Wenn du keinen natürlichen Funnel-Sitzungsidentifikator hast, wird empfohlen, HttpService:GenerateGUID() zu verwenden.
Die Schrittnummer im Trichter. Dies sollte für jeden Schritt im Trichter einzigartig sein. Alle Trichter beginnen bei Schritt 1. Begrenzt auf Schritte 1-100.
Wiederholte Schritte durch denselben Benutzer in derselben Funnel-Sitzung oder wenn funnelSessionId ignoriert wird, wenn nil wird.
Beachten Sie, dass, wenn Schritte übersprungen werden, die Zwischenschritte als abgeschlossen betrachtet werden.
Optioneller Name des Schritts im Funnel. Dieses Feld wird nur zu Anzeckszwecken in von Roblox bereitgestellten Diagrammen verwendet.
Optionales Wörterbuch von benutzerdefinierten Feldern, die Zerlegungen in von Roblox bereitgestellten Diagrammen liefern.Nur spezifische Schlüssel, bereitgestellt von Enum.AnalyticsCustomFieldKeys, werden für diese Zusammenbrüche verwendet.Begrenzt auf 8.000 einzigartige Kombinationen von Werten über die drei benutzerdefinierten Felder pro Erlebnis.
Rückgaben
Code-Beispiele
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
Protokolliert ein Ereignis, das verwendet wird, um Benutzeraktionen zu verfolgen, die durch einen Onboarding-Funnel gehen.Funnel-Abbruche betrachten nur die Benutzer- und Ereigniswerte vom ersten Schritt in einer Funnel-Sitzung.
Parameter
Der Benutzer, der das Ereignis ausgelöst hat.
Die Schrittnummer im Trichter. Dies sollte für jeden Schritt im Trichter einzigartig sein. Alle Trichter beginnen bei Schritt 1. Begrenzt auf Schritte 1-100.
Beachten Sie, dass, wenn Schritte übersprungen werden, die Zwischenschritte als abgeschlossen betrachtet werden.
Optioneller Name des Schritts im Funnel. Dieses Feld wird nur zu Anzeckszwecken in von Roblox bereitgestellten Diagrammen verwendet.
Optionales Wörterbuch von benutzerdefinierten Feldern, die Zerlegungen in von Roblox bereitgestellten Diagrammen liefern.Nur spezifische Schlüssel, bereitgestellt von Enum.AnalyticsCustomFieldKeys, werden für diese Zusammenbrüche verwendet.Begrenzt auf 8.000 einzigartige Kombinationen von Werten über die drei benutzerdefinierten Felder pro Erlebnis.
Rückgaben
Code-Beispiele
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
Protokolliert ein Ereignis, wenn ein Benutzer einen Versuchabgeschlossen hat. Dieses Ereignis wird derzeit in keiner von Roblox bereitgestellten Grafik angezeigt.
Parameter
Der Spieler, der das Ereignis ausgelöst hat.
Rückgaben
LogProgressionEvent
Protokolliert ein Ereignis, wenn ein Benutzer einen Versuchgestartet, abgeschlossen oder fehlgeschlagen hat. Dieses Ereignis wird derzeit in keiner von Roblox bereitgestellten Chart angezeigt.
Parameter
Der Spieler, der das Ereignis ausgelöst hat.
Rückgaben
LogProgressionFailEvent
Protokolliert ein Ereignis, wenn ein Benutzer einen Versuchfehlgeschlagen hat. Dieses Ereignis wird derzeit in keiner von Roblox bereitgestellten Grafik angezeigt.
Parameter
Der Benutzer, der das Ereignis ausgelöst hat.
Rückgaben
LogProgressionStartEvent
Protokolliert ein Ereignis, wenn ein Benutzer einen Versuchgestartet hat. Dieses Ereignis wird derzeit in keiner von Roblox bereitgestellten Grafik angezeigt.
Parameter
Der Spieler, der das Ereignis ausgelöst hat.