본문으로 건너뛰기

Analytics

사이트별 애널리틱스 스크립트 — Google Analytics 4 + Naver Analytics + Custom Script (head/body-end)

상태​

항목값
Layercomposite
TierL1
Statusreleased
Version1.0.0
가격Free (free)
**카�
�고리**Monetization

개요​

개요​

Analytics 는 multi-saas-kit 의 L1 애널리틱스 통합 Plugin � 니다.

Google Analytics 4, Naver Analytics 두 공급자를 내장 지원하고, Custom <head> / <body-end> 스크립트 슬롯으로 Microsoft Clarity, Hotjar, Mixpanel, Plausible 등 임의 공급자를 자유롭게 추가할 수 있습니다.

기능​

내장 공급자 (v1)​

  • Google Analytics 4 — G-XXXXXXXXXX measurement ID
  • Naver Analytics — wcs_do ID

Custom Script 슬롯​

  • <head> 슬롯 — 페이지 로드 즉시 실행 (Hotjar, Clarity, etc.)
  • <body-end> 슬롯 — 본문 후 실행 (Plausible, custom event handlers)

페이지 정�​

(PageGuard 선택)

  • 기본 — Public 페이지만 (Filament 패널 / 인증 / 결제 / 약관 / 에러 자동 제외)
  • 토글 — Site/Tenant 단위 track_admin: true 로 전체 수집 가능

Site / Tenant 단위 (ADR-024 + ADR-027 정합)​

1순위: Tenant.settings.analytics    (Custom Domain 보유 Tenant 만)
2순위: SaasProduct.settings.analytics  (Site 기본)
3순위: 비활성 (스크립트 미삽�
)

사용법​

{{-- layout 의 <head> 안에 1회 --}}
<x-analytics::head />

{{-- </body> 직전 1회 --}}
<x-analytics::body-end />

분리선 (ADR-039)​

Plugin � 임: 공급자 스크립트 init 만 (페이지뷰 자동 추적은 provider 기본 동작).

SaaS � 임: 전환 이벤트 (gtag('event','purchase',...), wcs.event(...) 등). 어느 페이지에서 어떤 이벤트를 발화할지는 비즈니스 로직.

의존성​

  • core: >=1.18.0

관련 ADR​

  • ADR-044 Analytics Plugin (Implemented)
  • ADR-024 SaaS Module Standard
  • ADR-027 Custom Domain (Tenant override 트리거)
  • ADR-039 Plugin Scope Principle
  • ADR-042 GDPR Consent (예정 — Analytics + Ads 통합 동의)

라이선스​

MIT

데모​

🛒 Plugin Store에서 보기: store.codebase.how/plugins/analytics