분석 서비스 는 사용자가 자신의 경험과 상호 작용하는 방식을 추적하는 메서드 컬렉션입니다, 특히 플레이어 진행 상황, 경험 경제, 함수 및 사용자 정의 이벤트를 통해.
요약
메서드
사용자 경험에서 사용자 메트릭스를 추적하는 사용자 이벤트를 로그합니다.
- LogEconomyEvent(player : Player,flowType : Enum.AnalyticsEconomyFlowType,currencyType : string,amount : number,endingBalance : number,transactionType : string,itemSku : string,customFields : Dictionary):void
경험과 관련된 플레이어 동작을 추적하는 로그 이벤트.
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):void
사용자가 미리 계획된 튜브를 통해 이동하는 동안 사용자 작업을 추적하는 이벤트를 로그합니다.Logs an event used to track user actions steps through a pre-planned funnel.
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):void
사용자가 보드링 펌을 통해 단계를 밟는 동안 사용자 작업을 추적하는 이벤트를 로그합니다.
- LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
사용자가 레벨 시도를 완료한 때의 이벤트를 로그합니다.
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):void
사용자가 시작, 완료 또는 레벨 시도를 실패한 때에 대한 이벤트를 로그합니다.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
사용자가 레벨 시도를 실패했을 때 이벤트를 로그합니다.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
사용자가 레벨 시도를 시작한 때의 이벤트를 로그합니다.
속성
메서드
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
경험과 관련된 플레이어 동작을 추적하는 로그 이벤트.
매개 변수
이벤트를 발동한 사용자.
Currency 흐름 방향을 지정하려면 enum.analytics.economyflow.type 을 사용합니다.
통화 추가 또는 제거의 이름, 예를 들어 "_ number1 "이나 _ number1 "이다. 경험당 5개의 고유 통화 유형 제한.
추가 또는 제거할 통화의 양. 이 값은 항상 양수여야 합니다.
통화가 추가되거나 제거된 후 사용자의 잔액. 이 값은 항상 0보다 크거나 같아야 합니다.
발생한 트랜잭션의 유형. 모든 트랜잭션 입력사용할 수 있지만, 향후 Roblox 도구 및 차트에서 미래의 인사이트를 활성화하려면 Enum.AnalyticsEconomyTransactionType 또는 "IAP"를 사용하는 것이 좋습니다.
이 필드 유형이 문자열이므로 열거형의 값 Name 을 패스해야 합니다. 예를 들어 Enum.AnalyticsEconomyTransactionType.IAP.Name 입니다.
경험당 20개의 독특한 형식만 사용할 수 있습니다.
구매하는 아이템 또는 번들의 옵션 SKU. 이것은 구매하는 아이템에 대한 고유 식별자입니다. 경험당 100개의 독특한 SKU 제한됩니다.
Roblox에서 제공하는 차트에 대한 설명을 제공하는 사용자 정의 필드의 옵션 사전입니다. 키는 Enum.AnalyticsCustomFieldKeys 에 의해 제공됩니다. 이 설명은 경험당 3개의 사용자 정의 값 중 8,000개만 사용할 수 있습니다.
반환
코드 샘플
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.
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
사용자가 미리 계획된 슬라이드를 통해 이동하는 동안 사용자 작업을 추적하는 이벤트를 로그합니다. 슬라이드 내 작업 및 이벤트 값은 첫 번째 단계의 슬라이드 세션에서만 고려됩니다.
매개 변수
이벤트를 발동한 사용자.
즐겁게 함 을 위한 이름. 이 함 은 모든 단계에 동일해야 합니다. 경험당 10개의 독특한 즐겁게 함 을 초과할 수 없습니다.
슬라이드 세션에 대한 고유한 식별자입니다. 이 식별자는 모든 슬라이드 단계에 대해 동일해야 합니다.
예를 들어 구매 흐름 퓨즈 또는 아이템 업그레이드 퓨즈와 같은 재사용 흐름 함수에 대해서는 이 필드가 필요하지 않습니다. 자연 흐름 세션 식별자가 없는 경우 Class.HttpService:GenerateGUID() 를 사용하는 것이 좋습니다.
슬라이드의 단계 번호. 이 단계 번호는 슬라이드의 각 단계에 대해 고유해야 합니다. 모든 슬라이드는 단계 1부터 시작됩니다. 1-100 단계까지 제한됩니다.
동일한 사용자가 동일한 튜브 세션에서 반복된 단계 또는 funnelSessionId 가 nil 인 경우 무시됩니다.
단계를 건너뛰면 중간 단계가 완료된 것으로 간주됩니다.
슬라이드 내에서 단계 이름의 옵션. 이 필드는 Roblox에서 제공하는 차트에서만 표시됩니다.
Roblox에서 제공하는 차트에 대한 설명을 제공하는 사용자 정의 필드의 옵션 사전입니다. 키는 Enum.AnalyticsCustomFieldKeys 에 의해 제공됩니다. 이 설명은 경험당 3개의 사용자 정의 값 중 8,000개만 사용할 수 있습니다.
반환
코드 샘플
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.
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
사용자가 온보딩 튜토리얼을 통해 이동한 동작을 추적하는 이벤트를 로그합니다. 튜토리얼 내 단계별 이동 동작에 대한 사용자 및 이벤트 값만 고려합니다.
매개 변수
이벤트를 발동한 사용자.
슬라이드의 단계 번호. 이 단계 번호는 슬라이드의 각 단계에 대해 고유해야 합니다. 모든 슬라이드는 단계 1부터 시작됩니다. 1-100 단계까지 제한됩니다.
단계를 건너뛰면 중간 단계가 완료된 것으로 간주됩니다.
슬라이드 내에서 단계 이름의 옵션. 이 필드는 Roblox에서 제공하는 차트에서만 표시됩니다.
Roblox에서 제공하는 차트에 대한 설명을 제공하는 사용자 정의 필드의 옵션 사전입니다. 키는 Enum.AnalyticsCustomFieldKeys 에 의해 제공됩니다. 이 설명은 경험당 3개의 사용자 정의 값 중 8,000개만 사용할 수 있습니다.
반환
코드 샘플
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.
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에서 제공하는 차트에 현재 표시되지 않습니다.
매개 변수
이벤트를 발동한 플레이어.
반환
LogProgressionEvent
사용자가 시작, 완료 또는 레벨 시도를 실패한 때에 대한 이벤트를 로그합니다. 이 이벤트는 Roblox에서 제공하는 차트에 현재 표시되지 않습니다.
매개 변수
이벤트를 발동한 플레이어.
반환
LogProgressionFailEvent
사용자가 레벨 시도를 실패했을 때 이벤트를 로그합니다. 이 이벤트는 Roblox에서 제공하는 차트에 현재 표시되지 않습니다.
매개 변수
이벤트를 발동한 사용자.
반환
LogProgressionStartEvent
사용자가 레벨 시도를 시작한 때 이벤트를 로그합니다. 이 이벤트는 Roblox에서 제공하는 차트에 현재 표시되지 않습니다.
매개 변수
이벤트를 발동한 플레이어.