AnalyticsService

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

만들 수 없음
서비스
복제되지 않음

분석 서비스 는 개발자가 사용자가 경험과 상호작용하는 방식, 특히 플레이어 진행률, 경험 내 경제, 파이프라인 및 사용자 지정 이벤트를 추적할 수 있는 메서드 컬렉션입니다.

요약

메서드

속성

메서드

LogCustomEvent

()

경험에서 사용자의 사용자 지정 메트릭을 추적하는 데 사용되는 이벤트를 로그합니다. 자세한 정보는 사용자 지정 이벤트를 참조하십시오.

매개 변수

player: Player

이벤트를 트리거한 사용자.

기본값: ""
eventName: string

사용자 지정 이벤트의 이름.

기본값: ""
value: number

집계에 사용될 이벤트의 값.

기본값: 1
customFields: Dictionary

Roblox에서 제공하는 차트에서 분석을 제공하는 사용자 지정 필드의 선택적 사전.특정 키, 즉 Enum.AnalyticsCustomFieldKeys에서 제공하는 키만 이러한 분석에 사용됩니다.경험당 세 개의 사용자 지정 필드에서 값의 8,000개 고유 조합으로 제한됩니다.

기본값: "nil"

반환

()

코드 샘플

This example uses AnalyticsService:LogCustomEvent() to log two custom events: MissionStarted and MissionCompletedDuration.

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

()

경험과 관련된 플레이어 작업을 추적하는 데 사용되는 이벤트를 로그합니다.

매개 변수

player: Player

이벤트를 트리거한 사용자.

기본값: ""

통화가 Enum.AnalyticsEconomyFlowType를 사용하여 흐르는 방향을 지정해야 합니다.

기본값: ""
currencyType: string

예를 들어 "gold", "gems", 또는 "energy"의 통화 이름이 추가되거나 제거됩니다.경험당 5개의 고유 통화 유형으로 제한됩니다.

기본값: ""
amount: number

추가되거나 제거되는 통화 금액. 이 값은 항상 양수여야 합니다.

기본값: ""
endingBalance: number

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

기본값: ""
transactionType: string

발생한 트랜잭션 유형.모든 거래 유형을 사용할 수 있지만, Roblox 도구와 차트에서 미래의 통찰력을 활성화하기 위해 제공된 유형(예: Enum.AnalyticsEconomyTransactionType 또는 "IAP" 또는 "ContextualPurchase" )을 사용하는 것이 좋습니다.

이 필드 유형이 문자열이기 때문에 열거형의 Name 값을 전달해야 합니다. 예를 들어 Enum.AnalyticsEconomyTransactionType.IAP.Name .

경험당 20개의 고유 유형으로 제한됩니다.

기본값: ""
itemSku: string

구매하는 아이템이나 패키지의 선택적 SKU.구매하는 아이템의 고유 식별자입니다.경험당 100개의 고유 SKU 제한.

기본값: ""
customFields: Dictionary

Roblox에서 제공하는 차트에서 분석을 제공하는 사용자 지정 필드의 선택적 사전.특정 키, 즉 Enum.AnalyticsCustomFieldKeys에서 제공하는 키만 이러한 분석에 사용됩니다.경험당 세 개의 사용자 지정 필드에서 값의 8,000개 고유 조합으로 제한됩니다.

기본값: "nil"

반환

()

코드 샘플

다음 예제에서는 IAP(앱 내 구매) 거래 유형을 사용하여 1000코인 패키지의 Robux 구매를 추적합니다.이전 샘플과 비교할 때 선택적 매개변수로 제공된 항목 이름을 참고하십시오.

앱 내 구매 추적

local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"Coins",
1000, -- 번들에 얼마나 많은 코인이 있는지
1020, -- 거래 후 균형
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- 코인 패키지의 고유 식별자
)

LogFunnelStepEvent

()

사전 계획된 파이프라인을 통해 사용자 작업을 추적하는 데 사용되는 이벤트를 로깅합니다.깔때기 분석은 깔때기 세션의 첫 번째 단계에서 사용자 및 이벤트 값만 고려합니다.

매개 변수

player: Player

이벤트를 트리거한 사용자.

기본값: ""
funnelName: string

깔때기의 이름. 이는 깔때기의 모든 단계에서 동일해야 합니다. 경험당 10개의 고유한 깔때기로 제한됩니다.

기본값: ""
funnelSessionId: string

깔때기 세션에 대한 선택적 고유 식별자. 이는 깔때기의 모든 단계에서 동일해야 합니다.

이 필드는 반복되는 펄스, 예를 들어 구매 흐름 펄스 또는 아이템 업그레이드 펄스에만 필요합니다.자연스러운 깔때기 세션 식별자가 없는 경우 HttpService:GenerateGUID()를 사용하는 것이 좋습니다.

기본값: ""
step: number

깔때기의 단계 번호. 이는 깔때기의 각 단계에 고유해야 합니다. 모든 깔때기는 1단계에서 시작됩니다. 1-100단계까지 제한됩니다.

동일한 사용자가 동일한 깔때기 세션에서 반복적인 단계를 수행하거나, funnelSessionIdnil일 때 무시됩니다.

어떤 단계를 건너뛰더라도 중간 단계는 완료된 것으로 간주됩니다.

기본값: 1
stepName: string

깔때기의 단계 이름(선택 사항). 이 필드는 Roblox가 제공하는 차트에서 표시 목적으로만 사용됩니다.

기본값: ""
customFields: Dictionary

Roblox에서 제공하는 차트에서 분석을 제공하는 사용자 지정 필드의 선택적 사전.특정 키, 즉 Enum.AnalyticsCustomFieldKeys에서 제공하는 키만 이러한 분석에 사용됩니다.경험당 세 개의 사용자 지정 필드에서 값의 8,000개 고유 조합으로 제한됩니다.

기본값: "nil"

반환

()

코드 샘플

다음 샘플에서는 "무기고" 상점에서 아이템을 구매하는 프로세스를 시작하는 각 사용자에 대한 몇 가지 기본 이벤트를 추적합니다.상점을 열는 동일한 사용자의 다른 세션을 구별하는 데 사용된 funnelSessionId를 참고하십시오.

추적 상점 단계

local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
funnelSessionId = HttpService:GenerateGUID()
-- 사용자가 상점을 열 때 로그 기록
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- 단계를 함께 그룹화하는 데 사용되는 깔때기 이름
funnelSessionId, -- 이 독특한 체크아웃 세션에 대한 통합 세션 ID Funnel session id for this unique checkout session
1, -- 단계 번호
"Opened Store" -- 단계 이름
)
-- 사용자가 항목을 보았을 때 로그 기록 Log when the user views an item
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- 단계를 함께 그룹화하는 데 사용되는 깔때기 이름
funnelSessionId, -- 이 독특한 체크아웃 세션에 대한 통합 세션 ID Funnel session id for this unique checkout session
2, -- 단계 번호
"Viewed Item" -- 단계 이름
)
-- 사용자 보기가 카트에 추가될 때 로그 기록
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- 단계를 함께 그룹화하는 데 사용되는 깔때기 이름
funnelSessionId, -- 이 독특한 체크아웃 세션에 대한 통합 세션 ID Funnel session id for this unique checkout session
3, -- 단계 번호
"Added to Cart" -- 단계 이름
)

LogOnboardingFunnelStepEvent

()

온보딩 파이프라인을 통해 사용자 작업을 추적하는 데 사용되는 이벤트를 로깅합니다.깔때기 분석은 깔때기 세션의 첫 번째 단계에서 사용자 및 이벤트 값만 고려합니다.

매개 변수

player: Player

이벤트를 트리거한 사용자.

기본값: ""
step: number

깔때기의 단계 번호. 이는 깔때기의 각 단계에 고유해야 합니다. 모든 깔때기는 1단계에서 시작됩니다. 1-100단계까지 제한됩니다.

어떤 단계를 건너뛰더라도 중간 단계는 완료된 것으로 간주됩니다.

기본값: ""
stepName: string

깔때기의 단계 이름(선택 사항). 이 필드는 Roblox가 제공하는 차트에서 표시 목적으로만 사용됩니다.

기본값: ""
customFields: Dictionary

Roblox에서 제공하는 차트에서 분석을 제공하는 사용자 지정 필드의 선택적 사전.특정 키, 즉 Enum.AnalyticsCustomFieldKeys에서 제공하는 키만 이러한 분석에 사용됩니다.경험당 세 개의 사용자 지정 필드에서 값의 8,000개 고유 조합으로 제한됩니다.

기본값: "nil"

반환

()

코드 샘플

다음 샘플은 온보딩 파이프라인의 두 단계를 로깅하는 방법을 보여줍니다.온보딩 파이프라인은 일반적으로 플레이어를 게임의 핵심 루프로 소개합니다.

온보딩 단계 추적

local AnalyticsService = game:GetService("AnalyticsService")
-- FTUE의 첫 번째 단계 기록
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- 단계 번호
"Joined Game" -- 단계 이름
)
-- FTUE의 두 번째 단계 기록
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- 단계 번호
"Choose Class" -- 단계 이름
)

LogProgressionCompleteEvent

()

사용자가 레벨 시도를 완료했을 때 이벤트를 로그합니다. 이 이벤트는 현재 Roblox가 제공하는 차트에 표시되지 않습니다.

매개 변수

player: Player

이벤트를 트리거한 플레이어.

기본값: ""
progressionPathName: string
기본값: ""
level: number
기본값: ""
levelName: string
기본값: ""
customFields: Dictionary
기본값: "nil"

반환

()

LogProgressionEvent

()

사용자가 레벨 시도를 시작, 완료 또는 실패했을 때 이벤트를 로그합니다. 이 이벤트는 현재 Roblox가 제공하는 차트에 표시되지 않습니다.

매개 변수

player: Player

이벤트를 트리거한 플레이어.

기본값: ""
progressionPathName: string
기본값: ""
기본값: ""
level: number
기본값: ""
levelName: string
기본값: ""
customFields: Dictionary
기본값: "nil"

반환

()

LogProgressionFailEvent

()

사용자가 레벨 시도를 실패했을 때 이벤트를 로깅합니다. 이 이벤트는 현재 Roblox가 제공하는 차트에 표시되지 않습니다.

매개 변수

player: Player

이벤트를 트리거한 사용자.

기본값: ""
progressionPathName: string
기본값: ""
level: number
기본값: ""
levelName: string
기본값: ""
customFields: Dictionary
기본값: "nil"

반환

()

LogProgressionStartEvent

()

사용자가 레벨 시도를 시작했을 때 이벤트를 로깅합니다. 이 이벤트는 현재 Roblox가 제공하는 차트에 표시되지 않습니다.

매개 변수

player: Player

이벤트를 트리거한 플레이어.

기본값: ""
progressionPathName: string
기본값: ""
level: number
기본값: ""
levelName: string
기본값: ""
customFields: Dictionary
기본값: "nil"

반환

()

이벤트