이벤트 템플릿으로 수집 구조 정의하기: 이벤트 로그 전송 1편

게임 이용자의 행동을 정확하게 분석하려면 이벤트명과 속성을 일관된 기준으로 정의해야 한다. 게임에서는 로그인과 구매뿐만 아니라 콘텐츠 완료, 재화 획득, 아이템 사용 등 다양한 이용자 행동을 분석한다. 이러한 행동을 분석하려면 행동이 발생한 시점의 정보를 이벤트 로그로 수집해야 하고, 이를 위해 이벤트명과 발생 시점, 함께 전송할 속성과 자료형을 미리 정의해야 한다.

게임마다 이 항목들을 처음부터 설계하면 같은 의미의 행동도 서로 다른 이름이나 구조로 수집될 수 있다. 분석 과정에서 각 로그의 의미를 명확하게 파악하고 여러 게임의 데이터를 같은 기준으로 비교하려면 이벤트 정의부터 일관성을 갖춰야 한다.

Hive 애널리틱스의 이벤트 템플릿은 게임 분석에 자주 필요한 행동을 이벤트명과 속성이 사전 정의된 형태로 제공하는 기능이다. 이벤트 템플릿을 살펴보기 전에 로그 수집에 쓰이는 주요 용어를 먼저 정리한다.

이벤트 템플릿에는 Hive SDK를 연동하면 자동으로 수집되는 로그인과 구매 등의 이벤트도 포함되어 있다. 템플릿에 포함된 이벤트는 데이터 > 이벤트에 이벤트명과 속성이 사전 정의되어 있어 구조를 처음부터 설계하지 않고 활용할 수 있으며, 로그 전송이 완료되면 즉시 애널리틱스에서 이벤트 기반 분석을 시작할 수 있다. 이벤트나 속성을 사전에 등록하지 않고 로그를 전송한 경우에도 애널리틱스에서 활용할 수 있다.

이벤트를 선택하면 해당 이벤트로 만들 수 있는 지표를 확인할 수 있다. 속성 설정에서는 사전 정의된 항목을 검토해 분석 목적에 맞게 수정하거나 새로운 속성을 추가한다. 속성 구성을 마친 뒤 소스 생성에서 게임의 개발 환경을 선택하면 설정한 이벤트와 속성이 반영된 소스를 확인할 수 있다.

생성된 소스를 실제 개발에 적용하기 전에는 테스트 로그를 전송해 이벤트와 속성값이 의도한 구조로 수집되는지, 해당 데이터로 필요한 지표를 구성할 수 있는지 검증한다. 검증 결과를 반영하면 개발자에게 전달할 이벤트 구조와 소스를 구체화할 수 있다.

분석 담당자는 다음 순서에 따라 분석할 행동에 맞는 이벤트를 선택하고, 필요한 속성과 로그 전송 소스를 준비한다.

1. 이벤트 선택
   분석할 행동과 일치하는 이벤트 템플릿을 확인한다.
2. 속성 설정
   사전 정의된 속성을 검토하고 필요한 속성을 수정하거나 추가한다.
3. 소스 생성
   게임의 개발 환경을 선택해 설정한 이벤트와 속성이 포함된 소스를 생성한다.

콘텐츠 완료 이용자 수와 평균 플레이 시간 등을 분석하려면 contents_success 이벤트와 로그 전송 소스를 준비해야 한다. 이벤트 선택부터 소스 생성까지의 과정은 다음과 같다.

이벤트 선택

데이터 > 이벤트에서 contents_success를 선택하고 설명을 확인한다. contents_success는 게임 콘텐츠를 완료한 시점에 발생하는 이벤트로, 콘텐츠 완료 수와 완료 이용자 수, 평균 플레이 시간과 평균 점수 등의 지표를 만드는 데 활용된다. 분석 담당자는 이 정보를 바탕으로 활용할 지표를 정하고, 게임에서 이벤트가 발생해야 하는 시점을 구체화한다.

속성 설정

속성 설정에서는 contents_success에 사전 정의된 속성과 각 속성의 설명, 자료형을 확인한다. 속성은 이후 Create에서 차트를 만들 때 측정값과 차원값, 필터 조건을 구성하는 데 활용된다. contents_success에는 이용 환경을 나타내는 market과 hive_country, 이용자를 식별하는 userId와 deviceId, 콘텐츠 완료의 세부 조건을 나타내는 characterLv와 modeTypeId 등이 포함되어 있다.

appId, appIdGroup, dateTime, userId, deviceId, eventName, eventTime, identifierProvider는 시스템에서 관리하는 공통 속성으로, 속성 설정에서 수정할 수 없다. 이 가운데 userId, deviceId, identifierProvider, eventTime, eventName과 appId 또는 appIdGroup은 이벤트 로그를 전송할 때 반드시 포함해야 하는 필수 속성이다. dateTime은 전송된 eventTime을 UTC로 변환해 저장한 시각이다.

사전 정의된 속성은 필요에 따라 수정할 수 있다. 분석에 필요한 값이 빠져 있다면 편집 화면 왼쪽 하단의 Add Event +를 클릭해 새로운 속성을 추가한다. 예를 들어 캐릭터 이름을 분석에 활용하려면 characterName 속성을 추가하고 자료형을 문자형으로 설정한다. 애널리틱스에서 사전 정의하지 않은 속성이라도 로그에 포함해 전송하면 분석에 활용할 수 있다. 이렇게 저장한 이벤트와 속성은 여러 프로젝트에서 같은 수집 기준으로 쓸 수 있어, 같은 행동을 일관된 속성명과 자료형, 값의 형식과 단위로 전송할 수 있다.

소스 생성

속성 구성을 마친 뒤 소스 생성에서 클라이언트 또는 서버 개발 방식을 선택하고, 실제 게임에서 사용하는 개발 환경을 지정한다. 생성된 소스에는 설정한 이벤트명과 속성이 포함되므로, 분석 담당자는 구현에 필요한 항목이 올바르게 반영되었는지 확인한다.

생성된 소스는 개발자에게 전달해 실제 로그 전송 기능을 구현하는 데 활용한다. 개발을 요청하기 전에는 테스트 로그를 전송해 이벤트와 속성이 의도한 구조로 수집되는지, 해당 데이터로 필요한 지표를 구성할 수 있는지 미리 검증할 수 있다. 테스트 로그 검증 방법은 「테스트 로그로 수집 구조와 지표 검증하기: 이벤트 로그 전송 2편」에서 자세히 소개한다.

이벤트 템플릿을 활용하면 분석 담당자가 필요한 이벤트와 속성을 직접 구성하고, 개발 환경에 맞는 소스 형태로 로그 전송 기준을 준비할 수 있다.

Hive 애널리틱스는 Hive SDK를 통해 수집한 게임 이벤트를 기반으로 이용자 행동과 게임 지표를 분석할 수 있는 게임 전문 애널리틱스 솔루션이다. 지금 Hive 애널리틱스에서 분석하려는 게임 행동에 맞는 이벤트 템플릿을 확인하고, 필요한 속성과 개발 소스를 준비해보자.