經濟事件

經濟事件 讓您追蹤遊戲內的經濟，例如：

• 主要消耗 — 用戶在遊戲中花費資源的地方是什麼？
• 主要來源 — 用戶在哪裡獲得資源？
• 平均錢包餘額 — 用戶持有多少資源？

一旦您的遊戲開始追蹤經濟事件，您將解鎖創作者中心的分析儀表板中的經濟頁面。

追蹤經濟事件

要解鎖經濟儀表板，您需要在遊戲中追蹤一些經濟事件。首先，確定用戶在遊戲中 來源（即獲得）和 消耗（即花費）資源的地方。這些在代碼中由 Enum.AnalyticsEconomyFlowType 表示，可以是 Source 或 Sink。

交易類型

每個來源和消耗事件都需要一個交易類型，使用 Enum.AnalyticsEconomyTransactionType 編碼。默認選項為：

• IAP（來源） - 內部購買將 Robux 兌換為資源，例如啟動包。
• TimedReward（來源） - 按計劃獲得資源，例如每日獎勵。
• Onboarding（來源） - 開始時獲得資源，例如歡迎獎勵。
• Shop（來源或消耗） - 在商店中交易資源，例如物品購買。
• Gameplay（來源或消耗） - 從遊戲中獲得或花費資源，例如任務完成。
• ContextualPurchase（消耗） - 在特定情境下花費資源，例如額外生命。

這些類型會顯示在儀表板上。建議從默認類別開始，但如果需要，您也可以在記錄事件時提供自己的交易類型名稱。

追蹤來源

以下範例使用 AnalyticsService.LogEconomyEvent 在用戶完成遊戲中的第一和第二關卡並獲得一些硬幣時記錄兩個不同的經濟事件。

local AnalyticsService = game:GetService("AnalyticsService")

-- 完成第一關後
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins", -- 貨幣名稱
    50, -- 獲得的數量
    50, -- 當前餘額
    Enum.AnalyticsEconomyTransactionType.Gameplay.Name -- 交易類型
)

-- 完成第二關後
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Source,
    "Coins", -- 貨幣名稱
    50, -- 獲得的數量
    100, -- 交易後餘額
    Enum.AnalyticsEconomyTransactionType.Gameplay.Name -- 交易類型
)

以下範例追蹤以 IAP（內部購買）交易類型購買 1000 硬幣包的 Robux，這次使用 itemSKU，即您對該物品的唯一標識符。itemSKU 是可選的。如果不指定，經濟儀表板在來源和消耗表中顯示 N/A。

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")

-- 完成第二關後
AnalyticsService:LogEconomyEvent(
    player,
    Enum.AnalyticsEconomyFlowType.Sink,
    "Coins", -- 貨幣名稱
    80, -- 成本
    20, -- 交易後餘額
    Enum.AnalyticsEconomyTransactionType.Shop.Name,
    "DoubleJumpUpgrade" -- 項目 SKU
)

有關 AnalyticsService 限制的資訊，請參見 事件追蹤限制。

使用自定義字段

經濟事件還允許使用自定義字段進行細分，以支持不同區段之間的更輕鬆比較。例如，您可以為每個事件提供任務名稱，以查看用戶從哪些任務中賺取最多的錢，或附加商店位置以查看用戶是否偏好某個位置。

您可以使用細分選擇器按自定義字段進行細分。

有關更多資訊，請參見 自定義字段。

使用經濟來增長您的遊戲

經濟儀表板包括五個圖表，幫助您採取行動以增長收入。您可以添加最多五種資源貨幣，所有圖表都可以按各種用戶類別（性別、年齡、平台等）和最多三個特定於您遊戲的自定義字段進行過濾。

• 按類別的總來源和消耗 - 使用此圖表來平衡您的遊戲內經濟。總來源減去總消耗應接近零。您還可以查看按類別劃分的主要來源和消耗。如果您的淨總額在增長，考慮增加更多消耗。

  

• 平均錢包餘額 - 使用此圖表查看用戶、付款者和非付款者的平均資源持有量。如果平均餘額在增長，特別是對於付款者，考慮增加新的消耗。

  

• 主要來源和消耗 - 使用此圖表識別用戶獲得和花費資源的地方。如果用戶沒有從內部購買中獲得資源，考慮降低價格或提供新選項。如果用戶沒有花費足夠的特定資源，考慮為該資源增加新的消耗。

  

• 所有來源和消耗 - 使用此圖表獲得所選日期範圍內的按類別的綜合視圖。

  

有關如何平衡您的遊戲內經濟的更多提示，請參見 平衡虛擬經濟。