# 핵클 이벤트 (자동 수집)

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

## 1. 자동수집 이벤트

{% hint style="info" %}
자동 수집 이벤트는 Web / App SDK 에서만 수집됩니다.
{% endhint %}

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

![이벤트 관리 > 자동 수집 이벤트](/files/isAYhX9511yuUHKI4nda)

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

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

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

<table data-full-width="true"><thead><tr><th width="194.95703125">Event Key</th><th width="350.60546875">Description</th><th width="78.82421875">Web</th><th width="77.53515625">App</th><th width="73.84765625">과금</th><th width="92.7265625">on/off</th></tr></thead><tbody><tr><td><code>$properties</code></td><td>일반 사용자 속성을 업데이트할 때 SDK에서 자동으로 만드는 이벤트입니다.</td><td>O</td><td>O</td><td>X</td><td>불가</td></tr><tr><td><code>$push_subscriptions</code></td><td>CRM 사용자 속성 중 푸시 채널의 수신 동의를 업데이트할 때 SDK에서 자동으로 만드는 이벤트입니다.</td><td>O</td><td>O</td><td>O</td><td>불가</td></tr><tr><td><code>$kakao_subscriptions</code></td><td>CRM 사용자 속성 중 카카오 메시지 채널의 수신 동의를 업데이트할 때 SDK에서 자동으로 만드는 이벤트입니다.</td><td>O</td><td>O</td><td>O</td><td>불가</td></tr><tr><td><code>$sms_subscriptions</code></td><td>CRM 사용자 속성 중 문자 메시지 채널의 수신 동의를 업데이트할 때 SDK에서 자동으로 만드는 이벤트입니다.</td><td>O</td><td>O</td><td>O</td><td>불가</td></tr></tbody></table>

## 3. CRM 캠페인 이벤트

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

<table data-full-width="true"><thead><tr><th width="200.41015625">Event Key</th><th width="370.30859375">Description</th><th width="82.42578125">Web</th><th width="76.4921875">App</th><th width="73.82421875">과금</th><th width="89.69140625">on/off</th></tr></thead><tbody><tr><td><code>$in_app_impression</code></td><td>인앱 메시지가 노출되었을때 발생하는 이벤트 입니다.</td><td>O</td><td>O</td><td>O</td><td>불가</td></tr><tr><td><code>$in_app_action</code></td><td>인앱 메시지를 클릭했을때 발생하는 이벤트 입니다.</td><td>O</td><td>O</td><td>O</td><td>불가</td></tr><tr><td><code>$push_send</code></td><td>푸시 메시지가 발송되었을때 발생하는 이벤트 입니다</td><td>X</td><td>O</td><td>O</td><td>불가</td></tr><tr><td><code>$push_click</code></td><td>푸시 메시지를 클릭했을때 발생하는 이벤트 입니다.</td><td>X</td><td>O</td><td>O</td><td>불가</td></tr><tr><td><code>$kakao_send</code></td><td>카카오 메시지가 발송되었을때 발생하는 이벤트 입니다</td><td>-</td><td>-</td><td>O</td><td>불가</td></tr><tr><td><code>$sms_send</code></td><td>문자 메시지가 발송되었을때 발생하는 이벤트 입니다</td><td>-</td><td>-</td><td>O</td><td>불가</td></tr><tr><td><code>$webhook_send</code></td><td>웹훅이 발송되었을때 발생하는 이벤트 입니다.</td><td>-</td><td>-</td><td>O</td><td>불가</td></tr><tr><td><code>$journey_entry</code></td><td>사용자가 여정에 진입했을때 발생하는 이벤트 입니다.</td><td>O</td><td>O</td><td>O</td><td>불가</td></tr><tr><td><code>$journey_node</code></td><td>사용자가 여정의 특정 노드 (단계)에 진입했을때 발생하는 이벤트 입니다.</td><td>O</td><td>O</td><td>O</td><td>불가</td></tr><tr><td><code>$journey_complete</code></td><td>사용자가 여정을 종료했을때 발생하는 이벤트 입니다.</td><td>O</td><td>O</td><td>O</td><td>불가</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hackle.io/event-management/hackle-event.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.