핵클 이벤트 (자동 수집)

이벤트 키가 $로 시작하는 이벤트는 핵클에서 별도로 관리하는 이벤트 입니다.

1. 자동수집 이벤트

자동 수집 이벤트는 Web / App SDK 에서만 수집됩니다.

이벤트 관리의 [자동수집 이벤트] 영역에서 별도로 이벤트 전송하지 않아도, 자동으로 수집되는 이벤트를 확인할 수 있습니다.

이벤트 관리 > 자동 수집 이벤트

Event Key	Description	Web	App	과금	on/off
$page_view	페이지가 로드될 때 수집되는 이벤트입니다. Web: page title App: Activity, ViewController	O	O	O	가능
$engagement	사용자가 머문 페이지와 머문 시간을 속성으로 수집합니다. 아래 데이터 분석에 활용할 수 있습니다. 페이지당 평균 체류시간 사용자당 평균 체류시간	O	O	O	가능
$session_start	세션이 시작되는 경우 자동으로 수집됩니다.	O	O	O	가능
$session_end	세션 종료 시 수집됩니다.	O	O	O	가능
$app_install	앱 설치후 첫 실행시 수집됩니다.	X	O	O	가능
$app_update	앱 업데이트후 첫 실행시 수집됩니다.	X	O	O	가능
$app_open	앱 실행 및 재활성화 시 수집됩니다.	X	O	O	가능
$app_background	앱이 활성화된 상태(포그라운드)에서 비활성화 상태(백그라운드)로 전환될 때 수집됩니다.	X	O	O	가능

2. 사용자 속성 수집 이벤트

사용자 속성을 업데이트 하기위해 SDK/API로 함수를 호출한 경우 수집되는 이벤트입니다.

Event Key	Description	Web	App	과금	on/off
$properties	일반 사용자 속성을 업데이트할 때 SDK에서 자동으로 만드는 이벤트입니다.	O	O	X	불가
$push_subscriptions	CRM 사용자 속성 중 푸시 채널의 수신 동의를 업데이트할 때 SDK에서 자동으로 만드는 이벤트입니다.	O	O	O	불가
$kakao_subscriptions	CRM 사용자 속성 중 카카오 메시지 채널의 수신 동의를 업데이트할 때 SDK에서 자동으로 만드는 이벤트입니다.	O	O	O	불가
$sms_subscriptions	CRM 사용자 속성 중 문자 메시지 채널의 수신 동의를 업데이트할 때 SDK에서 자동으로 만드는 이벤트입니다.	O	O	O	불가

3. CRM 캠페인 이벤트

CRM 캠페인의 인앱메시지, 푸시메시지, 카카오메시지, 문자메시지, 웹훅 그리고 사용자 여정에서 발생하는 이벤트는 자동 수집되며, 성과측정을 위해서 항상 수집됩니다. 수집을 해제할 수 없으며, 모두 과금 대상입니다.

Event Key	채널	Description
$in_app_impression	인앱 메시지	인앱 메시지가 노출되었을때 발생하는 이벤트 입니다.
$in_app_action	인앱 메시지	인앱 메시지를 클릭했을때 발생하는 이벤트 입니다.
$push_send	푸시 메시지	푸시 메시지가 발송되었을때 발생하는 이벤트 입니다
$push_click	푸시 메시지	푸시 메시지를 클릭했을때 발생하는 이벤트 입니다.
$kakao_send	카카오 메시지	카카오 메시지가 발송되었을때 발생하는 이벤트 입니다
$kakao_click	카카오 메시지	카카오 메시지의 링크를 클릭했을때 발생하는 이벤트 입니다. 트래킹 링크를 적용한 캠페인에서만 수집됩니다.
$sms_send	문자 메시지	문자 메시지가 발송되었을때 발생하는 이벤트 입니다
$webhook_send	웹훅	웹훅이 발송되었을때 발생하는 이벤트 입니다.
$journey_entry	사용자 여정	사용자가 여정에 진입했을때 발생하는 이벤트 입니다.
$journey_node	사용자 여정	사용자가 여정의 특정 노드 (단계)에 진입했을때 발생하는 이벤트 입니다.
$journey_complete	사용자 여정	사용자가 여정을 종료했을때 발생하는 이벤트 입니다.

이벤트 속성

각 이벤트와 함께 수집되는 속성입니다. 특정 조건에서만 수집되는 속성은 [수집 조건]에 표기했습니다.

공통 속성

$push_send, $kakao_send, $sms_send, $webhook_send에 공통으로 수집됩니다.

속성	설명	수집 조건
campaign_id	캠페인 ID
campaign_key	캠페인 키
campaign_type	캠페인 종류 (PUSH_MESSAGE, KAKAO_MESSAGE, TEXT_MESSAGE, WEBHOOK, JOURNEY)
dispatch_id	발송 요청 단위 식별자
delivery_version	발송 버전
channel_mode	채널 발송 모드
tag_ids	캠페인에 설정된 태그 ID 목록
tag_keys	캠페인에 설정된 태그 키 목록
campaign_strategy	캠페인 발송 전략
campaign_strategy_channels	발송 전략에 포함된 채널 목록
debug	테스트 발송 여부
task_id	예약 발송 작업 ID	예약 발송
task_execution_id	예약 발송 작업 실행 ID	예약 발송
task_deliver_time	예약 발송 지정 시각 (UTC)	예약 발송
experiment_id	A/B 테스트 ID	메시지 A/B 테스트
experiment_key	A/B 테스트 키	메시지 A/B 테스트
experiment_version	A/B 테스트 버전	메시지 A/B 테스트
variation_id	배정된 테스트 그룹 ID	메시지 A/B 테스트
variation_key	배정된 테스트 그룹 키	메시지 A/B 테스트
experiment_decision_reason	테스트 그룹 배정 사유	메시지 A/B 테스트

---

인앱 메시지 속성

모든 인앱 메시지 이벤트에 아래 속성이 공통으로 수집됩니다.

속성	설명
in_app_message_id	인앱 메시지 캠페인 ID
in_app_message_key	인앱 메시지 캠페인 키
in_app_message_display_type	메시지 표시 형태
decision_reason	노출 판단 사유

$in_app_impression : 메시지 노출

속성	설명
title_text	제목 텍스트
body_text	본문 텍스트
button_text	메시지에 포함된 버튼 텍스트 목록
image_url	메시지에 포함된 이미지 경로 목록

$in_app_action : 메시지 클릭

속성	설명	수집 조건
action_type	클릭 동작 종류
action_value	클릭 동작 값 (예: 이동할 URL)
action_area	클릭이 발생한 영역
button_text	클릭한 버튼의 텍스트	버튼 클릭
image_url	클릭한 이미지의 경로	이미지 클릭
image_order	클릭한 이미지가 몇 번째인지	이미지 클릭
element_id	클릭한 요소의 ID	HTML 인앱 메시지에서 trackClick 호출

---

푸시 메시지 속성

$push_send : 발송

공통 캠페인 속성에 더해 아래 속성이 수집됩니다.

속성	설명	수집 조건
push_message_title	푸시 제목
push_message_body	푸시 본문
push_message_action_type	클릭 시 동작 종류
push_message_action_value	클릭 시 동작 값
push_message_image_url	푸시 이미지 URL	이미지를 설정한 경우
push_message_large_icon_image_url	큰 아이콘 이미지 URL	큰 아이콘을 설정한 경우
platform_type	수신 기기 플랫폼 (IOS, ANDROID)
provider_type	푸시 발송 채널 (FCM, APN)
push_token	발송 대상 푸시 토큰
result	발송 결과
error	발송 실패 사유	발송 실패
push_message_id	푸시 메시지 캠페인 ID	푸시 메시지 캠페인
push_message_key	푸시 메시지 캠페인 키	푸시 메시지 캠페인
push_message_execution_id	푸시 메시지 실행 ID	푸시 메시지 캠페인

$push_click : 클릭

클릭은 SDK가 수집하므로 발송 이벤트와 속성 구성이 다릅니다.

속성	설명	수집 조건
campaign_type	캠페인 종류 (PUSH_MESSAGE, JOURNEY)
push_message_id	푸시 메시지 캠페인 ID
push_message_key	푸시 메시지 캠페인 키
push_message_execution_id	푸시 메시지 실행 ID
push_message_delivery_id	푸시 발송 건 식별자
journey_id	여정 ID	campaign_type = JOURNEY
journey_key	여정 키	campaign_type = JOURNEY
journey_node_id	메시지를 발송한 여정 노드 ID	campaign_type = JOURNEY
debug	테스트 발송 여부

---

카카오 메시지 속성

$kakao_send : 발송

공통 캠페인 속성에 더해 아래 속성이 수집됩니다.

속성	설명	수집 조건
message_type	메시지 종류 (ALIM_TALK, BASIC_BRAND_MESSAGE, FREESTYLE_BRAND_MESSAGE)
layout_type	메시지 레이아웃 (TEXT, IMAGE, WIDE_IMAGE, WIDE_ITEM_LIST, CAROUSEL_FEED, CAROUSEL_COMMERCE, COMMERCE, PREMIUM_VIDEO)	브랜드 메시지
channel_id	발송에 사용된 카카오톡 채널 ID
channel_friend_type	수신자의 채널 친구 여부
template_code	사용한 템플릿 코드	알림톡, 브랜드 메시지(기본형)
template_parameters	템플릿에 채워진 변수 값	알림톡, 브랜드 메시지(기본형)
targeting_type	수신자 타겟팅 방식	브랜드 메시지(기본형)
is_ad	광고성 메시지 여부	브랜드 메시지
is_adult	성인 대상 메시지 여부	브랜드 메시지
result	발송 결과
result_code	발송 결과 코드
result_reason	발송 결과 사유
usage_key	캐시 사용 식별자
kakao_message_id	카카오 메시지 캠페인 ID	카카오 메시지 캠페인
kakao_message_key	카카오 메시지 캠페인 키	카카오 메시지 캠페인

$kakao_click : 클릭

트래킹 링크를 적용한 캠페인에서만 수집되며, 메시지를 받은 사용자 식별자($userid, $hackleid)에 연결되어 기록됩니다. 트래킹 링크 적용 방법은 카카오 알림톡 작성하기, 카카오 브랜드 메시지 작성하기를 확인해주세요.

클릭은 발송과 별개로 수집되므로 공통 캠페인 속성 전체가 아니라 아래 속성만 수집됩니다.

속성	설명	수집 조건
url	클릭한 링크의 도착 URL. UTM 파라미터가 적용된 경우 파라미터를 포함한 값이 수집됩니다.
message_type	메시지 종류 (ALIM_TALK, BASIC_BRAND_MESSAGE, FREESTYLE_BRAND_MESSAGE)
campaign_type	클릭이 발생한 캠페인 종류 (KAKAO_MESSAGE, JOURNEY)
campaign_id	캠페인 ID
campaign_key	캠페인 키
debug	테스트 발송 여부
kakao_message_id	카카오 메시지 캠페인 ID	campaign_type = KAKAO_MESSAGE
kakao_message_key	카카오 메시지 캠페인 키	campaign_type = KAKAO_MESSAGE
journey_id	여정 ID	campaign_type = JOURNEY
journey_key	여정 키	campaign_type = JOURNEY
journey_node_id	메시지를 발송한 여정 노드 ID	campaign_type = JOURNEY
journey_node_key	메시지를 발송한 여정 노드 키	campaign_type = JOURNEY
layout_type	메시지 레이아웃 (TEXT, IMAGE, WIDE_IMAGE, WIDE_ITEM_LIST, CAROUSEL_FEED, CAROUSEL_COMMERCE, COMMERCE, PREMIUM_VIDEO)	브랜드 메시지
element_type	클릭한 요소의 종류 (BUTTON 버튼, LIST_ITEM 아이템 리스트 항목, IMAGE 이미지, COUPON 쿠폰, CAROUSEL_TAIL 캐러셀 더보기 카드)	브랜드 메시지
element_order	클릭한 요소가 몇 번째인지	element_type이 BUTTON, LIST_ITEM
card_order	클릭이 발생한 캐러셀 카드가 몇 번째인지	캐러셀 레이아웃

알림톡은 템플릿에 등록된 링크 전체가 하나의 변수여야 측정할 수 있는 구조라, 메시지 안에서 어디를 눌렀는지 구분하는 layout_type, element_type, element_order, card_order가 수집되지 않습니다. 요소별 클릭 성과를 비교하려면 브랜드 메시지(자유형·기본형)를 사용하세요.

같은 사용자가 같은 링크를 여러 번 클릭하면 클릭할 때마다 이벤트가 수집됩니다. 중복을 제거하지 않으므로, 메시지를 실제로 클릭한 사람 수를 보려면 이벤트 수가 아니라 사용자 수(UV) 기준으로 분석하세요.

---

문자 메시지 속성

$sms_send : 발송

공통 캠페인 속성에 더해 아래 속성이 수집됩니다.

속성	설명	수집 조건
message_type	메시지 종류 (SMS, LMS, MMS)
sender_id	발신번호 식별자
is_ad	광고성 메시지 여부
result	발송 결과
result_code	발송 결과 코드
result_reason	발송 결과 사유
usage_key	캐시 사용 식별자
sms_id	문자 메시지 캠페인 ID	문자 메시지 캠페인
sms_key	문자 메시지 캠페인 키	문자 메시지 캠페인

---

웹훅 속성

$webhook_send : 발송

공통 캠페인 속성에 더해 아래 속성이 수집됩니다.

속성	설명	수집 조건
http_method	요청 HTTP 메서드
webhook_endpoint	요청 대상 URL
webhook_headers	요청에 사용한 헤더
http_status_code	응답 HTTP 상태 코드	응답을 받은 경우
result	발송 결과
webhook_id	웹훅 캠페인 ID	웹훅 캠페인
webhook_key	웹훅 캠페인 키	웹훅 캠페인
webhook_execution_id	웹훅 실행 ID	웹훅 캠페인

---

사용자 여정 속성

모든 여정 이벤트에 아래 속성이 공통으로 수집됩니다.

속성	설명
journey_id	여정 ID
journey_key	여정 키
journey_execution_id	여정 실행 ID
journey_instance_id	사용자별 여정 진행 인스턴스 ID

$journey_entry : 여정 진입

공통 속성만 수집됩니다.

$journey_node : 노드 진입

속성	설명
journey_node_id	진입한 노드 ID
journey_node_key	진입한 노드 키
journey_node_type	노드 종류
journey_node_execute_status	노드 실행 결과
next_node	다음으로 이동할 노드 키

$journey_complete : 여정 종료

속성	설명
complete_node_id	종료 시점의 노드 ID
complete_node_key	종료 시점의 노드 키
complete_node_type	종료 시점의 노드 종류