이벤트¶
개요¶
이벤트는 애널리틱스의 모든 분석의 기초가 되는 이벤트 및 이벤트 하위에 생성된 속성을 확인하고 관리하는 기능입니다.
SDK를 연동하는 것만으로 로그인, 구매, 설치 등 50가지 이상의 이벤트가 별도 개발 없이 자동으로 수집됩니다. 여기에 필요한 이벤트를 직접 정의하여 추가하면 더욱 정밀한 분석이 가능합니다.
사용자 정의 이벤트를 직접 전송하려면 이벤트 설계 및 전송 가이드를 참고하세요.
무엇을 할 수 있나요?¶
사업/마케팅 담당자¶
- 분석에 필요한 이벤트와 속성을 이 화면에서 정의하면 개발팀에 전달할 기획 문서로 바로 활용할 수 있습니다.
- 현재 수집 중인 이벤트 목록을 한눈에 파악하면 어떤 데이터로 분석이 가능한지 즉시 확인할 수 있습니다.
데이터 분석가¶
- 이벤트 목록에서 분석 가능한 이벤트와 속성의 전체 현황을 파악하면 분석 범위를 빠르게 설계할 수 있습니다.
- 데이터 미리보기로 이벤트의 실제 값을 직접 확인해 분석 전에 데이터 품질을 검증할 수 있습니다.
개발자¶
- 이벤트명와 속성 목록을 이 화면에서 바로 확인하여 SDK 연동 작업을 효율적으로 진행할 수 있습니다.
- 이벤트 전송 후 데이터 미리보기에서 수신된 속성값을 확인하면 전송 결과를 즉시 검증할 수 있습니다.
- ETL 시뮬레이션 기능을 활용하면 실제 배포 전에 이벤트 전송 결과를 미리 확인할 수 있습니다.
빠르게 시작하기¶
처음 이벤트를 등록하는 경우, 아래 단계를 따라 첫 번째 이벤트를 생성해보세요.
- 좌측 사이드바에서 데이터 > 이벤트 메뉴를 클릭합니다.
- 우측 상단 등록 버튼을 클릭합니다.
- 이벤트명과 이벤트 설명을 입력합니다.
- 속성 탭으로 이동하여 이벤트와 함께 전송할 속성을 추가합니다.
- 속성명, 설명, 자료형을 설정합니다.
- 저장 버튼을 클릭합니다.
- 개발 부서에 이벤트명과 속성 목록을 전달하여 이벤트 데이터 전송을 요청합니다.
Note
이벤트 속성·데이터 미리보기·ETL 시뮬레이션 등 세부 설정은 전체 기능을 참고하세요.
전체 기능¶
주요 개념¶
| 개념 | 설명 |
|---|---|
| 이벤트 | 유저가 게임에서 수행한 특정 행동의 데이터 기록 단위 (예: 로그인, 구매, 레벨업) |
| 플랫폼 이벤트 | SDK 연동만으로 Hive에서 기본으로 수집하는 이벤트 |
| MMP 이벤트 | Airbridge, AppsFlyer, Adjust 등 MMP를 통해 전송되는 이벤트 |
| 사용자 정의 이벤트 | 직접 정의하고 전송하는 커스텀 이벤트 |
| 속성 | 이벤트 텍소노미 구조에서 이벤트에 딸린 세부 데이터 항목. 플랫폼 속성과 이벤트 속성으로 구분됨 |
| 플랫폼 속성 | SDK 연동만으로 Hive에서 기본으로 수집하는 속성(예: 국가, 마켓, 서버 ID, OS 등) |
| 이벤트 속성 | 이벤트와 함께 전송되는 속성(예: 구매 이벤트의 아이템 ID, 금액, 통화 단위) |
이벤트 목록 조회¶
애널리틱스에 등록된 모든 이벤트를 목록으로 확인합니다. 
필터 및 검색¶
| 옵션 | 설명 |
|---|---|
| 이벤트 종류 | 이벤트 종류(사용자 정의 이벤트, AppsFlyer, Airbridge 등)로 목록 필터 |
| 이벤트명/생성자 검색 | 검색 기준(이벤트명 또는 생성자)을 선택한 후 검색어를 입력하여 이벤트 검색 |
| 사용중인 이벤트만 표시 | 토글 ON 시 사용 여부가 활성화된 이벤트만 표시 |
목록 컬럼¶
| 컬럼 | 설명 |
|---|---|
| 번호 | 이벤트 등록 순번 |
| 이벤트 종류 | 사용자 정의 / AppsFlyer / Airbridge 등 이벤트 출처 |
| 이벤트명 | 이벤트 이름. 클릭하면 상세 페이지로 이동 |
| 설명 | 이벤트 등록 시 입력한 설명 |
| 생성일 | 이벤트가 처음 등록된 일시 |
| 생성자 | 이벤트를 등록한 계정. 시스템 자동 생성 이벤트는 system으로 표시 |
| 데이터 최종 입력일 | 해당 이벤트의 데이터가 마지막으로 수집된 일시. 10분 단위로 동기화되며, 수집 이력이 없으면 -로 표시 |
| 사용 여부 | 토글로 이벤트 활성/비활성 제어. OFF 시 이벤트 선택시 목록에서 숨겨짐 |
이벤트 등록¶
이벤트 목록 화면 우측 상단의 등록 버튼을 클릭하면 이벤트 등록 페이지로 이동합니다. 
| 항목 | 필수 | 설명 |
|---|---|---|
| 이벤트명 | 필수 | 실제 데이터 전송 시 사용하는 고유 코드 |
| 설명 | 선택 | 이벤트의 발생 조건과 목적 설명 |
Note
애널리틱스가 권고하는 이벤트명 명명 규칙은 이벤트 설계 및 전송 가이드를 참고하세요.
이벤트 상세 조회¶
[기본 정보] 탭¶
등록된 이벤트의 이벤트명과 설명을 확인하고 수정합니다. 
[속성] 탭¶
각 이벤트에 함께 전송되는 속성을 정의합니다. 
| 항목 | 설명 |
|---|---|
| 속성명 | 실제 전송 시 사용하는 코드 |
| 설명 | 속성값의 의미와 예시 |
| 데이터 타입 | 문자 / 숫자 / 날짜형 중 택 1 |
데이터 타입 설명¶
| 타입 | 설명 | 예시 |
|---|---|---|
| 문자 | 문자열 값 | 국가 코드(KR), 아이템명(sword) |
| 숫자 | 정수 또는 소수 값 | 레벨(50), 결제 금액(9.99) |
| 날짜 | 날짜/시간 값 | 이벤트 발생 시각(2026-03-29T10:00:00) |
통화 속성 / 금액 속성¶
이벤트에 등록된 속성 중 통화값과 매출 금액이 담기는 속성을 시스템에 지정할 수 있습니다. 이 설정을 해야 차트에서 원하는 통화 기준으로 매출 수치를 조회할 수 있습니다.
| 항목 | 설명 |
|---|---|
| 통화 속성 | 통화 코드값이 들어오는 속성 지정 (예: KRW, USD 등의 통화 단위가 담긴 속성) |
| 금액 속성 | 매출 계산에 사용할 수치가 들어오는 속성 지정 (예: 결제 금액이 담긴 속성) |
Note
통화 속성과 금액 속성은 이벤트 상세 페이지의 [속성] 탭에서 설정할 수 있습니다. 속성 목록에서 해당 속성을 선택한 후 각 항목을 지정하세요.
Warning
통화 속성 또는 금액 속성이 지정되지 않으면 차트에서 매출 관련 지표를 통화 기준으로 조회할 수 없습니다. 구매 이벤트를 분석에 활용하려면 반드시 두 속성을 모두 지정하세요.
[데이터 미리보기] 탭¶
실제 애널리틱스에서 수집한 이벤트 데이터 샘플을 확인합니다. 이벤트가 올바르게 전송되고 있는지, 속성값이 의도한 대로 수집되는지 검증할 때 활용합니다.
조회 조건¶
| 항목 | 설명 |
|---|---|
| 조회 기간 | 데이터를 조회할 날짜 범위를 선택합니다. 시작일과 종료일의 범위는 최대 1개월로 제한됩니다. |
| 필드명 | 필터를 적용할 속성(필드)을 선택합니다. |
| 조건 | 선택한 필드에 적용할 비교 조건을 선택합니다. |
| 검색 | 조건에 사용할 값을 입력합니다. |
| 초기화 | 설정한 필터 조건을 모두 초기화합니다. |
Warning
조회 기간 범위가 1개월을 초과하면 데이터를 조회할 수 없습니다. 기간을 줄여 다시 조회하세요.
[소스 생성] 탭¶
해당 이벤트를 애널리틱스로 전송하기 위한 소스 코드를 자동으로 생성합니다. 개발자가 별도로 코드를 작성하지 않아도 이 탭에서 생성된 소스를 그대로 사용해 데이터를 전송할 수 있습니다. 
| 탭 | 설명 |
|---|---|
| 클라이언트 개발자 | 게임 클라이언트에서 이벤트를 전송하는 소스 코드 제공 |
| 서버 개발자 | 게임 서버에서 이벤트를 전송하는 소스 코드 제공 |
| 문서 | 이벤트 수집 테이블 스키마에 대한 참고 문서 제공 |
[ETL 시뮬레이션] 탭¶
이벤트 전송 테스트를 위한 시뮬레이션 기능입니다.
- 각 이벤트 수집 테이블 필드에 적절한 데이터를 입력합니다.
- 전송 버튼을 클릭합니다.
- [데이터 미리보기] 탭에서 이벤트 수신 여부와 속성 파싱 결과를 확인합니다.
Warning
appId 필드에는 반드시 Hive 콘솔 > 앱센터에 등록된 앱 ID를 입력해야 합니다. 잘못된 값을 입력하면 데이터가 수집되지 않을 수 있습니다.
이벤트 표시 제어¶
- 이벤트 목록의 사용 여부 토글로 각 이벤트의 노출 여부를 설정합니다. - OFF로 설정하면 차트/퍼널/리텐션 등 분석 화면에서 해당 이벤트가 선택 목록에서 숨겨집니다. - 데이터는 계속 수집되지만 분석 UI에서는 보이지 않습니다.
이벤트 복사 및 삭제¶
- 복사: 기존 이벤트를 기반으로 유사한 이벤트를 빠르게 생성
- 삭제: 더 이상 사용하지 않는 이벤트 삭제
Warning
삭제된 이벤트를 사용 중인 차트/메트릭이 있다면 해당 콘텐츠에 영향이 생길 수 있습니다.
주의사항 & Tips¶
- 이벤트명은 배포 이후 변경하면 이전 데이터와 불일치가 발생합니다. 이벤트명을 신중하게 결정하세요.
- 속성 타입이 잘못 설정되면 데이터 집계 오류가 발생할 수 있습니다.
- MMP 이벤트를 활용하려면 데이터 > 연동 메뉴에서 해당 MMP 연동을 먼저 설정해야 합니다.
- 사용하지 않는 이벤트는 표시 OFF로 처리하여 분석 UI를 정돈하세요.
- 이벤트 수가 많아지면 이름과 설명을 명확하게 작성하는 것이 팀 전체의 분석 효율을 높입니다.