UEFN Analytics Device 이벤트 이름 32자 제한 해결 방법 (Verse 튜토리얼)
모든 기술 게임 개발자는 텔레메트리 파이프라인이 중단되는 순간을 잘 알고 있습니다. 복잡한 플레이어 상태를 추적해야 하지만 엔진이 전송 데이터 양을 제한할 때입니다. Unreal Editor for Fortnite(UEFN)에서 작업 중이라면 UEFN analytics device의 EventName 32자 제한에 직면했을 것입니다.
기본 analytics_device는 JSON 페이로드를 지원하지 않기 때문에 개발자들은 Player_Left_During_G1_F_Active_M과 같이 읽기 힘든 문자열을 만드는 등 "창의적"인 방법을 강구해야 합니다. 하지만 32자라는 엄격한 제한이 존재합니다.
이 튜토리얼에서는 Verse를 사용하여 견고한 텔레메트리 인코딩 시스템을 설계합니다. 복잡한 게임 상태를 32자 미만의 문자열로 압축하고 백엔드에서 이를 디코딩하는 방법을 알아봅니다.
텔레메트리 병목 현상의 구조
Mixpanel 같은 표준 플랫폼은 JSON을 사용하지만, UEFN은 모든 상태를 EventName이라는 단일 키로 압축하도록 강제합니다. 32바이트 제한 내에서 모든 문자는 매우 소중합니다. 프로페셔널한 접근 방식은 **스키마 기반 텔레메트리 인코더(schema-driven telemetry encoder)**를 구축하는 것입니다.
1단계: Verse에서 인코더 설계하기
중앙 집중식 Verse 스크립트를 통해 모든 분석을 관리하세요. "Player_Quit" 대신 PQ, "Medic" 대신 M과 같은 약어를 사용합니다.
# 형식: E:Type|C:Code|Z:ID|T:Time
Payload := "E:{EventType}|C:{ClassCode}|Z:{ZoneStr}|T:{TimeStr}"
if (Payload.Length <= 32):
AnalyticsDevice.RecordEvent(Payload)
2단계: 고밀도 데이터를 위한 고급 비트 패킹
X/Y 좌표를 추적하려면 spatial hashing이나 그리드 기반 인코딩을 구현하세요. 맵을 그리드로 나누고 각 셀에 A01과 같은 4자 ID를 부여하면 페이로드를 크게 절약할 수 있습니다.
3단계: 백엔드에서 디코딩하기
Epic Creator Portal에서 CSV를 내보낸 후 Python(Pandas) 스크립트를 사용하여 문자열을 파싱하고 분석용 데이터 퍼널을 재구성합니다.
한계점: 샌드박스를 떠나야 할 때
문자열 압축기 작성에 수주를 소비하고 있다면 엔진과 싸우고 있는 것입니다. 표준 Unreal Engine 5로 전환하면 이러한 제한이 사라집니다. HttpModule이나 WebSockets를 사용하여 JSON을 직접 전송할 수 있습니다. Ditch Http Polling An Unreal Engine Websockets Tutorial For Real Time Backends 가이드를 확인하세요.
horizOn을 사용하면 이러한 백엔드 서비스가 미리 구성되어 있습니다. API를 통해 JSON을 보내기만 하면 즉시 시각화할 수 있습니다.
5가지 분석 베스트 프랙티스
- 구분 기호 표준화:
|와 같은 구분 기호를 통일하세요. - 연속 데이터 추적 금지:
Tick마다 보내지 말고 상태 변경 시에만 전송하세요. - 외부 스키마 문서 유지: 약어 리스트를 문서화하세요.
- 기술 텔레메트리와 비즈니스 분석 분리.
- 전송 전 검증: Verse에서 문자열 길이를 먼저 확인하세요.