게스트 게이트 테마 컴포넌트

Guest Gate v2.0에 GTM(Google Tag Manager) 지원 및 유연한 커스텀 이벤트 로깅을 갖춘 분석 추적 시스템을 구현했습니다.

추가된 설정

  • enable_analytics (기본값: 비활성화): 요청에 따라 전체 추적 기능을 켜거나 끕니다.

  • analytics_debug_logging: 활성화 시 모든 추적 이벤트를 브라우저 콘솔에 직접 기록합니다. GTM 트리거를 구성하는 설정 단계에서 특히 유용합니다.

핵심 기능

전용 헬퍼 모듈(guest-gate-analytics.js)이 이벤트 디스패치를 처리합니다. 모든 추적 이벤트는 동시에 두 가지 위치로 전송됩니다:

  1. window.dataLayer.push(...): 사이트에 GTM 및 Google Analytics 4(GA4)가 활성화되어 있다면 자동으로 수집됩니다.

  2. discourse-guest-gate:analytics (커스텀 브라우저 이벤트): 추가적인 코드 수정 없이 Matomo, Plausible 또는 커스텀 웹훅과 같은 제3자 도구와 통합할 수 있습니다.

추적되는 이벤트

  • guest_gate_shown (모달이 표시될 때 발생)

    • guest_gate_reason: 트리거 유형 (page_view, time, scroll, 또는 lightbox).

    • guest_gate_path: 모달이 표시된 URL 경로.

  • guest_gate_click (방문자가 모달과 상호작용할 때 발생)

    • guest_gate_click_action: 수행된 특정 동작 (login, signup, sso_login, sso_signup, Google 로그인 버튼과 같은 external_<provider>, 또는 아무런 동작 없이 닫은 경우의 dismiss).

    • 표시 트리거와 상호작용을 쉽게 연관시킬 수 있도록 동일한 reasonpath 메타데이터를 포함합니다.

개인정보 보호 및 데이터 보호

  • 개인 식별 정보(PII)는 수집하거나 전송하지 않으며, 위에 나열된 최소한의 운영 메타데이터만 수집합니다.

곧 출시 예정…:rocket:

> ./support --coffee

3개의 좋아요