카페24 이벤트 설명

카페24 연동 시 자동으로 수집되는 식별자, 사용자 속성, 이벤트에 대한 설명이에요.

• 쇼핑몰 방문자의 로그인 여부에 따른 식별자 정보

• 쇼핑몰 회원 정보 기반으로 설정되는 사용자 속성 정보

• 쇼핑몰 유저의 행동에 대해 자동으로 수집되는 이벤트

식별자

식별자 이름	설명
userId	쇼핑몰에 로그인한 사용자는 이 식별자가 있어요. 카페24 회원 정보 조회에서 확인할 수 있는 고객의 아이디와 동일한 값입니다.
deviceId	쇼핑몰에 로그인하지 않은 사용자는 이 식별자만을 가져요.

사용자 식별자 관리하기에서 더 자세한 내용을 볼 수 있어요.

사용자 속성

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

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

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

수집되지 않는 속성이 있나요?

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

반드시 수집되어야하는 속성 정보가 있다면 카페24 회원가입 항목 설정을 변경해보세요.

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

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

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

이벤트

실시간 이벤트

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

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

• 인앱메시지

  • O로 표시된 이벤트는 인앱메시지의 시작 이벤트로 사용할 수 있어요.

• 비회원 발송

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

수집되는 다른 정보들은 없나요?

핵클 SDK에서 자동으로 수집해주는 기본적인 속성들은 핵클 속성을 참고해주세요.

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

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

이벤트 키	주요 이벤트 속성	발생 시점	비회원 발송
cafe24_start_shipping	order_id shipping_company_name tracking_no shipping_status is_member + 주문 관련 속성	배송 시작	O
cafe24_start_shipping_items	cafe24_start_shipping과 유사	배송 시작 (상품별)	O
cafe24_complete_shipping	cafe24_start_shipping과 동일	배송 완료	O
cafe24_complete_shipping_items	cafe24_start_shipping_items와 동일	배송 완료 (상품별)	O
cafe24_hold_shipping	cafe24_start_shipping과 동일	배송 보류	O
cafe24_hold_shipping_items	cafe24_start_shipping_items와 동일	배송 보류 (상품별)	O
cafe24_order_tracking_no_change	order_id shipping_company_name tracking_no	송장번호 변경

커스텀 이벤트

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

GTM 연동

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

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

자세한 내용은 GTM 연동을 참고해주세요.