エコノミーイベント | 文書 - Roblox クリエーターハブ

エコノミーイベントは、次のようなインエクスペリエンスエコノミーを追跡できます：

トップシンクス — ユーザーはエクスペリエンス中に資源をどこで過ごしますか？
トップソース — ユーザーは資源をどこで獲得しますか？
平均ウォレットバランス — ユーザーが持っている資源の平均

エクスペリエンスがエコノミーイベントを追跡するようになクリエーターハブと、クリエイターハブのアナリティクスダッシュボードのエコノミーページをアンロックします。

経済イベントを追跡する

エコノミーダッシュボードをアンロックするには、エコノミーイベントをエクスペリエンスでトラックする必要があります。ユーザーがソース (獲得) および沈み (消費) リソースをエクスペリエンス

イベントは、サーバーからのみ、公開されたエクスペリエンスでのみ送信できます。イベントは、クライアントまたは Studio から送信できません。

取引タイプ

各ソースとシンクイベントには、Enum.AnalyticsEconomyTransactionType でエンコードされた取引タイプが必要です。デフォルトでは、オプションは次のとおりです：

IAP (ソース) - アプリ内購入は、Robux を資源と交換します。たとえば、スターターパック。
TimedReward (ソース) - スケジュールで資源を獲得するなど、毎日のボーナスなど。
Onboarding (ソース) - 始まりのときに資源を取得します。たとえば、ようこそのボーナス。
Shop (ソースまたはシンク) - ショップで資源を取引します。たとえば、アイテムの購入。
Gameplay (ソースまたはシンク) - ゲームプレイから資源を獲得または消費します。たとえば、クエスト完了。
ContextualPurchase (シンク) - コンテキスト特定のインパルスに資源を消費します。たとえば、追加のライフです。

これらのタイプはダッシュボードに表示されます。デフォルトのカテゴリに沿って開始するのが良いですが、イベントをログするときには、独自のトランザクションタイプ名を提供することもできます。

ソースを追跡する

次のサンプルは、AnalyticsService.LogEconomyEvent を使用して、ユーザーがエクスペリエンスの最初の 2つのレベルを完了し、コインを獲得するときに 2つの異なるエコノミーイベントをログすることができます。

ソースのゲームプレイイベントを追跡する
local AnalyticsService = game:GetService("AnalyticsService")

-- レベル 1 の完了後
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins", -- 通貨名
    50, -- 獲得した金額
    50, -- 現在の残高ランス
    Enum.AnalyticsEconomyTransactionType.Gameplay.Name -- 取引入力イプ
)

-- レベル 2 完了後
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins", -- 通貨名
    50, -- 獲得した金額
    100, -- 取引後の残高
    Enum.AnalyticsEconomyTransactionType.Gameplay.Name -- 取引入力イプ
)

次のサンプルは、1000コインバンドルの Robux 購入を追跡します。IAP (アプリ内購入) 取引タイプを使用しています。itemSKU フィールドは、前のサンプルと比較してオプションパラメータとし

アプリ内購入を追跡する
local AnalyticsService = game:GetService("AnalyticsService")

AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins",
    1000, -- バンドルにはいくつのコインがありますか
    1020, -- 取引後の残高
    Enum.AnalyticsEconomyTransactionType.IAP.Name,
    "1000CoinBundle" -- コインバンドルのユニークなアイテムの SKU 識別子
)

トラッキングシンク

次のサンプルログは、ユーザーがコインを使用して DoubleJumpUpgrade を購入するイベントです。Sink フロータイプと Shop トランザクションタイプを比較して、ソーストラッキングサンプルと比較してください。

イベントがソースか汚れ水かを問わず、金額 (コスト) は常に正の数字でなければなりません。エコノミーダッシュボードのチャートは、汚れ水を正の数字として自動的に表示します。

シンクのゲームプレイイベントを追跡する
local AnalyticsService = game:GetService("AnalyticsService")

-- レベル 2 完了後
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Sink,
    "Coins", -- 通貨名
    80, -- コスト
    20, -- 取引後の残高
    Enum.AnalyticsEconomyTransactionType.Shop.Name,
    "DoubleJumpUpgrade" -- アイテムの SKU
)

For information on AnalyticsService 限定については、イベント追跡の制限を参照してください。

カスタムフィールドを使用する

エコノミーイベントは、ユーザーが最もお金を稼いでいるセグメントを比較しやすくするために、カスタムフィールドを分解することもできます。たとえば、ユーザーが最もお金を稼いでいるセグメントを比較するために、各イベントにクエスト名を提供したり、ストア場所を提示したりできます。

選択器を使用してカスタムフィールドを分解することで、分解できます。

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

詳しくは、カスタムフィールドを参照してください。

エコノミーを使用してエクスペリエンスを成長させる

エコノミーダッシュボードには、収益を増やすための5つのチャートが含まれています。最大5つの資源の通貨を追加でき、すべてのチャートは性別、年齢グループ、プラットフォーム、OS、および最大3つのカスタムフィールドでフィルターできます。

カテゴリ별の総ソースと給水 - このチャートを使用して、エクスペリエンス内の経済を調整します。総ソースは、経験内の経済を減算する必要があります。上位のソースと給水は、経験内の経済を減算する必要があります。経営が成長している場合は、給水を追加す
平均ウォレットバランス - このチャートを使用して、ユーザー、支払い者、非支払者の平均持有を見る。平均バランスが成長している場合、特に支払い者の場合、新しいシンクを追加することを検討してください。
トップソースとシンクス - これを使用して、ユーザーがリソースをどこで獲得し、どこでそれらを使用するかを識別します。ユーザーがアプリ内購入からリソースを獲得している場合は、価格を減少するか、新しいオプションを提供することを検討してください。ユーザーが指定したリソースを十分に使用していない場合は、
すべてのソースとシンク - これを使用して、選択した日付の範囲についてカテゴリごとに統合ビューを取得します。

エクスペリエンスエコノミーのバランスについての詳細は、「バランシングバーチャルエコノミー」を参照してください。