AnalyticsService
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
アナリティクスサービス は、開発者がユーザーがエクスペリエンスとどのようにインタラクトするかを追跡できるメソッドのコレクションで、特にプレイヤーの進行状況、インエクスペリエンスエコノミー、ファンネル、カスタムイベントを追跡できます。
概要
方法
ユーザーのエクスペリエンスでカスタムメトリックを追跡するために使用されるイベントをログします。
- LogEconomyEvent(player : Player,flowType : Enum.AnalyticsEconomyFlowType,currencyType : string,amount : number,endingBalance : number,transactionType : string,itemSku : string,customFields : Dictionary):void
プレイヤーのアクションに関連するエクスペリエンストラッキング用のイベントをログします。
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):void
プランナーされたコースを踏み出すユーザーのアクションを追跡するイベントをログします。
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):void
ユーザーがオンボーディングファンネルを踏み出すときに使用されるイベントをログします。
- LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
ユーザーがレベルの試試行を完了したときにイベントをログします。
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):void
ユーザーが開始、完了、またはレベルの試行に失敗したときにイベントをログする。
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
ユーザーがレベルの試行に失敗したときにイベントをログします。
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
ユーザーがレベルの試行を開始したときにイベントをログします。
プロパティ
方法
LogCustomEvent
ユーザーのエクスペリエンスでカスタムメトリックを追跡するために使用されるイベントをログします。詳細は、「カスタムイベント」を参照してください。
パラメータ
イベントをトリガーしたユーザー。
カスタムイベントの名前。
集計に使用するイベントの値。
Roblox によって提供されたチャートで分析を提供するためのオプションの辞典。特定のキーのみ、Enum.AnalyticsCustomFieldKeys によって使用されます。これらの分析には、エクスペリエンスごとに 3つのカスタムフィールドの 8,000 個のユニークな組み合わせのみ使用されます。
戻り値
コードサンプル
This example uses AnalyticsService:LogCustomEvent() to log two custom events: MissionStarted and MissionCompletedDuration.
local AnalyticsService = game:GetService("AnalyticsService")
-- Log when the mission starts
AnalyticsService:LogCustomEvent(
player,
"MissionStarted" -- Custom event name
)
-- Log when the mission is completed with the time it took
AnalyticsService:LogCustomEvent(
player,
"MissionCompletedDuration", -- Custom event name
120 -- Event value used in aggregation
)
LogEconomyEvent
プレイヤーのアクションに関連するエクスペリエンストラッキング用のイベントをログします。
パラメータ
イベントをトリガーしたユーザー。
Currency.AnalyticsEconomyFlowType を使用して、通貨が流れる方向を指定する必要があります。
追加または削除される通貨の名前、例えば "gold" 、 "gems" 、または "energy" 。エクスペリエンスごとに 5つのユニークな通貨タイプに制限されています。
通貨の追加または削除量。この値は常に正の値でなければなりません。
通貨が追加されたまたは削除された後のユーザーの残高。この値は常に 0 より大きいまたは等しい必要があります。
発生したトランザクションの種入力。あなたはどのトランザクションタイプを使用することが自由ですが、Enum.AnalyticsEconomyTransactionType や "IAP" など、Roblox ツールやグラフィックから将来の洞察を有効にするために提供されているタイプを使用することをお勧めします。
このフィールドタイプがストリングであるため、枚数の Name 値を取得する必要があります。たとえば Enum.AnalyticsEconomyTransactionType.IAP.Name 。
エクスペリエンスごとに 20 種類のユニークなタイプに制限あり。
アイテムまたはバンドルを購入するオプションのSKU。これは、アイテムを購入するユニークな識別子です。1つのエクスペリエンスにつき、100個のユニークなSKUに制限されています。
Roblox によって提供されたチャートで分析を提供するためのオプションの辞典。特定のキーのみ、Enum.AnalyticsCustomFieldKeys によって使用されます。これらの分析には、エクスペリエンスごとに 3つのカスタムフィールドの 8,000 個のユニークな組み合わせのみ使用されます。
戻り値
コードサンプル
The following sample tracks a Robux purchase of a 1000-coin bundle, using the IAP (in-app purchase) transaction type. Note the item name provided as an optional parameter when compared to the previous sample.
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"Coins",
1000, -- How many coins are in the bundle
1020, -- balance after transaction
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- Unique identifier of the coin bundle
)
LogFunnelStepEvent
ユーザーがプレースホルダーを踏みながら進行するユーザーアクションを追跡するイベントをログします。ファネルの壊れたバーチャル空間の内のユーザーとイベントの値は、ユーザーアクションの進行セッション況にのみ対応します。
パラメータ
イベントをトリガーしたユーザー。
煙突の名前です。これは、煙突のすべてのステップで同じです。経験ごとに 10 個のユニークな煙突に制限されています。
ファネルセッションのユニークな識別子。これは、ファネル内のすべてのステップで同じである必要があります。
注意、このフィールドは 再度 ファンネルにのみ必要です。たとえば、購入フローファンネルまたはアイテムのアップグレードファンネルなどです。自然なファンネルセッション識別子がない場合は、HttpService:GenerateGUID() を使用することをお勧めします。
ファネル内のステップ番号。これは、ファネル内の各ステップにユニークです。すべてのファネルは、ステップ 1 から始まります。1-100までのみまでのステップに限定されています。
同じユーザーが同じファンネルセッションで繰り返しているステップ、または funnelSessionId が nil になると、無視されます。
ステップをスキップすると、中間ステップが完了したとみなされます。
ファネル内のステップのオプション名。このフィールドは、Roblox が提供するチャートのみで表示目的で使用されます。
Roblox によって提供されたチャートで分析を提供するためのオプションの辞典。特定のキーのみ、Enum.AnalyticsCustomFieldKeys によって使用されます。これらの分析には、エクスペリエンスごとに 3つのカスタムフィールドの 8,000 個のユニークな組み合わせのみ使用されます。
戻り値
コードサンプル
The following sample tracks some basic events for each user beginning the process to buy an item from an "armory" shop. Note the funnelSessionId used to distinguish between different sessions of the same user opening the shop.
local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
funnelSessionId = HttpService:GenerateGUID()
-- Log when the user opens the store
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Funnel name used to group steps together
funnelSessionId, -- Funnel session id for this unique checkout session
1, -- Step number
"Opened Store" -- Step name
)
-- Log when the user views an item
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Funnel name used to group steps together
funnelSessionId, -- Funnel session id for this unique checkout session
2, -- Step number
"Viewed Item" -- Step name
)
-- Log when the user views adds to cart
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Funnel name used to group steps together
funnelSessionId, -- Funnel session id for this unique checkout session
3, -- Step number
"Added to Cart" -- Step name
)
LogOnboardingFunnelStepEvent
ユーザーがオンボーディングファンネルを踏み出すたびに記録するイベントをログします。ファンネルの壊れたところでは、ユーザーとイベントの値のみがオンボーディングセッションの最初のステップから検討されます。
パラメータ
イベントをトリガーしたユーザー。
ファネル内のステップ番号。これは、ファネル内の各ステップにユニークです。すべてのファネルは、ステップ 1 から始まります。1-100までのみまでのステップに限定されています。
ステップをスキップすると、中間ステップが完了したとみなされます。
ファネル内のステップのオプション名。このフィールドは、Roblox が提供するチャートのみで表示目的で使用されます。
Roblox によって提供されたチャートで分析を提供するためのオプションの辞典。特定のキーのみ、Enum.AnalyticsCustomFieldKeys によって使用されます。これらの分析には、エクスペリエンスごとに 3つのカスタムフィールドの 8,000 個のユニークな組み合わせのみ使用されます。
戻り値
コードサンプル
The following sample demonstrates how to log two steps of an onboarding funnel. An onboarding funnel typically introduces players to the game's core loop.
local AnalyticsService = game:GetService("AnalyticsService")
-- Log the first step of the FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- Step number
"Joined Game" -- Step name
)
-- Log the second step of the FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- Step number
"Choose Class" -- Step name
)
LogProgressionCompleteEvent
ユーザーがレベルの試行を完了したときにイベントをログする。このイベントは、Roblox が提供するチャートには現在表示されません。
パラメータ
イベントをトリガーしたプレイヤー。
戻り値
LogProgressionEvent
ユーザーがレベルの試行を開始、完了、または失敗したときにイベントをログに記録します。このイベントは、Roblox が提供するチャートには現在表示されません。
パラメータ
イベントをトリガーしたプレイヤー。
戻り値
LogProgressionFailEvent
ユーザーがレベルの試行に失敗したときにイベントをログする。このイベントは、Roblox が提供するチャートには現在表示されません。
パラメータ
イベントをトリガーしたユーザー。
戻り値
LogProgressionStartEvent
ユーザーがレベルの試行を開始したときにイベントをログします。このイベントは、Roblox が提供するチャートには現在表示されません。
パラメータ
イベントをトリガーしたプレイヤー。