# 카페24 이벤트 설명

{% hint style="info" %}
카페24 연동 시 자동으로 수집되는 식별자, 사용자 속성, 이벤트에 대한 설명이에요.

* 쇼핑몰 방문자의 로그인 여부에 따른 식별자 정보
* 쇼핑몰 회원 정보 기반으로 설정되는 사용자 속성 정보
* 쇼핑몰 유저의 행동에 대해 자동으로 수집되는 이벤트
  {% endhint %}

## 식별자

<table><thead><tr><th width="154.6171875">식별자 이름</th><th>설명</th></tr></thead><tbody><tr><td>userId</td><td>쇼핑몰에 로그인한 사용자는 이 식별자가 있어요.<br><a href="https://support.cafe24.com/hc/ko/articles/7740172361881-%ED%9A%8C%EC%9B%90-%EC%A0%95%EB%B3%B4-%EC%A1%B0%ED%9A%8C">카페24 회원 정보 조회</a>에서 확인할 수 있는 고객의 아이디와 동일한 값입니다.</td></tr><tr><td>deviceId</td><td>쇼핑몰에 로그인하지 않은 사용자는 이 식별자만을 가져요.</td></tr></tbody></table>

{% hint style="info" %}
[사용자 식별자 관리하기](/getting-started/user-identifier.md)에서 더 자세한 내용을 볼 수 있어요.
{% endhint %}

## 사용자 속성

### 페이지 접속 시 수집되는 속성

사용자가 쇼핑몰 페이지에 접속할 때 실시간으로 수집해요.

<table data-full-width="true"><thead><tr><th width="280">속성명</th><th>설명</th></tr></thead><tbody><tr><td><code>mall_id</code></td><td>Cafe24 몰 식별자</td></tr><tr><td><code>event_shop_no</code></td><td>Cafe24 샵 번호</td></tr><tr><td><code>member_id</code></td><td>회원 아이디 (<code>userId</code> 값과 동일)</td></tr><tr><td><code>name</code></td><td>회원 이름</td></tr><tr><td><code>nick_name</code></td><td>회원 닉네임</td></tr><tr><td><code>email</code></td><td>이메일 주소</td></tr><tr><td><code>phone</code></td><td>전화번호</td></tr><tr><td><code>is_birthday</code></td><td>생일 정보 ("T" / "F")</td></tr><tr><td><code>group_name</code></td><td>회원 그룹명</td></tr><tr><td><code>group_no</code></td><td>회원 그룹 번호</td></tr><tr><td><code>additional_information</code></td><td>추가 회원 정보</td></tr><tr><td><code>authentication_method</code></td><td>인증 방식</td></tr><tr><td><code>created_date</code></td><td>가입 날짜 (yyyymmdd 형식)</td></tr><tr><td><code>created_datetime</code></td><td>가입 일시 (ISO 형식)</td></tr><tr><td><code>available_point</code></td><td>사용 가능한 포인트</td></tr><tr><td><code>total_point</code></td><td>전체 적립 포인트</td></tr><tr><td><code>used_point</code></td><td>사용한 포인트</td></tr><tr><td><code>returned_point</code></td><td>반환된 포인트</td></tr><tr><td><code>unavailable_point</code></td><td>사용 불가능한 포인트</td></tr><tr><td><code>all_credit</code></td><td>전체 예치금</td></tr><tr><td><code>member_total_credit</code></td><td>회원 전체 예치금</td></tr><tr><td><code>total_credit</code></td><td>총 예치금</td></tr><tr><td><code>used_credit</code></td><td>사용한 예치금</td></tr><tr><td><code>refund_wait_credit</code></td><td>환불 대기 중인 예치금</td></tr><tr><td><code>news_mail</code></td><td>뉴스메일 수신 동의 여부</td></tr><tr><td><code>sms</code></td><td>SMS 수신 동의 여부</td></tr><tr><td><code>is_login</code></td><td>현재 로그인 상태</td></tr><tr><td><code>coupon_count</code></td><td>보유 쿠폰 개수</td></tr><tr><td><code>last_login_provider</code></td><td>마지막 로그인에 사용한 인증 제공자</td></tr><tr><td><code>last_seen_product_no</code></td><td>마지막으로 본 상품 번호</td></tr><tr><td><code>last_visit_page</code></td><td>마지막으로 방문한 페이지</td></tr><tr><td><code>last_visit_date</code></td><td>마지막 방문 날짜 (yyyy-mm-dd 형식)</td></tr><tr><td><code>cafe_mkt</code></td><td>URL의 cafe_mkt 파라미터 값</td></tr><tr><td><code>cart_total_quantity</code></td><td>장바구니 전체 상품 수량</td></tr><tr><td><code>cart_items_count</code></td><td>장바구니 아이템 행 개수</td></tr><tr><td><code>cart_items_unique_count</code></td><td>장바구니 내 고유 상품 종류 수</td></tr><tr><td><code>cart_total_order_price</code></td><td>장바구니 총 주문 금액</td></tr><tr><td><code>cart_option_ids</code></td><td>장바구니 내 옵션 ID 배열</td></tr><tr><td><code>cart_product_nos</code></td><td>장바구니 내 상품 번호 배열</td></tr><tr><td><code>cart_comb_product_no_option_id</code></td><td>장바구니 상품번호와 옵션ID 조합 배열</td></tr><tr><td><code>guestId</code></td><td>Cafe24 게스트 ID (Custom Identifier)</td></tr><tr><td><code>cvid</code></td><td>Cafe24 방문자 ID 쿠키 (Custom Identifier)</td></tr><tr><td><code>cvid_y</code></td><td>Cafe24 방문자 연간 ID 쿠키 (Custom Identifier)</td></tr></tbody></table>

{% hint style="info" %}
**수집되지 않는 속성이 있나요?**

모든 정보는 카페24에서 제공해주는 값을 바탕으로 수집하고 있어요.

반드시 수집되어야하는 속성 정보가 있다면 [**카페24 회원가입 항목 설정**](https://support.cafe24.com/hc/ko/articles/7751397711257--%EB%8F%99%EC%98%81%EC%83%81%EA%B0%80%EC%9D%B4%EB%93%9C-%ED%9A%8C%EC%9B%90-%EA%B0%80%EC%9E%85-%ED%95%AD%EB%AA%A9-%EC%84%A4%EC%A0%95)을 변경해보세요.
{% endhint %}

### 주기적으로 업데이트되는 속성

{% hint style="warning" %}
핵클 서버가 주기적으로 정보를 수집하여 사용자 속성을 업데이트해요. 수집을 위해서는 핵클 팀에 별도로 연락해주세요.
{% endhint %}

<table data-full-width="true"><thead><tr><th width="280">속성명</th><th>설명</th></tr></thead><tbody><tr><td><code>cart_items_last_added_date</code></td><td>장바구니 마지막 상품 추가 일자</td></tr><tr><td><code>order_first_date</code></td><td>첫 주문 날짜</td></tr><tr><td><code>order_last_date</code></td><td>마지막 주문 날짜</td></tr><tr><td><code>order_total_count</code></td><td>총 주문 횟수</td></tr><tr><td><code>cp_{couponNo}_issued_date</code></td><td>쿠폰별 발급일</td></tr><tr><td><code>cp_{couponNo}_expire_date</code></td><td>쿠폰별 만료일</td></tr><tr><td><code>cp_{couponNo}_used_date</code></td><td>쿠폰별 사용일 (null 가능)</td></tr><tr><td><code>cp_{couponNo}_use_flag</code></td><td>쿠폰별 사용 여부</td></tr><tr><td><code>birthday</code></td><td>생년월일 (yyyyMMdd 형식)</td></tr><tr><td><code>birthdate</code></td><td>생일 월일 (MM-dd 형식)</td></tr><tr><td><code>birthday_year</code></td><td>출생 연도 (yyyy 형식)</td></tr><tr><td><code>solar_calendar</code></td><td>양력/음력 구분 ("양력" 또는 "음력")</td></tr></tbody></table>

## 이벤트

### 실시간 이벤트

사용자 행동 발생 시 실시간으로 수집해요.

<table data-full-width="true"><thead><tr><th width="200">이벤트 키</th><th>주요 이벤트 속성</th><th width="200">발생 시점</th><th width="100">인앱메시지</th><th width="100">비회원 발송</th></tr></thead><tbody><tr><td><strong>$page_view</strong></td><td><code>$page_name</code></td><td>모든 페이지 진입 시</td><td>O</td><td></td></tr><tr><td><strong>$engagement</strong></td><td><code>$page_name</code><br><code>$engagement_time_ms</code></td><td>브라우저의 활성 상태가 변경되었을 때</td><td>O</td><td></td></tr><tr><td><strong>$session_start</strong></td><td></td><td>세션이 시작되었을 때</td><td>O</td><td></td></tr><tr><td><strong>$session_end</strong></td><td></td><td>세션이 끝났을 때</td><td>O</td><td></td></tr><tr><td><strong>view_home</strong></td><td><code>utm_campaign</code><br><code>utm_content</code><br><code>utm_id</code><br><code>utm_medium</code><br><code>utm_source</code><br><code>utm_term</code></td><td>메인 페이지 진입 시</td><td>O</td><td></td></tr><tr><td><strong>view_product</strong></td><td><code>product_no</code><br><code>product_name</code><br><code>price</code><br><code>utm_*</code></td><td>상품 상세 페이지 진입 시</td><td>O</td><td></td></tr><tr><td><strong>view_product_list</strong></td><td><code>category_name</code><br><code>cate_no</code><br><code>utm_*</code></td><td>카테고리/상품 목록 페이지 진입 시</td><td>O</td><td></td></tr><tr><td><strong>view_cart</strong></td><td><code>total_quantity</code><br><code>total_order_price</code><br><code>product_nos</code><br><code>product_names</code><br><code>utm_*</code></td><td>장바구니 페이지 진입 시</td><td>O</td><td></td></tr><tr><td><strong>view_checkout</strong></td><td><code>discounted_price</code><br><code>price</code><br><code>is_surl</code><br><code>product_no</code><br><code>utm_*</code></td><td>주문서 작성 페이지 진입 시</td><td>O</td><td></td></tr><tr><td><strong>view_completed_order</strong></td><td><code>order_id</code><br><code>discounted_price</code><br><code>price</code><br><code>delivery_fee</code><br><code>utm_*</code></td><td>주문 완료 페이지 진입 시</td><td>O</td><td></td></tr><tr><td><strong>scroll_home</strong></td><td><code>depth</code> (5단위 스크롤 깊이)</td><td>메인 페이지에서 유저가 스크롤 시</td><td>O</td><td></td></tr><tr><td><strong>scroll_product</strong></td><td><code>product_no</code><br><code>depth</code></td><td>상품 상세 페이지에서 유저가 스크롤 시</td><td>O</td><td></td></tr><tr><td><strong>click_buy_cart</strong></td><td><code>product_no</code><br><code>price</code><br><code>discounted_price</code><br><code>purchase_unit</code><br><code>checkout_type</code></td><td>장바구니에서 구매 버튼 클릭</td><td>O</td><td></td></tr><tr><td><strong>click_buy_product</strong></td><td><code>product_no</code><br><code>price</code><br><code>discounted_price</code><br><code>purchase_unit</code><br><code>checkout_type</code></td><td>상품 상세에서 바로 구매 클릭</td><td>O</td><td></td></tr><tr><td><strong>click_buy_checkout</strong></td><td></td><td>주문서에서 결제하기 클릭</td><td>O</td><td></td></tr><tr><td><strong>cafe24_signup</strong></td><td><code>name</code><br><code>nick_name</code><br><code>birthday</code><br><code>gender</code><br><code>cellphone</code></td><td>신규 회원가입</td><td></td><td></td></tr><tr><td><strong>cafe24_login</strong></td><td><code>member_id</code><br><code>group_name</code><br><code>inflow_name</code></td><td>회원 로그인</td><td></td><td></td></tr><tr><td><strong>cafe24_add_to_cart</strong></td><td><code>add_to_cart_product_name</code><br><code>total_quantity</code><br><code>product_nos</code><br><code>product_names</code></td><td>장바구니 담기</td><td></td><td></td></tr><tr><td><strong>cafe24_add_to_cart_items</strong></td><td><code>product_no</code><br><code>product_name</code><br><code>quantity</code><br><code>product_price</code><br><code>option_value</code></td><td>장바구니 담기 (상품별)</td><td></td><td></td></tr><tr><td><strong>cafe24_order_form</strong></td><td><code>total_quantity</code><br><code>items_count</code><br><code>total_order_price</code><br><code>product_nos</code><br><code>product_names</code></td><td>주문서 진입</td><td></td><td></td></tr><tr><td><strong>cafe24_order_form_items</strong></td><td><code>product_no</code><br><code>product_name</code><br><code>quantity</code><br><code>product_price</code><br><code>option_value</code></td><td>주문서 진입 (상품별)</td><td></td><td></td></tr><tr><td><strong>cafe24_complete_order</strong></td><td><code>order_id</code><br><code>payment_method</code><br><code>is_first_order</code><br><code>order_amount</code><br><code>items_count</code><br><code>is_member</code></td><td>주문 완료</td><td></td><td>O</td></tr><tr><td><strong>cafe24_complete_order_items</strong></td><td>cafe24_complete_order와 유사</td><td>주문 완료 (상품별)</td><td></td><td>O</td></tr><tr><td><strong>cafe24_cancel_order</strong></td><td><code>order_id</code><br><code>claim_reason_type</code><br><code>claim_reason</code><br><code>claim_reason_type_text</code><br><code>is_member</code></td><td>주문 취소</td><td></td><td>O</td></tr><tr><td><strong>cafe24_cancel_order_items</strong></td><td>cafe24_cancel_order와 유사</td><td>주문 취소 (상품별)</td><td></td><td>O</td></tr><tr><td><strong>cafe24_return_order</strong></td><td>cafe24_cancel_order와 동일</td><td>주문 반품</td><td></td><td>O</td></tr><tr><td><strong>cafe24_return_order_items</strong></td><td>cafe24_cancel_order_items와 동일</td><td>주문 반품 (상품별)</td><td></td><td>O</td></tr><tr><td><strong>cafe24_refund_order</strong></td><td>cafe24_cancel_order와 동일</td><td>주문 환불</td><td></td><td>O</td></tr><tr><td><strong>cafe24_refund_order_items</strong></td><td>cafe24_cancel_order_items와 동일</td><td>주문 환불 (상품별)</td><td></td><td>O</td></tr></tbody></table>

{% hint style="info" %}

* **인앱메시지**
  * O로 표시된 이벤트는 인앱메시지의 시작 이벤트로 사용할 수 있어요.
* **비회원 발송**
  * O로 표시된 이벤트는 이벤트 기반 캠페인(카카오/문자-이벤트 기반, 사용자 여정)에서 카페24 비회원에게도 카톡/문자를 발송할 수 있어요. 비회원 발송을 위해서는 핵클 팀에 문의해주세요!
    {% endhint %}

{% hint style="info" %}
**수집되는 다른 정보들은 없나요?**

핵클 SDK에서 자동으로 수집해주는 기본적인 속성들은 [핵클 속성](/event-management/properties/hackle-property.md)을 참고해주세요.
{% endhint %}

### 주기적으로 발행되는 이벤트

{% hint style="warning" %}
핵클 서버가 자동으로 수집하여 주기적으로 발행하는 이벤트예요. 이 이벤트들을 이용한 CRM 캠페인을 기획하고 계시다면 핵클 팀에 문의해 주세요.
{% endhint %}

<table data-full-width="true"><thead><tr><th width="280">이벤트 키</th><th>주요 이벤트 속성</th><th width="200">발생 시점</th><th width="100">비회원 발송</th></tr></thead><tbody><tr><td><strong>cafe24_start_shipping</strong></td><td><code>order_id</code><br><code>shipping_company_name</code><br><code>tracking_no</code><br><code>shipping_status</code><br><code>is_member</code><br>+ 주문 관련 속성</td><td>배송 시작</td><td>O</td></tr><tr><td><strong>cafe24_start_shipping_items</strong></td><td>cafe24_start_shipping과 유사</td><td>배송 시작 (상품별)</td><td>O</td></tr><tr><td><strong>cafe24_complete_shipping</strong></td><td>cafe24_start_shipping과 동일</td><td>배송 완료</td><td>O</td></tr><tr><td><strong>cafe24_complete_shipping_items</strong></td><td>cafe24_start_shipping_items와 동일</td><td>배송 완료 (상품별)</td><td>O</td></tr><tr><td><strong>cafe24_hold_shipping</strong></td><td>cafe24_start_shipping과 동일</td><td>배송 보류</td><td>O</td></tr><tr><td><strong>cafe24_hold_shipping_items</strong></td><td>cafe24_start_shipping_items와 동일</td><td>배송 보류 (상품별)</td><td>O</td></tr><tr><td><strong>cafe24_order_tracking_no_change</strong></td><td><code>order_id</code><br><code>shipping_company_name</code><br><code>tracking_no</code></td><td>송장번호 변경</td><td></td></tr></tbody></table>

## 커스텀 이벤트

플러그인이 자동으로 수집해주는 이벤트 외에 커스텀 이벤트를 생성할 수 있어요.

### GTM 연동

카페24 워크스페이스의 커스텀 이벤트를 생성할 때는 GTM(Google Tag Manager)을 활용하는 것을 권장드려요.

기존에 사용하고 있던 `트리거` 나 `태그`가 있다면 이를 활용해 핵클로 이벤트를 전송할 수 있어요.

자세한 내용은 [GTM 연동](/development-guide/google-tag-manager.md)을 참고해주세요.


---

# 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/cafe-24/events.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.