docs(gtm): add JHR GA4 tagging reference from event planning sheet

Comprehensive reference extracted from 'JHR - User Behaviour, Event
Planning & GA setup' Google Sheet covering:
- Tag naming convention (platform + trigger + purpose + event)
- 4 inherited settings variables with all parameters
- Property codes for 11 hotels
- Meta/Kakao pixel event mapping
- Custom channel grouping rules
- eCommerce product categories
- 173 event catalog organized by category

Source: Google Sheets ID 1rhzYApbZ4wbe1gE-E43E-mlRdLl_etkIOZnqs1g9X1U

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

custom-skills/61-gtm-manager/code/docs/jhr-ga4-tagging-reference.md

@@ -0,0 +1,298 @@
+# 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 |