AnalyticsService

非推奨を表示

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

作成できません
サービス
複製されていません

アナリティクスサービス は、開発者がユーザーが自分のエクスペリエンスとどのように対話するか、特にプレイヤーの進捗、エクスペリエンス経済、パイプライン、カスタムイベントを追跡できるようにするメソッドのコレクションです。

概要

方法

プロパティ

方法

LogCustomEvent

()

エクスペリエンス内のユーザーのカスタムメトリックを追跡するために使用されるイベントをログ。詳細は、カスタムイベント を参照してください。

パラメータ

player: Player

イベントをトリガーしたユーザー。

既定値: ""
eventName: string

カスタムイベントの名前。

既定値: ""
value: number

集計で使用されるイベントの値。

既定値: 1
customFields: Dictionary

Roblox が提供したチャートで概要を提供するカスタムフィールドのオプション辞書。特定のキー、提供者は Enum.AnalyticsCustomFieldKeys 、のみがこれらの分析に使用されます。エクスペリエンスごとの 3つのカスタムフィールドの値の独自の組み合わせは 8,000 に制限されます。

既定値: "nil"

戻り値

()

コードサンプル

This example uses AnalyticsService:LogCustomEvent() to log two custom events: MissionStarted and MissionCompletedDuration.

Log Custom Event

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

()

経験に関連するプレイヤーのアクションを追跡するために使用されるイベントをログします。

パラメータ

player: Player

イベントをトリガーしたユーザー。

既定値: ""

通貨が流れている方向を Enum.AnalyticsEconomyFlowType を使用して指定する必要があります。

既定値: ""
currencyType: string

例えば、"gold""gems"、または"energy"の通貨の名前が追加または削除されます。エクスペリエンスごとに 5種類のユニークな通貨タイプに制限。

既定値: ""
amount: number

追加または削除される通貨の量。この値は常に正のものでなければなりません。

既定値: ""
endingBalance: number

通貨が追加または削除された後のユーザーの残高。この値は常に 0 より大きいか、等しい値でなければなりません。

既定値: ""
transactionType: string

発生した取引の種入力。どの取引タイプを使用しても自由ですが、 などの提供されたタイプを使用すると、Roblox ツールとチャートから将来の洞察を有効にすることができます。

このフィールドタイプが文字列であるため、枚挙の Name 値をパスする必要があります。例えば Enum.AnalyticsEconomyTransactionType.IAP.Name

エクスペリエンスごとに 20種類まで限定。

既定値: ""
itemSku: string

購入されるアイテムまたはバンドルのオプションの SKU。これは購入されるアイテムの唯一の識別子です。エクスペリエンスごとに 100 個のユニークな SKU に制限されます。

既定値: ""
customFields: Dictionary

Roblox が提供したチャートで概要を提供するカスタムフィールドのオプション辞書。特定のキー、提供者は Enum.AnalyticsCustomFieldKeys 、のみがこれらの分析に使用されます。エクスペリエンスごとの 3つのカスタムフィールドの値の独自の組み合わせは 8,000 に制限されます。

既定値: "nil"

戻り値

()

コードサンプル

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.

Tracking an in-app purchase

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

()

事前に計画されたパイプラインを通過するユーザーアクションを追跡するために使用されるイベントをログします。ファネルの分解は、ファネルセッションの最初のステップでのユーザーとイベントの値を考慮するだけです。

パラメータ

player: Player

イベントをトリガーしたユーザー。

既定値: ""
funnelName: string

ファネルの名前。これは、ファネルのすべてのステップで同じである必要があります。経験ごとに 10 個のユニークなファネルに制限されます。

既定値: ""
funnelSessionId: string

ファネルセッションのオプションユニーク識別子。これは、ファネルのすべてのステップで同じである必要があります。

このフィールドは、例えば購入フローパイプラインまたはアイテムアップグレードパイプラインのような 繰り返し のファネルにのみ必要です。自然なファネルセッション識別子がない場合は、HttpService:GenerateGUID() を使用することをお勧めします。

既定値: ""
step: number

ファネルのステップ番号。これは、ファネルの各ステップでユニークでなければなりません。すべてのファネルはステップ 1 で始まります。1-100ステップまで限定されます。

同じユーザーが同じファネルセッションで繰り返したステップ、または funnelSessionIdnil になると、無視されます。

ステップをスキップすると、中間のステップが完了したとみなされます。

既定値: 1
stepName: string

ファネルのステップのオプション名。このフィールドは、Roblox が提供したチャートでの表示目的にのみ使用されます。

既定値: ""
customFields: Dictionary

Roblox が提供したチャートで概要を提供するカスタムフィールドのオプション辞書。特定のキー、提供者は Enum.AnalyticsCustomFieldKeys 、のみがこれらの分析に使用されます。エクスペリエンスごとの 3つのカスタムフィールドの値の独自の組み合わせは 8,000 に制限されます。

既定値: "nil"

戻り値

()

コードサンプル

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.

Tracking Shop steps

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

()

オンボーディングファネルを通過するユーザーアクションを追跡するのに使用されるイベントをログします。ファネルの分解は、ファネルセッションの最初のステップでのユーザーとイベントの値を考慮するだけです。

パラメータ

player: Player

イベントをトリガーしたユーザー。

既定値: ""
step: number

ファネルのステップ番号。これは、ファネルの各ステップでユニークでなければなりません。すべてのファネルはステップ 1 で始まります。1-100ステップまで限定されます。

ステップをスキップすると、中間のステップが完了したとみなされます。

既定値: ""
stepName: string

ファネルのステップのオプション名。このフィールドは、Roblox が提供したチャートでの表示目的にのみ使用されます。

既定値: ""
customFields: Dictionary

Roblox が提供したチャートで概要を提供するカスタムフィールドのオプション辞書。特定のキー、提供者は Enum.AnalyticsCustomFieldKeys 、のみがこれらの分析に使用されます。エクスペリエンスごとの 3つのカスタムフィールドの値の独自の組み合わせは 8,000 に制限されます。

既定値: "nil"

戻り値

()

コードサンプル

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.

Tracking onboarding steps

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 が提供するチャートで表示されていない。

パラメータ

player: Player

イベントをトリガーしたプレイヤー。

既定値: ""
progressionPathName: string
既定値: ""
level: number
既定値: ""
levelName: string
既定値: ""
customFields: Dictionary
既定値: "nil"

戻り値

()

LogProgressionEvent

()

ユーザーがレベル試行を開始、完了、または失敗したときに発生するイベントをログします。このイベントは、現在、Roblox が提供するチャートで表示されていません。

パラメータ

player: Player

イベントをトリガーしたプレイヤー。

既定値: ""
progressionPathName: string
既定値: ""
既定値: ""
level: number
既定値: ""
levelName: string
既定値: ""
customFields: Dictionary
既定値: "nil"

戻り値

()

LogProgressionFailEvent

()

ユーザーがレベル試行に失敗したときにイベントをログする。このイベントは、現在、Roblox が提供するチャートで表示されていない。

パラメータ

player: Player

イベントをトリガーしたユーザー。

既定値: ""
progressionPathName: string
既定値: ""
level: number
既定値: ""
levelName: string
既定値: ""
customFields: Dictionary
既定値: "nil"

戻り値

()

LogProgressionStartEvent

()

ユーザーがレベル試行を開始したときにイベントをログする。このイベントは、現在、Roblox が提供するチャートで表示されていない。

パラメータ

player: Player

イベントをトリガーしたプレイヤー。

既定値: ""
progressionPathName: string
既定値: ""
level: number
既定値: ""
levelName: string
既定値: ""
customFields: Dictionary
既定値: "nil"

戻り値

()

イベント