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
()
パラメータ
戻り値
()
コードサンプル
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
()
パラメータ
既定値: ""
既定値: ""
既定値: ""
既定値: ""
既定値: ""
既定値: ""
既定値: ""
既定値: "nil"
戻り値
()
コードサンプル
アプリ内購入の追跡
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"Coins",
1000, -- バンドルにコインが何枚あるか
1020, -- 取引後の残高
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- コインバンドルのユニークな識別子
)
LogFunnelStepEvent
()
パラメータ
既定値: ""
既定値: ""
既定値: ""
既定値: 1
既定値: ""
既定値: "nil"
戻り値
()
コードサンプル
ショップステップの追跡
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
()
パラメータ
戻り値
()
コードサンプル
オンボーディングステップの追跡
local AnalyticsService = game:GetService("AnalyticsService")
-- FTUE の最初のステップをログ
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- ステップ番号
"Joined Game" -- ステップ名
)
-- FTUE の 2番目のステップをログする
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- ステップ番号
"Choose Class" -- ステップ名
)
LogProgressionCompleteEvent
()
パラメータ
既定値: ""
既定値: ""
既定値: ""
既定値: ""
既定値: "nil"
戻り値
()
LogProgressionEvent
()
パラメータ
既定値: ""
既定値: ""
既定値: ""
既定値: ""
既定値: ""
既定値: "nil"
戻り値
()
LogProgressionFailEvent
()
パラメータ
既定値: ""
既定値: ""
既定値: ""
既定値: ""
既定値: "nil"
戻り値
()
LogProgressionStartEvent
()
パラメータ
既定値: ""
既定値: ""
既定値: ""
既定値: ""
既定値: "nil"
戻り値
()