Benutzerdefinierte Ereignisse | Dokumentation

Benutzerdefinierte Ereignisse ermöglichen es Ihnen, kennzahlenbezogene Metriken zu verfolgen, die von anderen Ereignissen nicht vollständig erfasst werden. Dazu gehören:

Adoption — Wie viele Benutzer klicken auf eine bestimmte UI-Komponente?
Nutzerverhalten — Welche Fähigkeit wird auf jeder Karte am häufigsten genutzt?
Kernschleife — Wie vergleichen sich die K/D-Ratios verschiedener Waffen?

Sobald Ihr Spiel beginnt, benutzerdefinierte Ereignisse zu verfolgen, wird die Erforschen-Seite des Analytics-Dashboards im Creator Hub freigeschaltet. Sie können bis zu 100 benutzerdefinierte Ereignisse zu Ihrem Spiel hinzufügen.

Benutzerdefinierte Ereignisse verfolgen

Um die Erforschen-Seite freizuschalten, müssen Sie zunächst benutzerdefinierte Ereignisse in Ihrem Spiel verfolgen. Beginnen Sie damit, herauszufinden, welche Metriken für die Überwachung und Verbesserung Ihres Spiels am wichtigsten sind. Ereignisse werden täglich aggregiert, sodass es bis zu 24 Stunden dauern kann, bis die Diagramme auf der Seite angezeigt werden.

Ereignisse können nur vom Server und in veröffentlichten Spielen gesendet werden. Ereignisse können nicht vom Client oder Studio gesendet werden.

Zähler

Zähler sind einmalige Ereignisse, die ohne einen Wert erfasst werden. Sie können Zähler verwenden, um die Anzahl der Male zu verfolgen, die ein bestimmtes Ereignis aufgetreten ist. Verwenden Sie Zähler für Einzelaktionen wie das Klicken auf eine Schaltfläche, das Starten einer Quest oder das Benutzen eines Werkzeugs.

Ereignisse verfolgen automatisch sowohl die Anzahl der Ereignisse als auch die Anzahl der eindeutigen Benutzer. Bei Wert-Aggregationen werden Zählerereignisse als Ereignisse mit einem Standardwert von 1 behandelt. Das bedeutet, dass Aggregationen wie max/min/durchschnitt immer 1 entsprechen und die Summe der Gesamtzahl der Ereignisse gleich ist.


local AnalyticsService = game:GetService("AnalyticsService")

AnalyticsService:LogCustomEvent(
    player,
    "MissionStarted" -- Ereignisname
)

Ereignisse mit Werten

Sie können auch Ereignisse mit Werten verfolgen, um Metriken zu erhalten, die quantitativere Daten für Ihr Spiel erfordern, wie z. B. K/D-Ratios oder die Zeit, die ein Benutzer für eine Mission aufwendet. Es kann auch als Möglichkeit genutzt werden, Ereignisse in Chargen zu senden, um die Ratenlimits einzuhalten, d. h. 10 getötete Zombies zu senden, anstatt 1 Zombie zehnmal zu töten.


local AnalyticsService = game:GetService("AnalyticsService")

AnalyticsService:LogCustomEvent(
    player,
    "MissionCompletedDuration", -- Ereignisname
    120 -- Ereigniswert
)

Ereignisaggregation

Alle Ereignismetriken umfassen die folgenden Aggregationen und unterstützen das Slice-and-Dice:

Anzahl
Anzahl eindeutiger Benutzer
Durchschnittswert
Summe der Werte
Minimalwert
Maximalwert
Durchschnittswert pro Benutzer

Sehen Sie sich Ihre Ereignisaggregation auf der Erforschen-Seite an, indem Sie den Aggregationstyp auswählen.

Eine Liste aller verschiedenen Aggregationsoptionen zur Filterung Ihrer benutzerdefinierten Ereignisdaten.

Benutzerdefinierte Felder verwenden

Benutzerdefinierte Ereignisse ermöglichen auch das Aufschlüsseln nach benutzerdefinierten Feldern, um einen einfacheren Vergleich zwischen Segmenten zu unterstützen. Zum Beispiel können Sie jedem Ereignis Questnamen zuweisen, um zu sehen, welche Benutzer am meisten bevorzugen, oder die Spielerklasse anhängen, um zu sehen, ob eine Klasse ein deutlich höheres K/D-Verhältnis hat.

Sie können nach benutzerdefinierten Feldern aufschlüsseln, indem Sie den Aufschlüsselungswähler verwenden.

Ein Dropdown-Feld, das die drei benutzerdefinierten Felder anzeigt, über die Sie vergleichen können, sowie standardmäßige Aufschlüsselungen wie Alter, Geschlecht, Betriebssystem und mehr.

Sie sollten benutzerdefinierte Felder immer verwenden, wann immer es möglich ist, anstelle von Ereignisnamen, da es eine viel engere Kardinalitätsgrenze für Ereignisnamen als für benutzerdefinierte Felder gibt. Die Verwendung benutzerdefinierter Felder ermöglicht es Ihnen auch, Visualisierungen von Ereignissen über Feldwerte hinweg zu sehen.

Zum Beispiel könnten Sie anstelle von PlantCabbage, PlantTurnip, PlantPepper als drei separate Ereignisse ein einzelnes Ereignis mit dem Namen PlantSeed und benutzerdefinierten Feldwerten Plant - Cabbage, Plant - Turnip und Plant - Pepper haben. Auf diese Weise können Sie sowohl die Gesamtzahl der gepflanzten Samen visualisieren als auch jede Pflanze in derselben Visualisierung vergleichen. Dies reduziert auch die Kardinalität Ihrer Ereignisnamen.

Für weitere Informationen siehe Benutzerdefinierte Felder.

Verwenden Sie benutzerdefinierte Ereignisse, um Ihr Spiel zu erweitern

Benutzerdefinierte Ereignisse ermöglichen es Ihnen, Metriken zu verfolgen, die am wichtigsten sind, und bieten Einblicke, wie Spieler mit bestimmten Funktionen und Inhalten interagieren. Nutzen Sie diese Ereignisse, um Muster im Verhalten der Spieler zu erkennen und Ihre Kerngameschleife zu optimieren.

Im Referenzspiel Plant tritt die Kerngameschleife mit einem HarvestPlant-Ereignis auf, das jedes Mal ausgelöst wird, wenn ein Spieler eine reife Pflanze erntet. Mit benutzerdefinierten Ereignissen können Sie die durchschnittliche Anzahl von Pflanzen, die pro Spieler und Tag geerntet werden, unterteilt nach Pflanzentyp als benutzerdefiniertes Feld verfolgen:

Diagramm für benutzerdefinierte Ereignisse des Referenzspiels 'Plant'.

Versuchen Sie, die Vielfalt der Inhalte in Ihrem Spiel zu verbessern und die Spieler zu ermutigen, andere Optionen als Teil der Kernschleife zu erkunden, um Wiederholungen zu vermeiden.
Untersuchen Sie, warum Benutzer signifikant Turnips gegenüber anderen Pflanzen bevorzugen, und ob es Ungleichgewichte gibt, die Turnips verursachen (z. B. bei Wirtschaftsereignissen).
Fügen Sie weitere Ereignisverfolgungen innerhalb Ihrer Schleife hinzu, wie das Pflanzen von Samen, das Wässern von Pflanzen und den Besuch des Ladens, um das Verhalten der Spieler und andere Verbesserungsbereiche besser zu verfolgen.