가이드 문서
Go to Docs (EN)Sign in to Dashboard

이벤트

Suggest Edits

이벤트

event라는 단어를 영한사전에서 찾아보면 사전적 의미 중 사건이 있습니다. 즉 무언가 발생했다, 일어났다는 의미입니다.

위와 같은 맥락으로, 이벤트(Event)는 사용자가 웹 사이트, 모바일 애플리케이션, 시스템 등을 사용할 때 하는 행동, 혹은 행동으로 인해 발생하는 사건입니다. 사용자의 행동 중에는 검색 버튼 클릭, 상품 페이지 진입, 구매완료 등이 있으며, 그 외 주문서 로딩 시간, 서버 API 처리 시간, 모바일 앱 크래시 등도 이벤트로 볼 수 있습니다.

핵클 대시보드에서 어떤 행동에 대한 이벤트를 정의하고 핵클 플랫폼을 연동하면 이벤트가 발생한 내역을 수집할 수 있습니다. 이벤트에 해당된 행동이 일어난 경우 핵클이 이벤트가 발생했음을 기록하며, 기록된 이벤트는 여러 용도로 사용할 수 있습니다.

핵클의 경우 다음의 처리를 위해 이벤트가 필요합니다.

  • A/B 테스트의 지표(metric)를 계산
  • 데이터 분석
  • 사용자 퍼널 분석

이벤트 목록

대시보드 좌측의 이벤트 관리 메뉴를 클릭하고, 진입하면 생성된 이벤트 목록을 볼 수 있습니다.

이벤트 목록에서 할 수 있는 일은 다음과 같습니다.

  • 이벤트 목록 보기
  • 새 이벤트 생성하기
  • 이벤트 데이터 추출하기
  • 이벤트 상태 변경 하기 (켜짐 <-> 꺼짐)
  • 이벤트 상태 별로 보기
  • 이벤트 최근 수집 현황 보기
  • 이벤트 즐겨찾기하기 (켜짐 <-> 꺼짐)
  • 이벤트 키 값으로 검색하기

새 이벤트 생성하기

이벤트 생성하기 문서를 참고하시기 바랍니다.


이벤트 데이터 추출하기

이벤트 데이터 추출하기 문서를 참고하시기 바랍니다.


이벤트 상태 변경 하기

각 이벤트의 가장 우측에 있는 토글 버튼을 이용하여 이벤트 상태를 변경할 수 있습니다.

이벤트를 꺼짐 상태로 변경할 경우 A/B 테스트 및 사용자 퍼널 분석에서 사용할 수 없으므로 해당 이벤트가 불필요한 상황인지 확인해주시기 바랍니다.


이벤트 상태 별로 보기

이벤트 리스트 좌측 상단의 드롭다운 메뉴를 클릭하면 켜짐 이벤트 / 꺼짐 이벤트 / 모든 이벤트 세 가지 옵션을 확인할 수 있습니다.

  • 켜짐 이벤트: 이벤트 상태가 켜짐인 이벤트만 볼 수 있습니다.
  • 꺼짐 이벤트: 이벤트 상태가 꺼짐인 이벤트만 볼 수 있습니다.
  • 모든 이벤트: 모든 이벤트 목록을 볼 수 있습니다.

이벤트 상세

이벤트 목록에서 특정 이벤트 키를 클릭하면 보다 상세한 내용을 볼 수 있습니다. 아래는 예시 이벤트 키의 상세 화면입니다.

이벤트 상세에서 확인할 수 있는 내용은 다음과 같습니다.

  • 이벤트 키
  • 이벤트 설명
  • 이벤트 태그
  • 이벤트 상태
  • 이벤트 이미지
  • 이벤트 실시간 수집 현황 (최근 30분간 이벤트 전송 현황)
  • 이벤트와 함께 수집되는 속성 정보 (속성 이름, 속성 유형, 설명)
  • 이벤트 속성 추가
  • 이벤트 분석

이벤트 상태

현재 이 이벤트가 켜짐 상태인지 혹은 꺼짐 상태인지를 나타냅니다.
목록에서와 마찬가지로 토글 버튼을 이용하여 켜짐 혹은 꺼짐 상태로 변경할 수 있습니다.


이벤트 이미지

이벤트 이름이나 설명만으로 전달하기 어려운 이벤트가 있다면 이미지를 업로드하여, 해당 이벤트에 대한 정보를 팀원들과 공유할 수 있습니다. 이벤트가 어디서 발생하는지 언제 발생하는지 화면을 캡쳐하여 표시한 이미지를 업로드한다면 유용하게 사용하실 수 있습니다. 이벤트 이미지 영역에 마우스를 갖다 대면 확대 및 삭제가 가능하며 언제든 수정하실 수 있습니다. 단, 10MB 이하의 이미지 파일 (jpg, png)을 1개만 업로드 하실 수 있습니다.


이벤트와 함께 수집되는 속성 정보

이벤트가 발생될 때 추가적으로 함께 수집되는 부가 정보들을 의미합니다. 자세한 내용은 '이벤트 속성' 에서 확인하실 수 있습니다.


실시간 수집 현황 (최근 30분간 이벤트 전송 현황)

최근 30분 동안 핵클로 해당 이벤트 키가 전송된 경우 전송 횟수를 선 그래프로 보여줍니다. 이 그래프는 30초 단위로 새로고침 합니다.
이 그래프를 통해서 이벤트를 정상적으로 전송하고 있는지 여부를 알 수 있습니다.


최근 30분간 전송된 이벤트의 로그

최근 30분 동안 핵클로 전송된 이벤트의 발생시간, 사용자 식별자, 사용자 속성 정보, 이벤트 속성 정보를 확인할 수 있습니다.

  • 사용자 속성 정보: 아래 이미지에서 'User'로 기재된 속성 열의 사용자 항목입니다.
  • 이벤트 속성 정보: 아래 이미지에서 'Event'로 기재된 속성 열의 이벤트 항목입니다.

운영 환경과 개발 환경 별로 별도 집계하고 있으니 환경을 꼭 확인하시기 바랍니다.


이벤트 분석

데이터 조회기간(최근 7일/30일/90일)을 선택하면 선택한 조건에 맞는 이벤트 데이터 집계 결과를 발생횟수, 발생시킨 사용자 수별로 확인할 수 있습니다.


핵클 향상된 측정

이벤트 관리의 [향상된 측정]에서 SDK 연동 시 자동으로 수집할 수 있는 이벤트를 확인할 수 있습니다.

자동으로 수집하는 이벤트는 현재 $engagement, $session_start, $session_end, $page_view, $properties를 제공하고 있습니다.

  1. $page_view
    1. 페이지가 로드될 때 수집되는 이벤트입니다.
    2. Web, App 최신 SDK를 사용하면 자동으로 수집됩니다.
    3. Web인 경우 page title, App인 경우 Activity, ViewController를 속성으로 수집합니다.
  2. $engagement
    1. 사용자가 특정 페이지에 머문 시간을 자동으로 수집합니다.
    2. Web, App 최신 SDK를 사용하면 자동으로 수집됩니다.
    3. 사용자가 머문 페이지와 머문 시간을 속성으로 수집합니다.
    4. 페이지당 평균 체류시간, 사용자당 평균 체류시간 등을 분석할 수 있습니다.
  3. $session_start
    1. 세션이 시작*되는 경우 자동으로 수집됩니다.
    2. Web, App 최신 SDK를 사용하면 자동으로 수집됩니다.
    3. 세션 시작 후의 유저의 행동 패턴 등을 분석할 수 있습니다.
  4. $session_end
    1. 세션 종료 시 수집됩니다.
    2. Web, App 최신 SDK를 사용하면 자동으로 수집됩니다.
    3. 세션을 종료하기까지의 유저의 행동 패턴 등을 분석할 수 있습니다.
  5. $properties
    1. 사용자 속성을 업데이트할 때 SDK에서 자동으로 만드는 이벤트입니다.


*세션이 시작되는 기준

핵클에서는 사용자가 포그라운드에서 앱을 열거나 페이지를 보고 현재 활성화된 세션이 없을 때 (예: 이전 세션 시간이 타임아웃 되었을 때) 세션이 시작됩니다. 기본적으로 세션은 사용자의 활동이 멈춘 후 30분 뒤에 종료(타임아웃)되며, 세션 지속 시간에는 제한이 없습니다.

자세한 사항은 자주 묻는 질문을 확인해 주세요.

Updated 4 months ago