diff --git a/custom-skills/60-gtm-audit/code/docs/jhr-ga4-tagging-reference.md b/custom-skills/60-gtm-audit/code/docs/jhr-ga4-tagging-reference.md new file mode 100644 index 0000000..f8d3728 --- /dev/null +++ b/custom-skills/60-gtm-audit/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 | diff --git a/custom-skills/61-gtm-manager/code/docs/jhr-ga4-tagging-reference.md b/custom-skills/61-gtm-manager/code/docs/jhr-ga4-tagging-reference.md new file mode 100644 index 0000000..f8d3728 --- /dev/null +++ b/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 | diff --git a/custom-skills/62-gtm-guardian/code/references/jhr-ga4-tagging-reference.md b/custom-skills/62-gtm-guardian/code/references/jhr-ga4-tagging-reference.md new file mode 100644 index 0000000..f8d3728 --- /dev/null +++ b/custom-skills/62-gtm-guardian/code/references/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 |