개요
`HIVE 애널리틱스는 다양한 종류의 로그를 지원합니다. 먼저 로그 전송 방법을 숙지한 후에 어떤 로그를 전송할지 선택하세요. 예를 들어, 구매 로그를 전송하기로 결정했다면 게임 서버의 구매처리 로직 코드 후반부에 구매 로그 전송 부분을 코딩하여 추가하면 됩니다. 어떤 로그를 수집할 지 결정에 앞서 각 사의 BI 기획팀과 협의가 필요합니다.
공통 스펙¶
모든 로그에 공통으로 표기되는 항목은 서버 코드와 로케일 코드입니다. HIVE 식별자 정책에 맞추어 표기해주세요.
애널리틱스의 서버 표기법¶
서버 코드는 개발사의 게임 서버를 식별해 주는 코드입니다. 다음 표에서 안내하는 서버 코드 중 해당되는 서버 코드를 로그의 server_id 필드에 입력합니다.
하나의 서버를 사용하다가 서버를 추가할 경우, 코드는 서버코드-N 으로 표시할 수 있습니다. N은 숫자이며, 동일 서버군의 서버가 여러 대일 경우에 서버를 식별합니다. 만약 여러분의 게임이 단일 서버로 운영 중이라면 서버 코드로는 GLOBAL을 이용합니다. 이후 서버가 추가된다면 추가된 서버의 코드는 GLOBAL-2, GLOBAL-3 순으로 설정합니다.
다음의 표를 참고하여 서버 표기 방법과 각 서버별로 추가할 수 있는 서버 개수를 확인하세요.
| 서버 | 서버 지역 코드 | JSON 입력 코드 | DB 입력 코드 |
|---|---|---|---|
| QA 서버 | QA | QA ~ QA-3 | 11–13 |
| 알파 서버 | ALPHA | ALPHA ~ ALPHA-3 | 14 –16 |
| 베타 서버 | BETA | BETA ~ BETA-3 | 17–19 |
| 글로벌 | GLOBAL | GLOBAL ~ GLOBAL-10 | 21–30 |
| 유럽 | EU | EU ~ EU-10 | 31–40 |
| 동남아 | SEA | SEA ~ SEA-10 | 41–50 |
| 일본 | JP | JP ~ JP-10 | 51–60 |
| 중국 | CN | CN ~ CN-10 | 61–70 |
| 한국 | KR | KR ~ KR-10 | 71–80 |
| 미국 | US | US ~ US-10 | 81–90 |
| 360 마켓 | 360 | 360–360-10 | 91–100 |
| 바이두 마켓 | BAIDU | BAIDU ~ BAIDU-10 | 101-110 |
| 대만 | TW | TW ~ TW-10 | 111-120 |
Note
개발 서버에서 사용하는 DEV, TEST 등 코드 목록에서 정의하지 않은 임의 값으로 코드를 전송할 경우, DB 입력 코드는 모두 127로 처리됩니다.
로그별 스펙¶
HIVE 애널리틱스는 다음과 같은 로그 스펙을 제공합니다.
| 갱신일 | 로그 이름 | 필수 적용 대상 | 로그 카테고리 약어 |
|---|---|---|---|
| ◎ 필수 로그 | |||
| 19.05.28 | 로그인 로그 | 모든 게임 | login |
| 19.05.28 | 신규 유저 로그 | 모든 게임 | new_user |
| 19.05.28 | 구매 로그 | 모든 게임 | purchase |
| 19.05.28 | 스코어 로그 v2 | 모든 게임 | score2 |
| 19.05.28 | 재화 변동 로그 v2 | 모든 게임 | asset_var |
| - | 동접 로그 API | 모든 게임, 동접 로그는 API로 제공합니다 | - |
| ◎ 옵셔널 로그 | |||
| 19.05.28 | 캐릭터 로그인 로그 | 캐릭터 기반 게임 | character_login |
| 19.05.28 | 캐릭터 생성 로그 | 캐릭터 기반 게임 | character_creation |
| 19.05.28 | 재화 총통화 요약 로그 | 게임 서버 일일 재화 요약 스냅샷 (컴투스홀딩스) | asset_snapshot_summary |
| 19.05.28 | 커스텀 로그 | 게임별 특화 로그 (컴투스) | [custom-log] evolve challenge raidnpc equip tutorial facebook levelup share grade reward donation equip2 challenge_new |
| - | 재화·스코어 메타데이터 | name 전송에 어려움이 있는 게임 | common_meta |
| ◎ 구 버전 필수 로그 | |||
| 19.05.28 | 스코어 로그 | 스코어 로그 v2로 대체 | score |
| 19.05.28 | 재화 변동 로그 | 재화 변동 로그v2로 대체 | cash_var noncash_var |
| ◎ 구 버전 옵셔널 로그 | |||
| - | 플레이 로그 | 스코어 로그로 대체 | play_log |
| - | 초대 로그 | 초대 로그 v2로 대체 | invitation |
| 추가 다운로드 완료 로그 | 모든 게임 | file_download_complete | |
| - | 방문 로그 | 방문 기능이 있는 게임 | service_metrics-visit |
| - | 게임 컨텐츠 로그 | 통합 GMS 표시할 게임 | game_content |
| - | 초대 로그 Ver.2 | 다수의 SNS, 채널을 통한 초대 기능이 있는 게임 | invitation2 |
| - | 도움 요청/수락 로그 | 도움 요청/수락 기능이 있는 게임 | help_request |
| - | 하위호환용 문서 | ||
| - | 탈퇴 로그 | 카카오 게임 | withdraw |
| - | 허브 게스트 전환 로그 | 허브 적용 게임 | guest_transition |
| - | 파일 다운로드 로그 | 추가 파일 다운로드를 사용하는 게임 (컴투스 서버팀 전용) 필요한 경우에만 적용 | file_download |
| ◎ 애널리틱스 v2 로그 정의 전송 | |||
| 18.04.12 | 로그 정의 | 애널리틱스 v2 사용 시 | ha2 |