AnalyticsService

非推奨を表示

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

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

アナリティクスサービス は、開発者がユーザーがエクスペリエンスとどのようにインタラクトするかを追跡できるメソッドのコレクションで、特にプレイヤーの進行状況、インエクスペリエンスエコノミー、ファンネル、カスタムイベントを追跡できます。

概要

方法

プロパティ

方法

LogCustomEvent

void

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

パラメータ

player: Player

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

eventName: string

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

value: number

集計に使用するイベントの値。

既定値: 1
customFields: Dictionary

Roblox によって提供されたチャートで分析を提供するためのオプションの辞典。特定のキーのみ、Enum.AnalyticsCustomFieldKeys によって使用されます。これらの分析には、エクスペリエンスごとに 3つのカスタムフィールドの 8,000 個のユニークな組み合わせのみ使用されます。

既定値: "nil"

戻り値

void

コードサンプル

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

void

プレイヤーのアクションに関連するエクスペリエンストラッキング用のイベントをログします。

パラメータ

player: Player

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

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

currencyType: string

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

amount: number

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

endingBalance: number

通貨が追加されたまたは削除された後のユーザーの残高。この値は常に 0 より大きいまたは等しい必要があります。

transactionType: string

発生したトランザクションの種入力。あなたはどのトランザクションタイプを使用することが自由ですが、Enum.AnalyticsEconomyTransactionType"IAP" など、Roblox ツールやグラフィックから将来の洞察を有効にするために提供されているタイプを使用することをお勧めします。

このフィールドタイプがストリングであるため、枚数の Name 値を取得する必要があります。たとえば Enum.AnalyticsEconomyTransactionType.IAP.Name

エクスペリエンスごとに 20 種類のユニークなタイプに制限あり。

itemSku: string

アイテムまたはバンドルを購入するオプションのSKU。これは、アイテムを購入するユニークな識別子です。1つのエクスペリエンスにつき、100個のユニークなSKUに制限されています。

既定値: ""
customFields: Dictionary

Roblox によって提供されたチャートで分析を提供するためのオプションの辞典。特定のキーのみ、Enum.AnalyticsCustomFieldKeys によって使用されます。これらの分析には、エクスペリエンスごとに 3つのカスタムフィールドの 8,000 個のユニークな組み合わせのみ使用されます。

既定値: "nil"

戻り値

void

コードサンプル

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

void

ユーザーがプレースホルダーを踏みながら進行するユーザーアクションを追跡するイベントをログします。ファネルの壊れたバーチャル空間の内のユーザーとイベントの値は、ユーザーアクションの進行セッション況にのみ対応します。

パラメータ

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"

戻り値

void

コードサンプル

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

void

ユーザーがオンボーディングファンネルを踏み出すたびに記録するイベントをログします。ファンネルの壊れたところでは、ユーザーとイベントの値のみがオンボーディングセッションの最初のステップから検討されます。

パラメータ

player: Player

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

step: number

ファネル内のステップ番号。これは、ファネル内の各ステップにユニークです。すべてのファネルは、ステップ 1 から始まります。1-100までのみまでのステップに限定されています。

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

stepName: string

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

既定値: ""
customFields: Dictionary

Roblox によって提供されたチャートで分析を提供するためのオプションの辞典。特定のキーのみ、Enum.AnalyticsCustomFieldKeys によって使用されます。これらの分析には、エクスペリエンスごとに 3つのカスタムフィールドの 8,000 個のユニークな組み合わせのみ使用されます。

既定値: "nil"

戻り値

void

コードサンプル

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

void

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

パラメータ

player: Player

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

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

戻り値

void

LogProgressionEvent

void

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

パラメータ

player: Player

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

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

戻り値

void

LogProgressionFailEvent

void

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

パラメータ

player: Player

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

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

戻り値

void

LogProgressionStartEvent

void

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

パラメータ

player: Player

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

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

戻り値

void

イベント