이벤트 전송
이벤트란?
이벤트는 유저가 앱 내에서 수행한 특정 행동을 데이터로 기록한 단위입니다. "언제, 누가, 무엇을 했는가"를 담고 있으며, 분석의 가장 기본 단위가 됩니다.
- 예: 유저가 아이템을 구매했다 →
item_purchase이벤트 발생 - 예: 유저가 특정 스테이지를 클리어했다 →
stage_clear이벤트 발생 - 예: 유저가 앱에 로그인했다 →
login이벤트 발생
이벤트 전송 방법은 이벤트 로그 전송를 참고하세요.
이벤트명 명명 규칙
eventName에 사용할 이벤트명은 아래 규칙을 따라 작성할 것을 권고합니다.
- 권장 문자: 영문(a–z, A–Z, 대/소문자 구분), 숫자(0–9), 언더바(
_) - 구분자: 단어 사이는 공백이 아닌 언더바(
_)로 구분 - 형태: 이벤트를 명확하게 설명하는
명사_동사형태 권장 - 예시:
item_purchase,level_up,tutorial_complete,stage_start
Warning
위 규칙을 준수하지 않은 이벤트명은 분석에 활용하는 데 제한이 있을 수 있습니다.
속성이란?
속성은 이벤트가 발생했을 때 함께 기록되는 세부 정보입니다. 이벤트만으로는 "무슨 일이 일어났는지"만 알 수 있지만, 속성을 통해 "어떤 조건에서, 어떤 값으로" 발생했는지까지 파악할 수 있습니다.
- 예:
item_purchase이벤트의 속성 → 아이템 ID, 결제 금액, 통화 단위 - 예:
stage_clear이벤트의 속성 → 스테이지 번호, 클리어 시간, 사용 캐릭터
이벤트와 함께 속성 전송 방법은 이벤트 속성 전송을 참고하세요.
속성 명명 규칙
사용자 정의 속성(eventAttributes)의 키 이름은 아래 규칙을 따라 작성할 것을 권고합니다.
- 권장 문자: 영문(a–z, A–Z, 대/소문자 구분), 숫자(0–9), 언더바(
_) - 시작 문자: 영문으로 시작
- 구분자: 단어 사이는 공백이 아닌 언더바(
_)로 구분 - 예시:
item_id,contentsType,stage_level
Warning
- 위 규칙을 준수하지 않은 속성 키는 분석에 활용하는 데 제한이 있을 수 있습니다.
attributes,eventAttributes,hiveAttributes는 예약어로, 속성명으로 사용하면 격리됩니다. 자세한 내용은 이벤트 속성 전송을 참고하세요.
이벤트 구조에 맞춰 설계한 이벤트 예시는 이벤트 템플릿에서 확인할 수 있습니다.
주의사항 & Tips
- 이벤트명과 속성명은 한 번 배포하면 변경하기 어렵습니다. 전송 전에 이벤트 속성 전송의 명명 규칙을 먼저 검토하세요.
- 같은 목적의 이벤트를 여러 이름으로 중복 생성하지 말고, 이벤트 템플릿에 이미 정의된 이벤트명이 있는지 먼저 확인하세요.