Wirtschaftsevents | Dokumentation

Wirtschaftsevents ermöglichen es Ihnen, die Wirtschaft in Ihrem Spiel zu verfolgen, wie zum Beispiel:

Top-Senken — Wofür geben Benutzer Ressourcen im Spiel aus?
Top-Quellen — Wo verdienen Benutzer Ressourcen?
Durchschnittlicher Geldbörsenbestand — Wie viele Ressourcen halten die Benutzer?

Sobald Ihr Spiel beginnt, Wirtschaftsevents zu verfolgen, wird die Wirtschaftsseite des Analyse-Dashboards im Creator Hub freigeschaltet.

Wirtschaftsevents verfolgen

Um das Wirtschafts-Dashboard freizuschalten, müssen Sie einige Wirtschaftsevents in Ihrem Spiel verfolgen. Beginnen Sie damit, herauszufinden, wo Benutzer Ressourcen quellen (d.h. gewinnen) und senken (d.h. ausgeben) in Ihrem Spiel. Diese werden im Code durch Enum.AnalyticsEconomyFlowType dargestellt, das entweder Source oder Sink sein kann.

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

Transaktionstypen

Jedes Quellen- und Senkenereignis erfordert einen Transaktionstyp, der mit Enum.AnalyticsEconomyTransactionType codiert ist. Standardmäßig sind die Optionen:

IAP (Quelle) - In-App-Käufe, bei denen Robux gegen Ressourcen eingetauscht werden, z.B. Starterpaket.
TimedReward (Quelle) - Ressourcen nach einem Zeitplan verdienen, z.B. täglicher Bonus.
Onboarding (Quelle) - Ressourcen beim Einstieg erhalten, z.B. Willkommensbonus.
Shop (Quelle oder Senke) - Ressourcen im Shop tauschen, z.B. Artikelkauf.
Gameplay (Quelle oder Senke) - Ressourcen durch Gameplay verdienen oder ausgeben, z.B. Abschluss einer Quest.
ContextualPurchase (Senke) - Ressourcen für einen kontextbezogenen Impuls ausgeben, z.B. zusätzliche Leben.

Diese Typen erscheinen im Dashboard. Es ist eine gute Idee, mit den Standardkategorien zu beginnen, aber wenn Sie möchten, können Sie auch Ihre eigenen Transaktionstypnamen beim Protokollieren eines Ereignisses angeben.

Quellen verfolgen

Das folgende Beispiel verwendet AnalyticsService.LogEconomyEvent, um zwei verschiedene Wirtschaftsevents zu protokollieren, wenn Benutzer die ersten und zweiten Level im Spiel abschließen und einige Münzen verdienen.

Verfolgen eines Quellen-Gameplay-Ereignisses

local AnalyticsService = game:GetService("AnalyticsService")

-- Nach Abschluss von Level 1
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Münzen", -- Währungsname
    50, -- Verdiente Menge
    50, -- Aktueller Bestand
    Enum.AnalyticsEconomyTransactionType.Gameplay.Name -- Transaktionstyp
)

-- Nach Abschluss von Level 2
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Münzen", -- Währungsname
    50, -- Verdiente Menge
    100, -- Bestand nach der Transaktion
    Enum.AnalyticsEconomyTransactionType.Gameplay.Name -- Transaktionstyp
)

Das folgende Beispiel protokolliert einen Robux-Kauf eines 1000-Münzen-Bundles, unter Verwendung des Transaktionstyps IAP (In-App-Kauf), diesmal mit einer itemSKU, Ihrem eindeutigen Identifikator für den Artikel. itemSKU ist optional. Wenn Sie es nicht angeben, zeigt das Wirtschafts-Dashboard N/A in der Quellen- und Senken-Tabelle an.

Verfolgen eines In-App-Kaufs

local AnalyticsService = game:GetService("AnalyticsService")

AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Münzen",
    1000, -- Wie viele Münzen im Bundle sind
    1020, -- Bestand nach der Transaktion
    Enum.AnalyticsEconomyTransactionType.IAP.Name,
    "1000MünzenBundle" -- Eindeutiger Artikel-SKU-Identifikator des Münzenbundles
)

In diesem Beispiel, wenn Sie viele Münzenbundles haben, möchten Sie möglicherweise auch ein benutzerdefiniertes Feld hinzufügen, um die Kategorie des Münzenbundles im Vergleich zu anderen Kategorien zu verfolgen.

Senken verfolgen

Das folgende Beispiel protokolliert ein Ereignis, wenn Benutzer Münzen ausgeben, um ein DoubleJumpUpgrade zu kaufen. Beachten Sie den Fluss-Typ Sink und den Transaktionstyp Shop im Vergleich zu den Quellenverfolgungsbeispielen.

Beachten Sie, dass der Betrag (Kosten) immer eine positive Zahl sein sollte, unabhängig davon, ob das Ereignis eine Quelle oder eine Senke ist. Die Diagramme im Wirtschafts-Dashboard zeigen Senken automatisch als negative Zahlen an.

Verfolgen eines Senken-Gameplay-Ereignisses

local AnalyticsService = game:GetService("AnalyticsService")

-- Nach Abschluss von Level 2
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Sink,
    "Münzen", -- Währungsname
    80, -- Kosten
    20, -- Bestand nach der Transaktion
    Enum.AnalyticsEconomyTransactionType.Shop.Name,
    "DoubleJumpUpgrade" -- Artikel-SKU
)

Für Informationen zu den Einschränkungen von AnalyticsService siehe Ereignisverfolgungseinschränkungen.

Benutzerdefinierte Felder verwenden

Wirtschaftsevents ermöglichen auch die Aufschlüsselung nach benutzerdefinierten Feldern, um den Vergleich zwischen Segmenten zu erleichtern. Zum Beispiel können Sie jedem Ereignis Questnamen zuweisen, um zu sehen, aus welchen die Benutzer am meisten Geld verdienen, oder Geschäfte angeben, um zu sehen, ob Benutzer einen Standort dem anderen vorziehen.

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

Ein Dropdown-Menü, das die drei benutzerdefinierten Felder anzeigt, die Sie vergleichen können, zusammen mit Standardaufschlüsselungen wie Alter, Geschlecht, Betriebssystem und mehr.

Für weitere Informationen siehe Benutzerdefinierte Felder.

Verwenden Sie die Wirtschaft, um Ihr Spiel zu wachsen

Das Wirtschafts-Dashboard enthält fünf Diagramme, die Ihnen helfen, Maßnahmen zu ergreifen, um Ihre Einnahmen zu steigern. Sie können bis zu fünf Währungen von Ressourcen hinzufügen, und alle Diagramme können nach verschiedenen Benutzerkategorien (Geschlecht, Alter, Plattform usw.) und bis zu drei benutzerdefinierten Feldern, die spezifisch für Ihr Spiel sind, gefiltert werden.

Gesamte Quellen und Senken nach Kategorie - Verwenden Sie dieses Diagramm, um Ihre In-Game-Wirtschaft ins Gleichgewicht zu bringen. Gesamte Quellen minus gesamte Senken sollten nahe null sein. Sie können auch Ihre Top-Quellen und -Senken nach Kategorie sehen. Wenn Ihr Nettogesamt wächst, ziehen Sie in Betracht, weitere Senken hinzuzufügen.
Durchschnittlicher Geldbörsenbestand - Verwenden Sie dieses Diagramm, um zu sehen, wie viele Ressourcen Benutzer, Zahler und Nicht-Zahler im Durchschnitt halten. Wenn der durchschnittliche Bestand wächst, insbesondere bei Zahlern, ziehen Sie in Betracht, neue Senken hinzuzufügen.
Top-Quellen und -Senken - Verwenden Sie dies, um zu identifizieren, wo Ihre Benutzer ihre Ressourcen gewinnen und ausgeben. Wenn Benutzer keine Ressourcen aus In-App-Käufen beziehen, ziehen Sie in Betracht, die Preise zu senken oder neue Optionen anzubieten. Wenn Benutzer nicht genug von einer bestimmten Ressource ausgeben, ziehen Sie in Betracht, neue Senken für diese Ressource hinzuzufügen.
Alle Quellen und Senken - Verwenden Sie dies, um eine kombinierte Ansicht nach Kategorie für den ausgewählten Datumsbereich zu erhalten.

Für weitere Tipps, wie Sie Ihre In-Experience-Wirtschaft ins Gleichgewicht bringen können, siehe Virtuelle Wirtschaften ausbalancieren.