요약
메서드
FireCustomEvent(player: Instance,eventCategory: string,customData: Variant):() |
FireInGameEconomyEvent(player: Instance,itemName: string,economyAction: Enum.AnalyticsEconomyAction,itemCategory: string,amount: number,currency: string,location: Variant,customData: Variant):() |
FireLogEvent(player: Instance,logLevel: Enum.AnalyticsLogLevel,message: string,debugInfo: Variant,customData: Variant):() |
FirePlayerProgressionEvent(player: Instance,category: string,progressionStatus: Enum.AnalyticsProgressionStatus,location: Variant,statistics: Variant,customData: Variant):() |
GetPlayerSegmentsAsync(player: Player):Dictionary |
LogCustomEvent(player: Player,eventName: string,value: number,customFields: Dictionary):() |
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):() |
상속된 멤버
API 참조
속성
ApiKey
메서드
FireCustomEvent
FireEvent
FireInGameEconomyEvent
FireLogEvent
FirePlayerProgressionEvent
GetPlayerSegmentsAsync
매개 변수
코드 샘플
플레이어 세그먼트를 통한 서버 측 경험 구성
local Players = game:GetService("Players")
local AnalyticsService = game:GetService("AnalyticsService")
local function configurePlayerExperience(player)
local segments = AnalyticsService:GetPlayerSegmentsAsync(player)
if not segments.HasData then
return
end
if segments.WhenUserFirstPlayed == Enum.WhenUserFirstPlayed.Days0To30 then
print("추가 온보딩을 표시합니다:", player.Name)
end
if segments.ActivePayerStatus == Enum.ActivePayerStatus.Top15Percent then
print("고급 제안을 표시합니다:", player.Name)
end
end
Players.PlayerAdded:Connect(configurePlayerExperience)LogCustomEvent
AnalyticsService:LogCustomEvent(
):()
매개 변수
| 기본값: 1 |
| 기본값: "nil" |
반환
()
코드 샘플
커스텀 이벤트 기록
local AnalyticsService = game:GetService("AnalyticsService")
-- 임무 시작 시 기록
AnalyticsService:LogCustomEvent(
player,
"MissionStarted" -- 커스텀 이벤트 이름
)
-- 임무가 완료될 때 소요된 시간과 함께 기록
AnalyticsService:LogCustomEvent(
player,
"MissionCompletedDuration", -- 커스텀 이벤트 이름
120 -- 집계에 사용되는 이벤트 값
)LogEconomyEvent
AnalyticsService:LogEconomyEvent(
player:Player, flowType:Enum.AnalyticsEconomyFlowType, currencyType:string, amount:number, endingBalance:number, transactionType:string, itemSku:string, customFields:Dictionary
):()
매개 변수
| 기본값: "nil" |
반환
()
코드 샘플
인앱 구매 추적
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"코인",
1000, -- 번들에 있는 코인의 수
1020, -- 거래 후 잔액
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- 코인 번들의 고유 식별자
)LogFunnelStepEvent
반환
()
코드 샘플
트래킹 상점 단계
local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
funnelSessionId = HttpService:GenerateGUID()
-- 사용자가 상점을 열 때 로그 기록
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- 단계를 그룹화하는 데 사용되는 퍼널 이름
funnelSessionId, -- 이 고유 결제 세션의 퍼널 세션 ID
1, -- 단계 번호
"상점 열림" -- 단계 이름
)
-- 사용자가 아이템을 볼 때 로그 기록
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- 단계를 그룹화하는 데 사용되는 퍼널 이름
funnelSessionId, -- 이 고유 결제 세션의 퍼널 세션 ID
2, -- 단계 번호
"아이템 보기" -- 단계 이름
)
-- 사용자가 장바구니에 추가할 때 로그 기록
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- 단계를 그룹화하는 데 사용되는 퍼널 이름
funnelSessionId, -- 이 고유 결제 세션의 퍼널 세션 ID
3, -- 단계 번호
"장바구니에 추가" -- 단계 이름
)LogOnboardingFunnelStepEvent
AnalyticsService:LogOnboardingFunnelStepEvent(
):()
매개 변수
| 기본값: "nil" |
반환
()
코드 샘플
온보딩 단계 추적
local AnalyticsService = game:GetService("AnalyticsService")
-- FTUE의 첫 번째 단계 기록
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- 단계 번호
"게임 참가" -- 단계 이름
)
-- FTUE의 두 번째 단계 기록
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- 단계 번호
"클래스 선택" -- 단계 이름
)LogProgressionCompleteEvent
AnalyticsService:LogProgressionCompleteEvent(
):()
매개 변수
| 기본값: "nil" |
반환
()
LogProgressionEvent
AnalyticsService:LogProgressionEvent(
player:Player, progressionPathName:string, status:Enum.AnalyticsProgressionType, level:number, levelName:string, customFields:Dictionary
):()
매개 변수
| 기본값: "nil" |
반환
()
LogProgressionFailEvent
AnalyticsService:LogProgressionFailEvent(
):()
매개 변수
| 기본값: "nil" |
반환
()
LogProgressionStartEvent
AnalyticsService:LogProgressionStartEvent(
):()
매개 변수
| 기본값: "nil" |
반환
()