사용자 정의 이벤트를 사용하면 다른 이벤트가 완전히 포착하지 못하는 게임에 특정한 메트릭을 추적할 수 있습니다. 여기에는 다음이 포함됩니다.
- 채택 — 특정 UI 구성 요소를 클릭한 사용자 수는 몇 명인가요?
- 사용자 행동 — 각 맵에서 가장 자주 사용되는 능력은 무엇인가요?
- 핵심 루프 — 서로 다른 무기 간의 킬/죽음 비율은 어떻게 비교되나요?
게임이 사용자 정의 이벤트를 추적하기 시작하면, Creator Hub의 분석 대시보드에서 탐색 페이지를 사용할 수 있게 됩니다. 게임에 최대 100개의 사용자 정의 이벤트를 추가할 수 있습니다.
사용자 정의 이벤트 추적
탐색 페이지를 사용하려면 먼저 게임에서 사용자 정의 이벤트를 추적해야 합니다. 모니터링하고 개선하는 데 가장 중요한 메트릭을 식별하는 것부터 시작하세요. 이벤트는 매일 집계되므로, 페이지에 차트가 표시되기까지 최대 24시간이 걸릴 수 있습니다.
카운터
카운터는 값 없이 캡처된 1회성 이벤트입니다. 특정 이벤트가 발생한 횟수를 추적하기 위해 카운터를 사용할 수 있습니다. 버튼 클릭, 퀘스트 시작 또는 도구 사용과 같은 단일 작업에 카운터를 사용하세요.
이벤트는 자동으로 이벤트 수와 고유 사용자 수를 추적합니다. 값 집계의 경우, 카운터 이벤트는 기본값이 1인 이벤트로 처리됩니다. 이는 최대/최소/평균과 같은 집계가 항상 1이 되고, 합계는 총 이벤트 수와 같음을 의미합니다.
local AnalyticsService = game:GetService("AnalyticsService")AnalyticsService:LogCustomEvent(player,"MissionStarted" -- 이벤트 이름)
값이 있는 이벤트
값이 있는 이벤트도 추적할 수 있으며, 킬/죽음 비율이나 사용자가 미션에 소모한 시간과 같은 보다 정량적인 데이터를 게임에 포함할 수 있습니다. 또한, 속도 제한을 초과하지 않기 위해 배치로 이벤트를 전송하는 방법으로 사용할 수도 있습니다. 즉, 1마리를 10번 죽인 대신 10마리의 좀비를 죽였다고 전송할 수 있습니다.
local AnalyticsService = game:GetService("AnalyticsService")AnalyticsService:LogCustomEvent(player,"MissionCompletedDuration", -- 이벤트 이름120 -- 이벤트 값)
이벤트 집계
모든 이벤트 메트릭은 다음 집계를 포함하며 슬라이스 및 다이스 지원 기능이 있습니다:
- 수
- 고유 사용자 수
- 평균 값
- 합계 값
- 최소 값
- 최대 값
- 사용자당 평균 값
집계 유형을 선택하여 탐색 페이지에서 이벤트 집계를 확인하세요.

사용자 정의 필드 사용
사용자 정의 이벤트는 또한 세그먼트 간의 더 쉬운 비교를 지원하기 위해 사용자 정의 필드를 기반으로 분해할 수 있도록 합니다. 예를 들어, 각 이벤트에 퀘스트 이름을 제공하여 사용자가 가장 선호하는 퀘스트를 확인하거나 플레이어 클래스를 첨부하여 특정 클래스의 킬/죽음 비율이 유의미하게 높은지를 확인할 수 있습니다.
분해 선택기를 사용하여 사용자 정의 필드로 분해할 수 있습니다.

가능한 한 이벤트 이름 대신 사용자 정의 필드를 사용하는 것이 좋습니다. 이벤트 이름보다 사용자 정의 필드에 훨씬 더 엄격한 카드inality 제한이 있기 때문입니다. 사용자 정의 필드를 사용하면 필드 값 전반에 걸쳐 이벤트 시각화를 볼 수 있습니다.
예를 들어, PlantCabbage, PlantTurnip, PlantPepper로 세 개의 별도 이벤트를 만드는 대신, PlantSeed라는 이름의 단일 이벤트와 Plant - Cabbage, Plant - Turnip, Plant - Pepper라는 사용자 정의 필드 값을 가질 수 있습니다. 이렇게 하면 전체 식물이 심은 수를 시각화할 수 있을 뿐만 아니라 각 식물을 동일한 시각화에서 비교할 수 있습니다. 이렇게 하면 이벤트 이름의 카드inality도 줄일 수 있습니다.
자세한 내용은 사용자 정의 필드를 참조하세요.
사용자 정의 이벤트를 사용하여 게임 성장시키기
사용자 정의 이벤트를 통해 가장 중요한 메트릭을 추적할 수 있으며, 플레이어가 특정 기능 및 콘텐츠와 상호작용하는 방식을 통찰할 수 있습니다. 이러한 이벤트를 사용하여 플레이어 행동의 패턴을 발견하고 핵심 게임 루프를 최적화하세요.
참조 게임 Plant에서 HarvestPlant 이벤트는 플레이어가 익은 식물을 수확할 때마다 발생합니다. 사용자 정의 이벤트를 사용하면 식물 유형에 따라 하루에 각 플레이어당 수확된 평균 식물 수를 추적할 수 있습니다:
