# JHR GA4 Tagging Reference

Source: [JHR - User Behaviour, Event Planning & GA setup](https://docs.google.com/spreadsheets/d/1rhzYApbZ4wbe1gE-E43E-mlRdLl_etkIOZnqs1g9X1U)

Container: GTM-NP6NJMP (JHR Website - 통합)

---

## 1. Tag Naming Convention

Format: `{Platform} {TriggerElement} - {Purpose} - {EventName}`

### Platform Categories

| Platform | Usage |
|----------|-------|
| GA4 | Google Analytics 4 events |
| Google Ads | Conversion tracking |
| Meta | Facebook/Instagram pixel |
| Kakao | Kakao pixel/moment |
| Marketing | Cross-platform marketing tags |
| Analytics | Analytics configuration tags |
| Site | Site-specific utility tags |
| SEO | SEO-related tags |
| Test | Testing/debug tags |
| {{Campaign Name}} | Campaign-specific tags (e.g., "LandersFesta") |

### Trigger Elements (what triggers the tag)

| Element | Description |
|---------|-------------|
| pageview | Page load / virtual pageview |
| click | Generic click |
| link | Link click |
| button | Button click |
| tab | Tab selection |
| form | Form submission |
| layer | Layer/modal/popup view |
| popup | Popup interaction |
| banner | Banner click/impression |
| dropdown | Dropdown selection |
| radio | Radio button selection |
| checkbox | Checkbox toggle |
| ajax | AJAX request complete |
| dataLayer | DataLayer push event |

### Tag Purposes (page/feature area)

| Purpose | Area |
|---------|------|
| booking | Room/package reservation process |
| dining | Dining reservation process |
| membership | Club Josun membership |
| package | Package/event listing & detail |
| theme | Theme package pages |
| campaign | Campaign/promotion pages |
| event | Event pages |
| timesale | Time-limited sale pages |
| survey | Survey/feedback |
| ecommerce | E-commerce tracking |
| SEO | SEO schema/config |
| site | Site-wide interactions |
| config | Configuration/settings |
| ux | UX tracking |
| test | Testing |

### Examples

```
GA4 pageview - booking - room_booking_step1
GA4 button - theme - theme_pkg_detail
GA4 click - campaign - kakao_channel_add
Kakao banner - timesale - {{Event Name}}
Meta form - event - {{Event Name}}
Marketing - meta pixel - join_complete
Marketing - Kakao Pixel - package detail
```

---

## 2. Inherited Settings Variables

Tags inherit common parameters through shared settings variables.
This avoids duplicating parameters across hundreds of tags.

### GA4 Configuration Setting (shared across ALL GA4 tags)

| Parameter | Variable | Description |
|-----------|----------|-------------|
| login_status | {{cjs - login status Variable}} | Login state |
| user_lang | locale={{cjs - page language Variable}} | Page language |
| contents_group_hotel | {{Contents Group 1 - Hotel Site}} | Hotel brand grouping |
| contents_group_menu | {{Contents Group new - Menu Categories}} | Page section grouping |
| naver_query | {{URL referrer - naver query}} | Naver search query |
| naver_oquery | {{URL referrer - naver oquery}} | Naver original query |

### GA4 Event Settings (added to event tags)

| Parameter | Variable |
|-----------|----------|
| page_path | {{Page Path}} |
| login_status | {{cjs - login status Variable}} |
| user_lang | {{cjs - page language Variable}} |

### GA4 eCommerce Settings (added to ecommerce tags)

| Parameter | Variable |
|-----------|----------|
| pkg_name | {{dlv - eCommerce - item_name}} |
| pkg_hotel | {{dlv - eCommerce - item_brand}} |
| pkg_price | {{dlv - eCommerce - price}} |
| pkg_room_type | {{dlv - eCommerce - item_variant}} |
| pkg_id | {{dlv - eCommerce - item_id}} |
| page_path | {{Page Path}} |

### GA4 Promotion Settings (added to package/event detail tags)

| Parameter | Variable |
|-----------|----------|
| page_path | {{Page Path}} |
| login_status | {{cjs - login status Variable}} |
| user_lang | {{cjs - page language Variable}} |
| packageSn | {{URL query - packageSn Variable}} |
| themeSn | {{URL query - themeSn Variable}} |
| eventSn | {{URL query - eventSn Variable}} |

---

## 3. Standard Parameter Keys

| Parameter Name | Allowed Values / Variable |
|----------------|--------------------------|
| event_type | click |
| ui | GNB, modal, button, tab, link, banner, footer |
| page_path | {{Page Path}} |
| login_status | (from cjs variable) |
| user_lang | (from cjs variable) |
| pkg_name | (package/event title) |
| click_text | (clicked element text) |
| click_url | (clicked element URL) |

---

## 4. Property Codes

| # | Hotel Name | URL | Website Code | Report Code |
|---|-----------|-----|-------------|-------------|
| 1 | 조선 팰리스 | jpg.josunhotel.com | JPY | JPG |
| 2 | 웨스틴 조선 서울 | josunhotel.com/hotel/westinSeoul.do | TWC | WJS |
| 3 | 웨스틴 조선 부산 | josunhotel.com/hotel/westinBusan.do | TWCB | WJB |
| 4 | 그랜드 조선 부산 | gjb.josunhotel.com | GJB | GJB |
| 5 | 그랜드 조선 제주 | gjj.josunhotel.com | GJJ | GJJ |
| 6 | 레스케이프 호텔 | les.josunhotel.com | LESCAPE | LES |
| 7 | 그래비티 조선 서울 판교 | grp.josunhotel.com | GRP | GVP |
| 8 | 포포인츠 서울역 | josunhotel.com/hotel/fpbsSeoul.do | FPBSS | FPS |
| 9 | 포포인츠 서울 명동 | josunhotel.com/hotel/fpbsMyeongdong.do | FPBSM | FPM |
| - | 전사 공통 | josunhotel.com | JOSUN HOTEL | JHR |
| 10 | 파라스파라 | paraspara.co.kr | - | - |
| 11 | 코랄로 바이 조선 | coralloyangyang.com | CBJ | YYH |

---

## 5. Meta / Kakao Pixel Event Mapping

### Meta (Facebook) Pixel

| User Action | Event Name | Pixel Code | GTM Tag Name |
|-------------|-----------|------------|--------------|
| 회원가입 완료 | 등록완료 | CompleteRegistration | Marketing - meta pixel - join_complete |
| 이벤트 자세히 보기 | 콘텐츠 조회 | ViewContent | Marketing - meta Pixel - package detail |
| 관심상품 담기 | 위시리스트에 추가 | AddToWishlist | Marketing - meta Pixel - bookmark |
| 룸/패키지 예약 클릭 | 예약 | Schedule | Marketing - mata Pixel - bookmark |
| 잠재고객 | 잠재고객 | Lead | (not configured) |

### Kakao Pixel

| User Action | Event Name | Event Code | GTM Tag Name |
|-------------|-----------|------------|--------------|
| 회원가입 완료 | 회원가입 | CompleteRegistration | Marketing - Kakao Pixel - join member complete |
| 이벤트 자세히 보기 | 콘텐츠/상품 조회 | ViewContent | Marketing - Kakao Pixel - package detail |
| 관심상품 담기 | 관심상품추가 | AddToWishList | Marketing - Kakao Pixel - bookmark |
| 룸/패키지 예약 클릭 | 구매 | Purchase | Marketing - Kakao Pixel - click booking |
| 잠재고객 (멤버십) | 잠재고객 | Participation - Consulting | Marketing - Kakao Pixel - button - membership_detail_view |
| 잠재고객 (매스프로모션) | 잠재고객 | Participation - PreBooking | Marketing - Kakao pixel - button - massPromotion_detail |

---

## 6. Custom Channel Grouping (JHR)

| Order | Channel | Custom Rules |
|-------|---------|-------------|
| 1 | Direct | (default) |
| 2 | Cross-network | (default) |
| 3 | Paid Shopping | (default) |
| 4 | Paid Search | (default) |
| 5 | Paid Social | + kakao / sms |
| 6 | Paid Video | (default) |
| 7 | Paid Other | (default) |
| 8 | Display | (default) |
| 9 | Map Search | place.map.kakao.com, m.place.naver.com, pcmap.place.naver.com, map.kakao.com |
| 10 | Organic Shopping | (default) |
| 11 | Organic Social | (default) |
| 12 | Organic Video | (default) |
| 13 | Organic Search | (default) |
| 14 | Email | (default) |
| 15 | Affiliates | + event.ssg.com, marriott.com, blossom.shinsegae.com |
| 16 | Referral | (default) |
| 17-19 | Audio / SMS / Mobile Push | (default) |
| - | Unassigned | hotelQR / QRcoupon |

---

## 7. eCommerce Product Categories

| Category | Description |
|----------|-------------|
| ROOM ONLY | 객실 상품만 제공 |
| 멤버십 전용 | CJM 회원 전용 상품 |
| 선결제 | 선결제 상품 (현재 미등록) |
| 얼리버드 | 조기 예약 상품 |
| 조식 | 조식 포함 패키지 |
| 패키지 | 프로모션 오퍼 포함 패키지 |

---

## 8. Event Catalog (173 events)

### Booking Process Events
| Event Name | Description |
|------------|-------------|
| room_search | Room search initiated |
| room_search_home | Room search from homepage |
| room_tab_room_only | Room only tab selected |
| room_tab_package | Package tab selected |
| room_tab_members_only | Members only tab selected |
| room_booking_step4 | Booking step 4 (confirmation) |
| room_booking_promo | Promo code applied |
| book_room | Room booking completed |
| begin_checkout | Checkout started |
| purchase | Purchase completed |
| refund | Refund processed |

### Dining Events
| Event Name | Description |
|------------|-------------|
| dining_booking_start | Dining booking initiated |
| dining_hotel_select | Hotel selected for dining |
| dining_restaurant_select | Restaurant selected |
| dining_step0_view ~ dining_step4_view | Dining booking steps |
| dining_book | Dining reservation completed |
| dining_menu_view_click | Menu viewed |
| dining_search_home | Dining search from home |

### Package & Event Events
| Event Name | Description |
|------------|-------------|
| package_list_view | Package listing viewed |
| event_list_view | Event listing viewed |
| event_see_detail | Event detail clicked |
| theme_pkg_detail | Theme package detail clicked |
| pageview_theme_pkg | Theme package page viewed |
| bookmark_promotion | Package/event bookmarked |
| event_share | Event shared (Kakao/email/SMS/URL) |
| massPromotion_detail | Mass promotion detail viewed |

### Membership Events
| Event Name | Description |
|------------|-------------|
| memberED2_list_view | Membership list viewed |
| memberED2_join | Membership join started |
| memberED2_detail_{TIER} | Tier detail viewed (BLACK/GOLD/PLATINUM/PREMIER/GRANDJOSUN) |
| memberED2_detail_share | Membership shared |
| memberED2_inquiry | Membership inquiry |

### Navigation & Site Events
| Event Name | Description |
|------------|-------------|
| GNB_all_menu | All menu opened |
| GNB_sub_menu_click | Sub menu clicked |
| main_select_hotel | Hotel selected from main |
| main_room_booking | Room booking from main |
| main_dining_booking | Dining booking from main |
| hotel_layer_view | Hotel info layer viewed |
| login_click | Login clicked |
| join_click | Join clicked |
| lang_change | Language changed |

### E-commerce Events (GA4 Standard)
| Event Name | Description |
|------------|-------------|
| view_item_list | Item list viewed |
| view_item | Item detail viewed |
| add_to_cart | Added to cart |
| add_to_wishlist | Added to wishlist |
| remove_from_wishlist | Removed from wishlist |
| begin_checkout | Checkout started |
| purchase | Purchase completed |
| refund | Refund |
