분석 이벤트
이 기능은 현재 개발 중이며, 아직 사용할 수 없습니다.
이벤트가 추가, 변경, 제거될 수 있습니다. 자세한 사항은 영업 담당자 또는 개발 담당자에게 문의하세요.
KOS Connect는 내원객의 예약 여정에서 주요 행동이 발생할 때 분석 이벤트를 자동으로 발행합니다.
병원의 Google Analytics(GA4) 또는 Google Tag Manager(GTM)와 연동하면, 별도 개발 없이 예약 퍼널 데이터를 병원의 GA 속성에서 확인할 수 있습니다.
이벤트 목록
예약 퍼널 이벤트
내원객의 예약 여정을 추적하는 핵심 이벤트입니다. GA4 ecommerce 표준 이벤트와 매핑됩니다.
| Connect 이벤트 | GA4 이벤트명 | 발행 시점 | 유형 |
|---|---|---|---|
procedureListViewed | view_item_list | 시술 목록에서 카테고리별 첫 상품 목록이 로드되었을 때. 같은 카테고리를 다시 조회하면 발행되지 않습니다. | ecommerce |
procedureViewed | view_item | 시술 상세 페이지가 로드 완료되었을 때. 상세 데이터 fetch 성공 시 1회 발행됩니다. | ecommerce |
cartItemAdded | add_to_cart | 내원객이 시술 옵션을 장바구니에 담았을 때. SDK addToCart 호출 또는 인앱→기본 브라우저 전환으로 장바구니가 URL을 통해 복원된 경우에도 발행됩니다. 새로고침 시 localStorage에서 복원되는 경우에는 발행되지 않습니다. | ecommerce |
cartItemRemoved | remove_from_cart | 내원객이 장바구니에서 시술 옵션을 제거했을 때. | ecommerce |
checkoutStarted | begin_checkout | 예약 흐름에 진입했을 때. 장바구니에서 "예약하기"를 눌러 예약 단계로 넘어가는 시점에 1회 발행됩니다. 이미 완료된 예약을 조회하는 경우에는 발행되지 않습니다. | ecommerce |
reservationCompleted | purchase | 예약 API 호출이 성공하여 예약이 확정되었을 때. | ecommerce |
reservationCancelled | refund | 예약 취소 API 호출이 성공하여 예약이 취소되었을 때. | ecommerce |
기타 이벤트
| Connect 이벤트 | GA4 이벤트명 | 발행 시점 |
|---|---|---|
cartReset | cart_reset | 장바구니를 초기화할 때. 장바구니에 시술 옵션이 1개 이상 있을 때만 발행됩니다. |
registerStarted | register_started | 미등록 내원객이 예약 정보 입력 화면에 진입했을 때. |
registerCompleted | register_completed | 내원객 등록 API 호출이 성공했을 때. |
dateTimeSelected | date_time_selected | 예약 일시를 선택하고 확인 단계로 넘어갈 때. 일시를 변경할 때마다 발행되는 것이 아니라, "다음" 버튼을 눌러 확인 단계(confirmation)로 진행하는 시점에 1회 발행됩니다. |
widgetPageView | widget_page_view | 위젯 모드에서 라우트 경로가 변경되었을 때. 같은 경로로의 중복 전환은 무시됩니다. 페이지 모드에서는 발행되지 않습니다. |
예약 퍼널 흐름
내원객의 일반적인 예약 여정과 발행되는 이벤트입니다.
시술 목록 조회 → procedureListViewed (view_item_list)
↓
시술 상세 조회 → procedureViewed (view_item)
↓
장바구니 담기 → cartItemAdded (add_to_cart)
↓
예약 흐름 진입 → checkoutStarted (begin_checkout)
↓
일시 선택 → 확인 단계로 이동 → dateTimeSelected (date_time_selected)
↓
내원객 등록 (미등록 내원객인 경우) → registerStarted → registerCompleted
↓
예약 확정 → reservationCompleted (purchase)
GA4 이벤트 파라미터
Ecommerce 이벤트 공통 파라미터
ecommerce 이벤트에는 GA4 표준 ecommerce 파라미터가 포함됩니다.
Item 파라미터
| 파라미터 | 설명 | 예시 |
|---|---|---|
item_id | 시술 옵션 ID | "option_123" |
item_name | 시술 옵션명 | "보톡스 50유닛" |
item_brand | 시술 상품명 | "보톡스" |
item_category | 첫 번째 카테고리 | "피부과" |
item_category2 | 두 번째 카테고리 (있는 경우) | "주사 시술" |
item_variant | 시술 상품명 | "보톡스" |
price | 가격 | 50000 |
currency | 통화 | "KRW" |
quantity | 수량 (항상 1) | 1 |
거래 파라미터 (reservationCompleted, reservationCancelled)
| 파라미터 | 설명 |
|---|---|
transaction_id | 예약 ID |
value | 총 금액 |
currency | 통화 |
items | 시술 옵션 목록 |
사용자 속성 (User Properties)
KOS Connect는 다음 사용자 속성을 GA에 설정합니다.
| 속성 | 설명 | 값 |
|---|---|---|
connect_mode | 위젯/페이지 모드 | "widget" 또는 "page" |
visitor_id | 내원객 ID (로그인 시) | "visitor_abc123" |
auth_token_type | 인증 방식 | "line", "phone" 등 |
공통 속성
모든 이벤트에 platform_source: "kos_connect" 속성이 포함되어, 병원 자체 이벤트와 KOS Connect 이벤트를 구분할 수 있습니다.
병원 GA/GTM 연동
병원의 GA 속성에서 KOS Connect 이벤트를 수집하려면, 아래 정보를 KOS 담당자에게 전달하세요.
연동 방식
두 가지 방식 중 하나를 선택합니다.
| 방식 | 전달할 값 | 형식 | 설명 |
|---|---|---|---|
| GTM (권장) | GTM Container ID | GTM-XXXXXXX | GTM을 통해 이벤트를 수집합니다. 이벤트 필터링, 변환 등 유연한 설정이 가능합니다. |
| GA4 직접 연동 | GA Measurement ID | G-XXXXXXXXXX | GA4에 직접 이벤트를 전송합니다. 간단하지만 GTM보다 유연성이 낮습니다. |
- 위젯 모드: 병원 홈페이지의
window.dataLayer또는window.gtag를 통해 이벤트가 전송됩니다. 병원 홈페이지에 이미 GTM/GA가 설정되어 있다면 자동으로 수집됩니다. - 페이지 모드: KOS Connect가 병원의 GTM/GA 스크립트를 직접 로드하여 이벤트를 전송합니다.
이벤트별 설정
이벤트별로 비활성화하거나, GA4 이벤트명을 커스터마이즈할 수 있습니다. 필요한 경우 KOS 담당자에게 요청하세요.
- 이벤트 비활성화: 특정 이벤트를 병원 GA에 전송하지 않도록 설정
- 이벤트명 변경: GA4 이벤트명을 병원의 기존 네이밍 컨벤션에 맞게 변경 (예:
purchase→kos_reservation_completed)
GTM 설정 가이드
GTM을 사용하는 병원에서 KOS Connect ecommerce 이벤트를 수집하려면 다음 설정이 필요합니다.
1. 트리거 생성
ecommerce 이벤트를 수신할 커스텀 이벤트 트리거를 생성합니다.
| 트리거 이름 | 이벤트 이름 |
|---|---|
| KOS Connect - view_item_list | view_item_list |
| KOS Connect - view_item | view_item |
| KOS Connect - add_to_cart | add_to_cart |
| KOS Connect - remove_from_cart | remove_from_cart |
| KOS Connect - begin_checkout | begin_checkout |
| KOS Connect - purchase | purchase |
| KOS Connect - refund | refund |
2. GA4 이벤트 태그 생성
각 트리거에 대해 GA4 이벤트 태그를 생성하고, ecommerce 이벤트의 경우 "Ecommerce 데이터 전송" 옵션을 활성화합니다.
3. platform_source 필터링 (선택)
KOS Connect 이벤트만 별도로 필터링하려면, platform_source 변수를 Data Layer Variable로 등록하고 kos_connect 값으로 필터링할 수 있습니다.