Événements économiques | Documentation

Événements économiques vous permet de suivre votre économie dans l'expérience, telle que :

Les éviers supérieurs — Qu'est-ce que les utilisateurs dépensent dans les ressources de l'expérience ?
Les meilleures sources — Où les utilisateurs gagnent-ils des ressources ?
Balance moyenne du portefeuille — Combien de ressources les utilisateurs détiennent-ils?

Une fois que votre expérience commencera à suivre des événements Économie, vous déverrouillerez la page Économie du tableau de bord Analytics sur le Hub Création.

Suivi des événements économiques

Pour déverrouiller le tableau de bord Économie, vous devez suivre quelques événements économiques dans votre expérience. Commencez en identifiant où les utilisateurs source (i.e. gagner) et sink (i.e. dépenser) les ressources dans votre expérience. Ces ressources sont représentées dans le code par Enum.AnalyticsEconomyFlowType

Les événements ne peuvent être envoyés que du serveur et dans les expériences publiées. Les événements ne peuvent pas être envoyés par le client ou Studio.

Type de transaction

Chaque événement source et d'évier exige un taperde transaction, codé avec Enum.AnalyticsEconomyTransactionType. Par défaut, les options sont :

IAP (source) - Les achats dans l'application échangeant des Robux contre des ressources, par exemple le kit de démarrage.
TimedReward (source) - Gagnez des ressources à l'horaire, par exemple, un bonus quotidien.
Onboarding (ressources lors du démarrage, par exemple, le bonus de bienvenue)
Shop (ressource ou source) - Échangez des ressources dans la boutique, par exemple l'acheterd'un article.
Gameplay (ressource ou source) - Gagnez ou dépensez des ressources du partie, par exemple la fin d'une quête.
ContextualPurchase (évier) - Dépensez des ressources sur un impulsion contextuelle, par exemple des vies supplémentaires.

Ces types apparaissent sur le tableau de bord. Il est une bonne idée de commencer par les catégories par défaut, mais si vous en avez besoin, vous pouvez également fournir vos propres noms de type de transaction lors de l'enregistrement d'un événement.

Suivi des sources

L'exemple suivant utilise AnalyticsService.LogEconomyEvent pour enregistrer deux événements économiques différents lorsque les utilisateurs terminent les premiers et les seconds niveaux dans l'expérience et gagnent des pièces.

Suivi d'un événement de jeu source
local AnalyticsService = game:GetService("AnalyticsService")

-- Après la fin du niveau 1
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins", -- Nom de la devise
    50, -- Montant gagné
    50, -- Balance actuelle
    Enum.AnalyticsEconomyTransactionType.Gameplay.Name -- taperde transaction
)

-- Après le niveau 2 de finition
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins", -- Nom de la devise
    50, -- Montant gagné
    100, -- Balance après la transaction
    Enum.AnalyticsEconomyTransactionType.Gameplay.Name -- taperde transaction
)

L'exemple suivant suit un achat de Robux d'un lotde 1000 pièces, en utilisant le taperde transaction IAP (acheterdans l'application). Le champ itemSKU est un paramètre facultatif ajouté ici pour comparer avec le précédent exemple. Si vous n'avez pas spécifié un itemSKU,

Suivre un acheterdans l'application
local AnalyticsService = game:GetService("AnalyticsService")

AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins",
    1000, -- Combien de pièces y sont-il dans le lot
    1020, -- Balance après la transaction
    Enum.AnalyticsEconomyTransactionType.IAP.Name,
    "1000CoinBundle" -- Identifiant unique SKU du lotde pièces
)

Suivi des éviers

Le code suivant affiche un événement lorsque les utilisateurs dépensent des pièces pour acheter un DoubleJumpUpgrade. Notez le type de Sink et le type de transaction Shop lorsque vous comparez les échantillons de suivi des sources.

Gardez à l'esprit que le montant (le coût) doit toujours être un nombre positif, peu importe si l'événement est une source ou une sortie. Les tableaux de bord économie afficheront automatiquement les sources comme des nombres négatifs.

Suivi d'un événement de jeu de piste
local AnalyticsService = game:GetService("AnalyticsService")

-- Après le niveau 2 de finition
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Sink,
    "Coins", -- Nom de la devise
    80, -- Prix
    20, -- Balance après la transaction
    Enum.AnalyticsEconomyTransactionType.Shop.Name,
    "DoubleJumpUpgrade" -- ID de l'article
)

Pour plus d'informations sur les AnalyticsService limitations, voir Class.AnalyticsService limitations de suivi des événements.

Utiliser des champs personnalisés

Les événements économie permettent également de décomposer des champs personnalisés pour prendre en charge une comparaison plus facile entre les segments. Par exemple, vous pouvez fournir des noms de quête à chaque événement pour voir lesquels les utilisateurs gagnent le plus d'argent, ou attacher des emplacements de magasin pour voir si les utilisateurs préfèrent un emplacement à un autre.

Vous pouvez décomposer en utilisant le sélecteur de décomposition.

A dropdown indicating the three custom fields you can compare across, along with standard breakdowns like age, gender, operating system and more.

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

Utiliser l'économie pour développer votre expérience

Le tableau de bord Économie inclut cinq graphiques pour vous aider à prendre des mesures pour améliorer vos revenus. Vous pouvez ajouter jusqu'à cinq ressources de devises, et tous les graphiques peuvent être filtrés par genre, groupe d'âge, plateforme, OS et jusqu'à trois champs personnalisés spécifiques à votre expérience.

Total de sources et de robinets par catégorie - Utilisez ce tableau pour équilibrer votre économie dans l'expérience. Total de sources soustraire les robinets totaux devraient être proches de zéro. Vous pouvez également voir vos meilleures sources et robinets par catégorie. Si votre total net est en croissance, envisagez d'ajouter plus de robinets.
Balance moyenne du portefeuille - Utilisez ce tableau pour voir combien de ressources les utilisateurs, les payeurs et les non-payeurs détiennent en moyenne. Si la balance moyenne augmente, surtout pour les payeurs, envisagez d'ajouter de nouveaux robinets.
Les meilleures sources et les éviers) - Utilisez-le pour identifier où vos utilisateurs gagnent et dépensent leurs ressources. Si les utilisateurs ne gagnent pas de ressources à partir des achats dans l'application, considérez-leur réduire les prix ou offrir de nouvelles options. Si les utilisateurs ne dépensent pas assez d'une ressource donnée, considérez-leur ajouter de nouveaux éviers.
Toutes les sources et éviers - Utilisez-le pour obtenir une vue combinée par catégorie pour la tranche de date sélectionnée.

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