카페24 연동
카페24를 사용 중이면 플레어레인을 더욱 쉽게 사용할 수 있습니다.
본 가이드에서는 플레어레인 설치 방법 및 플레어레인의 자동 수집 데이터에 대해 설명합니다.
플레어레인 설치 방법
Section titled “플레어레인 설치 방법”카페24 웹사이트에 웹푸시(Web Push)를 쉽게 개발 및 구현하는 방법을 알아봅니다. 카페24 플레어레인 앱을 통해 클릭 몇 번만으로 웹 푸시를 더욱 쉽게 설치할 수 있습니다.
카페24 앱스토어로 연동하기
Section titled “카페24 앱스토어로 연동하기”1. 카페24 플레어레인 앱 설치
Section titled “1. 카페24 플레어레인 앱 설치”카페24 앱스토어에 있는 ‘플레어레인’ 앱 사이트에 접속하여 [설치하기] 버튼을 클릭하고, 정보 활용 동의를 합니다.

2. 플레어레인 연동 과정 시작
Section titled “2. 플레어레인 연동 과정 시작”
동의 후, 플레어레인-카페24 연동 사이트에서 다시 한 번 [설치하기] 버튼을 클릭합니다.
3. 초기 설정 정보 입력
Section titled “3. 초기 설정 정보 입력”
미리보기를 참고하여 사이트명을 입력합니다. 입력한 사이트명은 향후 알림 제목 미입력 시 대신 사용됩니다.
4. 웹 푸시 설치 완료
Section titled “4. 웹 푸시 설치 완료”
모든 연동이 완료되면 유저가 웹사이트 방문 시 구독을 위한 팝업이 노출됩니다. (언어는 브라우저 언어에 따라 다름)

허용을 누르면 자동으로 해당 유저는 알림 구독 상태가 되며, 이후 브라우저를 벗어나도 알림을 받을 수 있는 상태가 됩니다.
이후 [웹 푸시 세부 설정하기] 버튼을 통해 노출되는 팝업 및 위젯의 세부 설정을 진행할 수 있습니다.
자동 수집 데이터
Section titled “자동 수집 데이터”
카페24 플레어레인 앱을 사용하면 별도 개발 없이 각종 데이터가 자동으로 수집되어 더욱 편리하게 사용할 수 있습니다. 설치한 카페24 플레어레인 앱을 통해 유저 ID·이벤트·유저프로필 & 태그·쿠폰 데이터가 자동으로 수집됩니다.
유저(User)는 카페24 회원 계정과 1:1로 연결되며, 유저 ID는 카페24 회원 아이디와 동일하게 부여됩니다. 유저는 회원이 로그인하는 시점 또는 약 60분 주기의 정기 동기화 시점에 생성·갱신됩니다.
방문자가 웹사이트에서 알림 수신을 허용하면 기기(Device)가 생성되고, 이후 로그인 시 해당 기기가 유저 ID와 자동으로 연동됩니다.
이때 이름·전화번호·이메일 등 주요 프로필도 함께 연동되어, 별도 작업 없이 문자·카카오톡·이메일 등 다채널 발송이 가능한 상태가 됩니다.
유저 프로필과 태그는 수집 시점에 따라 아래와 같이 갱신됩니다. 구분 값에 따라 각각 유저 프로필과 태그로 연동됩니다.
첫 페이지 접속 시
Section titled “첫 페이지 접속 시”방문 즉시 확인할 수 있는 기본 정보가 연동됩니다.
| 필드 | 구분 | 설명 |
|---|---|---|
| name | 프로필 | 회원 이름 |
| phone | 프로필 | 휴대전화번호 (E.164 형식) |
| 프로필 | 이메일 | |
| groupName | 태그 | 회원 등급명 |
| group_no | 태그 | 회원 그룹 번호 |
| created_date | 태그 | 가입일 |
| available_point | 태그 | 사용 가능 포인트 |
| total_point | 태그 | 누적 적립 포인트 |
| used_point | 태그 | 사용한 포인트 |
| returned_point | 태그 | 반환된 포인트 |
| unavailable_point | 태그 | 사용 불가 포인트 |
| all_credit | 태그 | 전체 예치금 |
| member_total_credit | 태그 | 회원 전체 예치금 |
| total_credit | 태그 | 총 예치금 |
| used_credit | 태그 | 사용한 예치금 |
| refund_wait_credit | 태그 | 환불 대기 예치금 |
| nick_name | 태그 | 회원 닉네임 |
| is_birthday | 태그 | 생일 여부 (접속일이 생일이면 Y) |
| guest_id | 태그 | 로그인 전 부여되는 ID |
정기 동기화(약 60분 주기)
Section titled “정기 동기화(약 60분 주기)”유저 정보는 약 60분 주기로 갱신됩니다. 생년월일(dob), 수신 동의 여부처럼 첫 페이지 접속 시점에는 수집되지 않는 값도 이 단계에서 함께 연동됩니다.
| 필드 | 구분 | 설명 |
|---|---|---|
| dob | 프로필 | 생년월일 (yyyy-MM-dd 형식) |
| name | 프로필 | 회원 이름 |
| phone | 프로필 | 휴대전화번호 (E.164 형식) |
| 프로필 | 이메일 | |
| nick_name | 태그 | 회원 닉네임 |
| groupName | 태그 | 회원 등급명 |
| group_no | 태그 | 회원 그룹 번호 |
| available_point | 태그 | 사용 가능 포인트 |
| total_point | 태그 | 누적 적립 포인트 |
| used_point | 태그 | 사용한 포인트 |
| news_email | 태그 | 뉴스메일 수신 동의 여부 (Y / N) |
| sms | 태그 | SMS 수신 동의 여부 (Y / N) |
| created_date | 태그 | 가입일 |
주문·로그인 시
Section titled “주문·로그인 시”유저의 주문 접수·로그인 행동이 발생할 때 갱신되는 태그입니다.
| 필드 | 구분 | 연동 시점 | 설명 |
|---|---|---|---|
| first_order_date | 태그 | 주문 접수 시 | 첫 주문일 |
| last_order_date | 태그 | 주문 접수 시 | 마지막 주문일 |
| last_login_date | 태그 | 로그인 시 | 마지막 로그인일 |
쿠폰은 유저 프로필·태그와 별개 데이터로 연동됩니다.
콘솔에서 [대상] → [유저] → [전체 유저] 또는 [대상] → [기기] → [전체 기기] 목록으로 이동한 뒤, 유저의 [쿠폰] 버튼을 눌러 해당 유저·기기가 보유한 쿠폰 정보를 확인할 수 있습니다.
| 항목 | 값 형식 |
|---|---|
| 쿠폰 번호 | 문자열 (예: Y0013200) |
| 발행일 | 날짜 (예: 2026.05.12) |
| 만료일 | 날짜 (예: 2026.05.17) |
| 사용 여부 | 문자열 (예: Y / N) |
쿠폰 정보는 다음 두 가지 방식으로 연동됩니다.
| 연동 방식 | 연동 시점 |
|---|---|
| 실시간 | 첫 페이지 접속 시 구매·취소·반품·환불 발생 시 |
| 정기 동기화 | 약 60분 주기 |
기본 이벤트
Section titled “기본 이벤트”이벤트는 유저가 웹사이트에서 특정 행동을 했을 때 수집되는 데이터입니다. 콘솔의 [고객 데이터 연동] → [최근 이벤트] 에서 발생한 이벤트를 확인할 수 있습니다.
쇼핑몰 행동 이벤트
Section titled “쇼핑몰 행동 이벤트”쇼핑몰에서 주문·회원 관련 변화가 일어났을 때 발생합니다.
| 이벤트명 | 발생 시점 |
|---|---|
| sign_up | 쇼핑몰에 신규 회원이 가입한 경우 |
| login | 쇼핑몰 회원이 로그인한 경우 |
| add_to_cart | 쇼핑몰 상품이 장바구니에 담긴 경우 |
| purchase | 쇼핑몰에 주문이 접수된 경우 |
| cancel_purchase | 쇼핑몰에 접수된 주문의 상태가 취소·반품·환불로 변경된 경우 |
| change_shipping | 쇼핑몰 주문의 배송 상태가 변경된 경우 |
| change_grade | 쇼핑몰 회원 등급이 변경된 경우 |
| change_point | 쇼핑몰 회원의 적립금이 변동된 경우 |
각 이벤트에는 카페24에서 전달된 리소스(resource)가 이벤트의 데이터 필드에 매핑되어 함께 수집됩니다. 이 데이터는 세그먼트 조건이나 개인화 메시지 변수로 활용할 수 있습니다.
이벤트별 상세 리소스 구조는 카페24 웹훅 샘플 데이터 문서를 참고하세요.
화면 조회 이벤트
Section titled “화면 조회 이벤트”방문자가 쇼핑몰의 주요 화면을 조회할 때 발생합니다.
view_home
Section titled “view_home”메인 화면을 조회할 때 발생합니다.
view_product
Section titled “view_product”상품 상세 화면을 조회할 때 발생합니다.
| 데이터 | 설명 | 형식 | 예시 |
|---|---|---|---|
| product_no | 상품 번호 | Number | 1024 |
| product_name | 상품명 (최대 250자) | String | 콜드브루 원두 500g |
| price | 상품 판매가 | Number | 18000 |
| discounted_price | 할인 적용 가격 | Number | 15300 |
| category_no | 상품분류 번호 | Number | 108 |
| display_group | 진열 그룹 번호 | Number | 2 |
view_product_list
Section titled “view_product_list”상품 분류(목록) 화면을 조회할 때 발생합니다.
| 데이터 | 설명 | 형식 | 예시 |
|---|---|---|---|
| category_no | 상품분류 번호 | Number | 108 |
| category_name | 상품분류명 (최대 50자) | String | 커피 원두 |
view_cart
Section titled “view_cart”장바구니 화면을 조회할 때 발생합니다.
| 데이터 | 설명 | 형식 | 예시 |
|---|---|---|---|
| total_quantity | 총 수량 | Number | 3 |
| items_count | 품목 수 | Number | 2 |
| items_unique_count | 고유 상품 수 | Number | 2 |
| total_order_price | 총 주문 금액 | Number | 48600 |
| product_nos | 상품 번호 목록 (최대 100개) | List | [1024, 2087] |
| product_names | 상품명 목록 (최대 100개) | List | ["콜드브루 원두", "보온 텀블러"] |
| option_ids | 옵션 코드 목록 (최대 100개) | List | ["001A", "002C"] |
view_checkout
Section titled “view_checkout”주문서 작성 화면을 조회할 때 발생합니다.
| 데이터 | 설명 | 형식 | 예시 |
|---|---|---|---|
| product_no | 주문 상품 번호 목록 (최대 100개) | List | [1024, 2087] |
| price | 할인 전 금액 합계 | Number | 54000 |
| discounted_price | 할인 적용 금액 합계 | Number | 48600 |
view_completed_order
Section titled “view_completed_order”주문 완료 화면을 조회할 때 발생합니다.
| 데이터 | 설명 | 형식 | 예시 |
|---|---|---|---|
| order_id | 주문번호 | String | 20260312-0004517 |
| price | 주문 상품 금액 | Number | 48600 |
| discounted_price | 실제 결제 금액 | Number | 45600 |
| delivery_fee | 배송비 | Number | 3000 |
| is_coupon_used_order | 쿠폰 사용 여부 | Boolean | true |
| order_date | 주문일 (YYYYMMDD) | Number | 20260312 |