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, mit denen Entwickler verfolgen können, wie Benutzer mit ihren Erlebnissen interagieren, insbesondere mit dem Fortschritt des Spielers, der Erfahrungswirtschaft und Funneln und benutzerdefinierten Ereignissen.
Zusammenfassung
Methoden
Verfolgt ein Ereignis, das benutzt wird, um Benutzer in der Erlebnisbenutzerdefinierte Metriken zu verfolgen.
- LogEconomyEvent(player : Player,flowType : Enum.AnalyticsEconomyFlowType,currencyType : string,amount : number,endingBalance : number,transactionType : string,itemSku : string,customFields : Dictionary):void
Loggt ein Ereignis, das verwendet wird, um Aktionen des Spielers im Zusammenhang mit dem Erlebnis zu verfolgen.
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):void
Verfolgt ein Ereignis, das die Aktionen des Benutzers verfolgt, der durch einen vorbereiteten Funnel läuft.
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):void
Verfolgt ein Ereignis, das Benutzeraktionen verfolgt, die durch einen Onboarding-Funnel durchgehen.
- LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Loggt ein Ereignis für quando ein Benutzer einen Level-Versuch abgeschlossen hat.
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):void
Loggt ein Ereignis für quando ein Benutzer einen Versuchgestartet, abgeschlossen oder fehlgeschlagen hat.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Loggt ein Ereignis für cuando ein Benutzer einen Versuchgescheitert hat.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Loggt ein Ereignis für cuando a user has started a level Versuch.
Eigenschaften
Methoden
LogCustomEvent
Verfolgt ein Ereignis, das benutzt wird, um Benutzer in der Erlebnisbenutzerdefinierte Metriken zu verfolgen. Weitere Informationen finden Sie unter Benutzerdefinierte Ereignisse.
Parameter
Der Benutzer, der das Ereignis ausgelöst hat.
Der Name des benutzerdefinierten Ereignisses.
Der Wert des Ereignisses, das für die Analyse verwendet wird.
Optionale Diktionarien benutzerdefinierter Felder, die Auskünfte in Roblox-erstellten Diagrammen geben. Nur bestimmte Schlüssel, die von Enum.AnalyticsCustomFieldKeys bereitgestellt werden, werden für diese Auskünfte verwendet. Limitiert auf 8.000 einzigartige Kombinationen von Werten für jede Erlebnis.
Rückgaben
Code-Beispiele
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
Loggt ein Ereignis, das verwendet wird, um Aktionen des Spielers im Zusammenhang mit dem Erlebnis zu verfolgen.
Parameter
Der Benutzer, der das Ereignis ausgelöst hat.
Sollte die Richtung angeben, in die die Währung fließt, mit Enum.AnalyticsEconomyFlowType.
Der Name der zu hinzufügenden oder zu entfernenden Währung, z. B. "gold", "gems" oder "energy". Limitiert auf 5 einzigartige Währungstypen pro Erlebnis.
Die Menge der Währung, die hinzugefügt oder entfernt wird. Dieser Wert sollte immer positiv sein.
Der Guthaben des Benutzers nach dem Hinzufügen oder Entfernen der Währung. Dieser Wert sollte immer größer sein als oder gleich sein 0.
Die Art der Transaktion, die stattgefunden hat. Während Sie kostenlos jeden eingebenverwenden können, empfiehlt sich, die von Enum.AnalyticsEconomyTransactionType angebotenen Arten zu verwenden, wie z. B. "IAP" oder "ContextualPurchase", um künftige Insights von Roblox-Tools und -Charts zu aktivieren.
Da dieses Feldtyp eine Stringist, musst du die Name -Wert des Enumerys übergeben. Zum Beispiel Enum.AnalyticsEconomyTransactionType.IAP.Name.
Limitiert auf 20 einzigartige Arten pro Erlebnis.
Optionale SKU des gekauften Artikels oder der Bundle. Dies ist ein einzigartiger Identifikator für den gekauften Artikel. Limitiert auf 100 einzigartige SKUs pro Erlebnis.
Optionale Diktionarien benutzerdefinierter Felder, die Auskünfte in Roblox-erstellten Diagrammen geben. Nur bestimmte Schlüssel, die von Enum.AnalyticsCustomFieldKeys bereitgestellt werden, werden für diese Auskünfte verwendet. Limitiert auf 8.000 einzigartige Kombinationen von Werten für jede Erlebnis.
Rückgaben
Code-Beispiele
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
Verfolgt ein Ereignis, das Benutzeraktionen verfolgt, die durch einen vorbereiteten Funnel durchgehen. Funnel-Breakdowns 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 dieselbe sein. Limitiert auf 10 einzigartige Kanäle pro Erlebnis.
Optionale einzigartige Kennung für die Funnel-Sitzung. Dies sollte für alle Schritte in der Funnel-Sitzung dasselbe sein.
Beachten Sie, dass dieses Feld nur für wiederholende Funnel nötig ist, z. B. einen Kauf-Flow-Funnel oder einen Artikel-Upgrade-Funnel. Wenn Sie keinen natürlichen Funnel-Session-Identifikator haben, empfehlen wir, HttpService:GenerateGUID() zu verwenden.
Die Schrittnummer in der Funnel. Dies sollte für jeden Schritt in der Funnel einzigartig sein. Alle Funnel starten mit Schritt 1. Limitiert auf Schritte 1-100.
Wiederholte Schritte durch den gleichen Benutzer in der gleichen Funnel-Sitzung oder wenn funnelSessionId ist nil wird ignoriert.
Beachten Sie, dass wenn einige Schritte übersprungen werden, die Zwischenschritte als abgeschlossen betrachtet werden.
Optionale Name des Schritts im Funnel. Dieses Feld wird nur für Anzeigungszwecke in Roblox-erstellten Diagrammen verwendet.
Optionale Diktionarien benutzerdefinierter Felder, die Auskünfte in Roblox-erstellten Diagrammen geben. Nur bestimmte Schlüssel, die von Enum.AnalyticsCustomFieldKeys bereitgestellt werden, werden für diese Auskünfte verwendet. Limitiert auf 8.000 einzigartige Kombinationen von Werten für jede Erlebnis.
Rückgaben
Code-Beispiele
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
Verfolgt ein Ereignis, das Benutzer-Aktionen verfolgt, die durch einen Onboarding-Funnel durchgehen. Funnel-Breakdowns betrachten nur die Benutzer- und Ereigniswerte vom ersten Schritt in einer Funnel-Sitzung.
Parameter
Der Benutzer, der das Ereignis ausgelöst hat.
Die Schrittnummer in der Funnel. Dies sollte für jeden Schritt in der Funnel einzigartig sein. Alle Funnel starten mit Schritt 1. Limitiert auf Schritte 1-100.
Beachten Sie, dass wenn einige Schritte übersprungen werden, die Zwischenschritte als abgeschlossen betrachtet werden.
Optionale Name des Schritts im Funnel. Dieses Feld wird nur für Anzeigungszwecke in Roblox-erstellten Diagrammen verwendet.
Optionale Diktionarien benutzerdefinierter Felder, die Auskünfte in Roblox-erstellten Diagrammen geben. Nur bestimmte Schlüssel, die von Enum.AnalyticsCustomFieldKeys bereitgestellt werden, werden für diese Auskünfte verwendet. Limitiert auf 8.000 einzigartige Kombinationen von Werten für jede Erlebnis.
Rückgaben
Code-Beispiele
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 Level-Versuch abgeschlossen hat. Dieses Ereignis wird in derzeit nicht in irgendeinem Roblox- bereitgestellten Charts angezeigt.
Parameter
Der Spieler, der das Ereignis ausgelöst hat.
Rückgaben
LogProgressionEvent
Verfolgt ein Ereignis, wenn ein Benutzer einen Versuchgestartet, abgeschlossen oder gescheitert hat. Dieses Ereignis wird in derzeit nicht in irgendeinem Roblox-Anzeigeprotokoll angezeigt.
Parameter
Der Spieler, der das Ereignis ausgelöst hat.
Rückgaben
LogProgressionFailEvent
Verfolgt ein Ereignis, wenn ein Benutzer einen Versuchgescheitert hat. Dieses Ereignis wird in derzeit in keiner von Roblox bereitgestellten Diagrammen 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 in derzeit nicht in irgendeinem Roblox- bereitgestellten Charts angezeigt.
Parameter
Der Spieler, der das Ereignis ausgelöst hat.