AnalyticsService
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
アナリティクスサービス は、開発者がユーザーが自分のエクスペリエンスとどのように対話するか、特にプレイヤーの進捗、エクスペリエンス経済、パイプライン、カスタムイベントを追跡できるようにするメソッドのコレクションです。
概要
方法
エクスペリエンスでユーザーのカスタムメトリックを追跡するために使用されるイベントをログします。
- LogEconomyEvent(player : Player,flowType : Enum.AnalyticsEconomyFlowType,currencyType : string,amount : number,endingBalance : number,transactionType : string,itemSku : string,customFields : Dictionary):()
経験に関連するプレイヤーのアクションを追跡するために使用されるイベントをログします。
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):()
事前に計画されたパイプラインを通過するユーザーアクションを追跡するために使用されるイベントをログします。
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):()
オンボーディングファネルを通過するユーザーアクションを追跡するのに使用されるイベントをログします。
- LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
ユーザーがレベル試行を完了したときにイベントをログする。
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):()
ユーザーがレベル試行を開始、完了、または失敗したときにイベントをログする。
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
ユーザーがレベル試行に失敗したときにイベントをログする。
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
ユーザーがレベル試行を開始したときにイベントをログする。
プロパティ
方法
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
経験に関連するプレイヤーのアクションを追跡するために使用されるイベントをログします。
パラメータ
イベントをトリガーしたユーザー。
通貨が流れている方向を Enum.AnalyticsEconomyFlowType を使用して指定する必要があります。
例えば、"gold"、"gems"、または"energy"の通貨の名前が追加または削除されます。エクスペリエンスごとに 5種類のユニークな通貨タイプに制限。
追加または削除される通貨の量。この値は常に正のものでなければなりません。
通貨が追加または削除された後のユーザーの残高。この値は常に 0 より大きいか、等しい値でなければなりません。
発生した取引の種入力。どの取引タイプを使用しても自由ですが、 などの提供されたタイプを使用すると、Roblox ツールとチャートから将来の洞察を有効にすることができます。
このフィールドタイプが文字列であるため、枚挙の Name 値をパスする必要があります。例えば Enum.AnalyticsEconomyTransactionType.IAP.Name 。
エクスペリエンスごとに 20種類まで限定。
購入されるアイテムまたはバンドルのオプションの SKU。これは購入されるアイテムの唯一の識別子です。エクスペリエンスごとに 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 が提供するチャートで表示されていない。
パラメータ
イベントをトリガーしたプレイヤー。