카페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 회원 아이디와 동일하게 부여됩니다. 유저는 회원이 로그인하는 시점 또는 약 5분 주기의 정기 동기화 시점에 생성·갱신됩니다.
방문자가 웹사이트에서 알림 수신을 허용하면 기기(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 |
정기 동기화(약 5분 주기)
Section titled “정기 동기화(약 5분 주기)”유저 정보는 약 5분 주기로 갱신됩니다. 생년월일(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) |
쿠폰 정보는 다음 두 가지 방식으로 연동됩니다.
| 연동 방식 | 연동 시점 |
|---|---|
| 실시간 | 첫 페이지 접속 시 구매·취소·반품·환불 발생 시 |
| 정기 동기화 | 약 5분 주기 |
이벤트는 유저가 웹사이트에서 특정 행동을 했을 때 수집되는 데이터입니다. 콘솔의 [고객 데이터 연동] → [최근 이벤트] 에서 발생한 이벤트를 확인할 수 있습니다.
| 이벤트명 | 발생 시점 |
|---|---|
| sign_up | 쇼핑몰에 신규 회원이 가입한 경우 |
| login | 쇼핑몰 회원이 로그인한 경우 |
| add_to_cart | 쇼핑몰 상품이 장바구니에 담긴 경우 |
| purchase | 쇼핑몰에 주문이 접수된 경우 |
| cancel_purchase | 쇼핑몰에 접수된 주문의 상태가 취소·반품·환불로 변경된 경우 |
| change_shipping | 쇼핑몰 주문의 배송 상태가 변경된 경우 |
| change_grade | 쇼핑몰 회원 등급이 변경된 경우 |
| change_point | 쇼핑몰 회원의 적립금이 변동된 경우 |
각 이벤트에는 카페24에서 전달된 리소스(resource)가 이벤트의 데이터 필드에 매핑되어 함께 수집됩니다. 이 데이터는 세그먼트 조건이나 개인화 메시지 변수로 활용할 수 있습니다.
이벤트별 상세 리소스 구조는 카페24 웹훅 샘플 데이터 문서를 참고하세요.