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 Erfahrung zu 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 Erfahrung zu 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 Levelversuch abgeschlossen hat.
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):()
Protokolliert ein Ereignis, wenn ein Benutzer einen Levelversuch gestartet, abgeschlossen oder fehlgeschlagen hat.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Protokolliert ein Ereignis, wenn ein Benutzer einen Levelversuch fehlgeschlagen hat.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Protokolliert ein Ereignis, wenn ein Benutzer einen Levelversuch gestartet 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 Erfahrung.
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 Erfahrung zu 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 Transaktionstyp zu 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 Erfahrung.
Rückgaben
Code-Beispiele
Die folgende Beispielspur verfolgt einen Robux-Kauf eines 1000-Münzen-Bündels mit dem IAP (In-App-Kauf) Transaktionstyp.Beachten Sie den Artikelnamen, der als optionale Parameter beim Vergleich mit der vorherigen Probe bereitgestellt wird.
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"Coins",
1000, -- Wie viele Münzen sind im Bündel
1020, -- bilanz nach transaktion
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- Einzigartige Kennung des Münzbündels
)
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 Erfahrung.
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 Erfahrung.
Rückgaben
Code-Beispiele
Die folgenden Beispiel-Schritte verfolgen einige grundlegende Ereignisse für jeden Benutzer, der den Prozess beginnt, ein Artikel aus einem "Waffenkammer"-Shop zu kaufen.Beachten Sie die funnelSessionId, die verwendet wird, um zwischen verschiedenen Sitzungen desselben Benutzers zu unterscheiden, der den Shop öffnet.
local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
funnelSessionId = HttpService:GenerateGUID()
-- Protokollieren, wenn der Benutzer den Laden öffnet
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Funnel-Name wird verwendet, um Schritte zusammenzugruppieren
funnelSessionId, -- Funnel-Sitzungs-ID für diese einzigartige Checkout-Sitzung
1, -- Schritt-Nummer
"Opened Store" -- Schrittname
)
-- Protokollieren, wenn der Benutzer ein Element anzeigt
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Funnel-Name wird verwendet, um Schritte zusammenzugruppieren
funnelSessionId, -- Funnel-Sitzungs-ID für diese einzigartige Checkout-Sitzung
2, -- Schritt-Nummer
"Viewed Item" -- Schrittname
)
-- Protokollieren, wenn der Benutzer auf "Zum Warenkorb hinzufügen" klickt
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Funnel-Name wird verwendet, um Schritte zusammenzugruppieren
funnelSessionId, -- Funnel-Sitzungs-ID für diese einzigartige Checkout-Sitzung
3, -- Schritt-Nummer
"Added to Cart" -- Schrittname
)
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 Erfahrung.
Rückgaben
Code-Beispiele
Das folgende Beispiel zeigt, wie man zwei Schritte eines Onboarding-Funnels protokolliert.Ein Onboarding-Funnel führt typischerweise Spieler in den Kernzyklus des Spiels ein.
local AnalyticsService = game:GetService("AnalyticsService")
-- Protokollieren Sie den ersten Schritt des FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- Schritt-Nummer
"Joined Game" -- Schrittname
)
-- Protokollieren Sie den zweiten Schritt des FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- Schritt-Nummer
"Choose Class" -- Schrittname
)
LogProgressionCompleteEvent
Protokolliert ein Ereignis, wenn ein Benutzer einen Levelversuch abgeschlossen 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 Levelversuch gestartet, 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 Levelversuch fehlgeschlagen 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 Levelversuch gestartet hat. Dieses Ereignis wird derzeit in keiner von Roblox bereitgestellten Grafik angezeigt.
Parameter
Der Spieler, der das Ereignis ausgelöst hat.