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 흐름 방향을 지정하려면 enum.analytics.economyflow.type 을 사용합니다.

currencyType: string

통화 추가 또는 제거의 이름, 예를 들어 "_ number1 "이나 _ number1 "이다. 경험당 5개의 고유 통화 유형 제한.

amount: number

추가 또는 제거할 통화의 양. 이 값은 항상 양수여야 합니다.

endingBalance: number

통화가 추가되거나 제거된 후 사용자의 잔액. 이 값은 항상 0보다 크거나 같아야 합니다.

transactionType: string

발생한 트랜잭션의 유형. 모든 트랜잭션 입력사용할 수 있지만, 향후 Roblox 도구 및 차트에서 미래의 인사이트를 활성화하려면 Enum.AnalyticsEconomyTransactionType 또는 "IAP"를 사용하는 것이 좋습니다.

이 필드 유형이 문자열이므로 열거형의 값 Name 을 패스해야 합니다. 예를 들어 Enum.AnalyticsEconomyTransactionType.IAP.Name 입니다.

경험당 20개의 독특한 형식만 사용할 수 있습니다.

itemSku: string

구매하는 아이템 또는 번들의 옵션 SKU. 이것은 구매하는 아이템에 대한 고유 식별자입니다. 경험당 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

슬라이드 세션에 대한 고유한 식별자입니다. 이 식별자는 모든 슬라이드 단계에 대해 동일해야 합니다.

예를 들어 구매 흐름 퓨즈 또는 아이템 업그레이드 퓨즈와 같은 재사용 흐름 함수에 대해서는 이 필드가 필요하지 않습니다. 자연 흐름 세션 식별자가 없는 경우 Class.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

이벤트