AnalyticsService

Veraltete anzeigen

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Nicht erstellbar
Dienst
Nicht repliziert

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

Eigenschaften

Methoden

LogCustomEvent

()

Protokolliert ein Ereignis, das benutzerdefinierte Metriken eines Benutzers im Erlebnis verfolgt. Weitere Informationen finden Sie unter Benutereigene Ereignisse.

Parameter

player: Player

Der Benutzer, der das Ereignis ausgelöst hat.

Standardwert: ""
eventName: string

Der Name des benutzerdefinierten Events.

Standardwert: ""
value: number

Der Wert des Events, das in der Aggregation verwendet wird.

Standardwert: 1
customFields: Dictionary

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.

Standardwert: "nil"

Rückgaben

()

Code-Beispiele

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

()

Protokolliert ein Ereignis, das verwendet wird, um Spieleraktionen im Zusammenhang mit der Erfahrung zu verfolgen.

Parameter

player: Player

Der Benutzer, der das Ereignis ausgelöst hat.

Standardwert: ""

Sollte die Richtung angeben, in die die Währung fließt, indem Enum.AnalyticsEconomyFlowType verwendet wird.

Standardwert: ""
currencyType: string

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.

Standardwert: ""
amount: number

Die Menge der Währung, die hinzugefügt oder entfernt wird. Dieser Wert sollte immer positiv sein.

Standardwert: ""
endingBalance: number

Das Konto des Benutzers nach der Hinzufügung oder Entfernung der Währung. Dieser Wert sollte immer größer als oder gleich 0 sein.

Standardwert: ""
transactionType: string

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.

Standardwert: ""
itemSku: string

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.

Standardwert: ""
customFields: Dictionary

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.

Standardwert: "nil"

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.

Einen In-App-Kauf verfolgen

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

player: Player

Der Benutzer, der das Ereignis ausgelöst hat.

Standardwert: ""
funnelName: string

Der Name des Kanals. Dies sollte für alle Schritte im Kanal gleich sein. Begrenzt auf 10 einzigartige Kanäle pro Erfahrung.

Standardwert: ""
funnelSessionId: string

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.

Standardwert: ""
step: number

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.

Standardwert: 1
stepName: string

Optioneller Name des Schritts im Funnel. Dieses Feld wird nur zu Anzeckszwecken in von Roblox bereitgestellten Diagrammen verwendet.

Standardwert: ""
customFields: Dictionary

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.

Standardwert: "nil"

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.

Schrittverfolgung im Shop

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

player: Player

Der Benutzer, der das Ereignis ausgelöst hat.

Standardwert: ""
step: number

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.

Standardwert: ""
stepName: string

Optioneller Name des Schritts im Funnel. Dieses Feld wird nur zu Anzeckszwecken in von Roblox bereitgestellten Diagrammen verwendet.

Standardwert: ""
customFields: Dictionary

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.

Standardwert: "nil"

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.

Verfolgung von Onboarding-Schritten

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

player: Player

Der Spieler, der das Ereignis ausgelöst hat.

Standardwert: ""
progressionPathName: string
Standardwert: ""
level: number
Standardwert: ""
levelName: string
Standardwert: ""
customFields: Dictionary
Standardwert: "nil"

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

player: Player

Der Spieler, der das Ereignis ausgelöst hat.

Standardwert: ""
progressionPathName: string
Standardwert: ""
Standardwert: ""
level: number
Standardwert: ""
levelName: string
Standardwert: ""
customFields: Dictionary
Standardwert: "nil"

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

player: Player

Der Benutzer, der das Ereignis ausgelöst hat.

Standardwert: ""
progressionPathName: string
Standardwert: ""
level: number
Standardwert: ""
levelName: string
Standardwert: ""
customFields: Dictionary
Standardwert: "nil"

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

player: Player

Der Spieler, der das Ereignis ausgelöst hat.

Standardwert: ""
progressionPathName: string
Standardwert: ""
level: number
Standardwert: ""
levelName: string
Standardwert: ""
customFields: Dictionary
Standardwert: "nil"

Rückgaben

()

Ereignisse