Événements économiques | Documentation

Les événements économiques vous permettent de suivre l'économie de votre jeu, tels que :

Principaux puits — Sur quoi les utilisateurs dépensent-ils des ressources dans le jeu ?
Principales sources — Où les utilisateurs gagnent-ils des ressources ?
Solde moyen du portefeuille — Combien de ressources les utilisateurs détiennent-ils ?

Une fois que votre jeu commence à suivre les événements économiques, vous débloquerez la page Économie du tableau de bord Analytics sur le Creator Hub.

Suivre les événements économiques

Pour débloquer le tableau de bord Économie, vous devez suivre certains événements économiques dans votre jeu. Commencez par identifier où les utilisateurs sourcent (c'est-à-dire gagnent) et s'inclinent (c'est-à-dire dépensent) des ressources dans votre jeu. Ceux-ci sont représentés dans le code par Enum.AnalyticsEconomyFlowType, qui peut être soit Source soit Sink.

Les événements ne peuvent être envoyés que depuis le serveur et dans les jeux publiés. Les événements ne peuvent pas être envoyés depuis le client ou Studio.

Types de transactions

Chaque événement de source et de puits nécessite un type de transaction, encodé avec Enum.AnalyticsEconomyTransactionType. Par défaut, les options sont :

IAP (source) - Achats in-app échangeant des Robux contre des ressources, par exemple un pack de démarrage.
TimedReward (source) - Gagnez des ressources selon un calendrier, par exemple un bonus quotidien.
Onboarding (source) - Obtenez des ressources lorsque vous commencez, par exemple un bonus de bienvenue.
Shop (source ou puits) - Échangez des ressources dans la boutique, par exemple un achat d'article.
Gameplay (source ou puits) - Gagnez ou dépensez des ressources grâce au gameplay, par exemple l'achèvement d'une quête.
ContextualPurchase (puits) - Dépensez des ressources sur un achat impulsif spécifique au contexte, par exemple des vies supplémentaires.

Ces types apparaissent sur le tableau de bord. Il est conseillé de commencer avec les catégories par défaut, mais si nécessaire, vous pouvez également fournir vos propres noms de types de transaction lors de la journalisation d'un événement.

Suivre les sources

L'exemple suivant utilise AnalyticsService.LogEconomyEvent pour enregistrer deux événements économiques différents lorsque les utilisateurs terminent les premier et deuxième niveaux du jeu et gagnent des pièces.

Suivi d'un événement de source Gameplay

local AnalyticsService = game:GetService("AnalyticsService")

-- Après l'achèvement du niveau 1
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins", -- Nom de la monnaie
    50, -- Montant gagné
    50, -- Solde actuel
    Enum.AnalyticsEconomyTransactionType.Gameplay.Name -- Type de transaction
)

-- Après l'achèvement du niveau 2
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins", -- Nom de la monnaie
    50, -- Montant gagné
    100, -- Solde après la transaction
    Enum.AnalyticsEconomyTransactionType.Gameplay.Name -- Type de transaction
)

L'exemple suivant suit un achat de Robux d'un pack de 1000 pièces, en utilisant le type de transaction IAP (achat in-app), cette fois avec un itemSKU, votre identifiant unique pour l'article. itemSKU est optionnel. Si vous ne le spécifiez pas, les tableaux de bord Économie afficheront N/A dans les tableaux des sources et des puits.

Suivi d'un achat in-app

local AnalyticsService = game:GetService("AnalyticsService")

AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins",
    1000, -- Combien de pièces sont dans le pack
    1020, -- Solde après la transaction
    Enum.AnalyticsEconomyTransactionType.IAP.Name,
    "1000CoinBundle" -- Identifiant SKU unique de l'article du pack de pièces
)

Dans cet exemple, si vous avez de nombreux packs de pièces, vous voudrez peut-être également ajouter un champ personnalisé pour suivre la catégorie du pack de pièces par rapport à d'autres catégories.

Suivre les puits

L'exemple suivant enregistre un événement lorsque les utilisateurs dépensent des pièces pour acheter un DoubleJumpUpgrade. Notez le type de flux Sink et le type de transaction Shop par rapport aux exemples de suivi de source.

Gardez à l'esprit que le montant (coût) doit toujours être un nombre positif, que l'événement soit une source ou un puits. Les graphiques du tableau de bord économique afficheront automatiquement les puits comme des nombres négatifs.

Suivi d'un événement de puits Gameplay

local AnalyticsService = game:GetService("AnalyticsService")

-- Après l'achèvement du niveau 2
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Sink,
    "Coins", -- Nom de la monnaie
    80, -- Coût
    20, -- Solde après la transaction
    Enum.AnalyticsEconomyTransactionType.Shop.Name,
    "DoubleJumpUpgrade" -- SKU de l'article
)

Pour des informations sur les limitations de AnalyticsService, voir Limitations du suivi des événements.

Utiliser des champs personnalisés

Les événements économiques permettent également de décomposer les champs personnalisés pour faciliter la comparaison entre les segments. Par exemple, vous pouvez fournir des noms de quêtes à chaque événement pour voir lesquelles rapportent le plus d'argent aux utilisateurs, ou attacher des emplacements de magasin pour voir si les utilisateurs préfèrent un emplacement à un autre.

Vous pouvez décomposer par des champs personnalisés en utilisant le sélecteur de décomposition.

Un menu déroulant indiquant les trois champs personnalisés que vous pouvez comparer, ainsi que des décompositions standard comme l'âge, le sexe, le système d'exploitation, etc.

Pour plus d'informations, voir Champs personnalisés.

Utiliser l'économie pour développer votre jeu

Le tableau de bord Économie comprend cinq graphiques pour vous aider à agir pour augmenter vos revenus. Vous pouvez ajouter jusqu'à cinq monnaies de ressources, et tous les graphiques peuvent être filtrés par diverses catégories d'utilisateurs (sexe, âge, plateforme, etc.) et jusqu'à trois champs personnalisés spécifiques à votre jeu.

Total des sources et des puits par catégorie - Utilisez ce graphique pour équilibrer l'économie de votre jeu. Le total des sources moins le total des puits devrait être proche de zéro. Vous pouvez également voir vos principales sources et puits par catégorie. Si votre total net augmente, envisagez d'ajouter plus de puits.
Solde moyen du portefeuille - Utilisez ce graphique pour voir combien de ressources les utilisateurs, les payeurs et les non-payeurs détiennent en moyenne. Si le solde moyen augmente, en particulier pour les payeurs, envisagez d'ajouter de nouveaux puits.
Principales sources et puits - Utilisez ceci pour identifier où vos utilisateurs gagnent et dépensent leurs ressources. Si les utilisateurs ne sourcent pas de ressources à partir d'achats in-app, envisagez de réduire les prix ou d'offrir de nouvelles options. Si les utilisateurs ne dépensent pas suffisamment d'une ressource donnée, envisagez d'ajouter de nouveaux puits pour cette ressource.
Toutes les sources et tous les puits - Utilisez ceci pour obtenir une vue combinée par catégorie pour la plage de dates sélectionnée.

Pour plus de conseils sur la façon d'équilibrer votre économie dans l'expérience, voir Équilibrer les économies virtuelles.