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 に制限されます。
戻り値
コードサンプル
次のサンプルは、IAP (アプリ内購入) トランザクションタイプを使用して、1000コインバンドルの Robux 購入を追跡します。前のサンプルと比較して、オプションパラメータとして提供されたアイテム名を注意してください。
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"Coins",
1000, -- バンドルにコインが何枚あるか
1020, -- 取引後の残高
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- コインバンドルのユニークな識別子
)LogFunnelStepEvent
事前に計画されたパイプラインを通過するユーザーアクションを追跡するために使用されるイベントをログします。ファネルの分解は、ファネルセッションの最初のステップでのユーザーとイベントの値を考慮するだけです。
パラメータ
イベントをトリガーしたユーザー。
ファネルの名前。これは、ファネルのすべてのステップで同じである必要があります。経験ごとに 10 個のユニークなファネルに制限されます。
ファネルセッションのオプションユニーク識別子。これは、ファネルのすべてのステップで同じである必要があります。
このフィールドは、例えば購入フローパイプラインまたはアイテムアップグレードパイプラインのような 繰り返し のファネルにのみ必要です。自然なファネルセッション識別子がない場合は、HttpService:GenerateGUID() を使用することをお勧めします。
ファネルのステップ番号。これは、ファネルの各ステップでユニークでなければなりません。すべてのファネルはステップ 1 で始まります。1-100ステップまで限定されます。
同じユーザーが同じファネルセッションで繰り返したステップ、または funnelSessionId が nil になると、無視されます。
ステップをスキップすると、中間のステップが完了したとみなされます。
ファネルのステップのオプション名。このフィールドは、Roblox が提供したチャートでの表示目的にのみ使用されます。
Roblox が提供したチャートで概要を提供するカスタムフィールドのオプション辞書。特定のキー、提供者は Enum.AnalyticsCustomFieldKeys 、のみがこれらの分析に使用されます。エクスペリエンスごとの 3つのカスタムフィールドの値の独自の組み合わせは 8,000 に制限されます。
戻り値
コードサンプル
次のサンプルでは、「武器庫」ショップからアイテムを購入するプロセスを開始する各ユーザーの基本イベントをいくつか示します。ショップを開いている同じユーザーの異なるセッションを区別するために使用される funnelSessionId を注意してください。
local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
funnelSessionId = HttpService:GenerateGUID()
-- ユーザーがストアを開いたときにログを記録する
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- ステップをグループ化するために使用されるファネル名
funnelSessionId, -- このユニークなチェックアウトセッションのためのファネルセッションID
1, -- ステップ番号
"Opened Store" -- ステップ名
)
-- ユーザーがアイテムを表示したときにログを記録する
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- ステップをグループ化するために使用されるファネル名
funnelSessionId, -- このユニークなチェックアウトセッションのためのファネルセッションID
2, -- ステップ番号
"Viewed Item" -- ステップ名
)
-- ユーザービューがカートに追加されたときにログを記録する
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- ステップをグループ化するために使用されるファネル名
funnelSessionId, -- このユニークなチェックアウトセッションのためのファネルセッションID
3, -- ステップ番号
"Added to Cart" -- ステップ名
)LogOnboardingFunnelStepEvent
オンボーディングファネルを通過するユーザーアクションを追跡するのに使用されるイベントをログします。ファネルの分解は、ファネルセッションの最初のステップでのユーザーとイベントの値を考慮するだけです。
パラメータ
イベントをトリガーしたユーザー。
ファネルのステップ番号。これは、ファネルの各ステップでユニークでなければなりません。すべてのファネルはステップ 1 で始まります。1-100ステップまで限定されます。
ステップをスキップすると、中間のステップが完了したとみなされます。
ファネルのステップのオプション名。このフィールドは、Roblox が提供したチャートでの表示目的にのみ使用されます。
Roblox が提供したチャートで概要を提供するカスタムフィールドのオプション辞書。特定のキー、提供者は Enum.AnalyticsCustomFieldKeys 、のみがこれらの分析に使用されます。エクスペリエンスごとの 3つのカスタムフィールドの値の独自の組み合わせは 8,000 に制限されます。
戻り値
コードサンプル
次のサンプルでは、オンボーディングファネルの 2 ステップをログする方法を示しています。オンボーディングファネルは通常、プレイヤーをゲームのコアループに紹介します。
local AnalyticsService = game:GetService("AnalyticsService")
-- FTUE の最初のステップをログ
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- ステップ番号
"Joined Game" -- ステップ名
)
-- FTUE の 2番目のステップをログする
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- ステップ番号
"Choose Class" -- ステップ名
)LogProgressionCompleteEvent
ユーザーがレベル試行を完了したときにイベントをログする。このイベントは、現在、Roblox が提供するチャートで表示されていない。
パラメータ
イベントをトリガーしたプレイヤー。
戻り値
LogProgressionEvent
ユーザーがレベル試行を開始、完了、または失敗したときに発生するイベントをログします。このイベントは、現在、Roblox が提供するチャートで表示されていません。
パラメータ
イベントをトリガーしたプレイヤー。
戻り値
LogProgressionFailEvent
ユーザーがレベル試行に失敗したときにイベントをログする。このイベントは、現在、Roblox が提供するチャートで表示されていない。
パラメータ
イベントをトリガーしたユーザー。
戻り値
LogProgressionStartEvent
ユーザーがレベル試行を開始したときにイベントをログする。このイベントは、現在、Roblox が提供するチャートで表示されていない。
パラメータ
イベントをトリガーしたプレイヤー。