프로젝트 소개

## 개요 Statable은 쿠키나 동의 배너 없이 작동하는 프라이버시 중심 웹 분석 서비스입니다. 이 저장소는 Statable을 어떤 사이트든 쉽게 추가할 수 있는 공식 Google Tag Manager(GTM) 커뮤니티 템플릿을 제공합니다. ## 특징 - **Initialization(초기화) 태그** – 페이지당 한 번 Statable 추적 스크립트를 로드합니다. - **Custom Event(사용자 정의 이벤트) 태그** – 스크립트가 로드된 후 페이지뷰나 사용자 정의 이벤트를 전송합니다. - Custom HTML 태그를 작성할 필요가 없으며, 모든 설정은 GTM UI를 통해 이루어집니다. - Apache 2.0 라이선스. ## 설치 방법 1. GTM 워크스페이스를 엽니다 → **Tags → New → Tag Configuration**. 2. **Discover more tag types in the Community Template Gallery**을 클릭하고 `Statable`로 검색합니다. 3. 템플릿을 추가합니다. 4. 다음 태그 유형 중 선택: - **Initialization** – *Site ID*(Statable 추적 스크립트의 숫자 ID)를 설정하고 **All Pages** 트리거에 적용합니다. - **Custom Event** – *Event Name*(예: `Signup`) 및 선택사항인 *Custom Props*(key/value 쌍)를 지정합니다. Initialization 태그가 먼저 실행되도록 보장합니다. ## 사용 상세 - **Site ID**: Statable 대시보드에서 제공하는 스크립트 태그에서 숫자를 추출합니다. 예: `https://statable.com/js/3093962/s.js` → `3093962`. - **트리거**: 초기화에는 기본 제공 *Page View* 트리거를 사용하세요. 이벤트의 경우 추적하려는 사용자 동작과 일치하는 모든 GTM 트리거에 태그를 연결할 수 있습니다. - **Custom Props**: *Custom Props* 필드를 통해 각 이벤트에 추가 데이터를 전송할 수 있으며, 이는 이름/값 쌍 형태로 Statable에 전달됩니다. ## 제한사항 - GTM 샌드박스는 주입된 스크립트 태그에 사용자 정의 속성을 설정할 수 없으므로, 고급 스크립트 속성(`data-statable-*`, `data-before-send`, `data-tracking-api`)은 이 템플릿으로 구성할 수 없습니다. 해당 기능이 필요하면 Custom HTML 태그를 사용하세요. - Hobby 레벨 Statable 사이트는 특정 위치의 페이지에 위젯 번들을 배치해야 하므로, GTM은 해당 배치를 보장할 수 없습니다. 따라서 템플릿은 Hobby 사이트를 지원하지 않습니다. ## 문서 및 지원 - 전체 설치 가이드: https://statable.com/docs/install/google-tag-manager/ - 이슈 및 기능 요청은 저장소의 **Issues** 섹션에서 제출할 수 있습니다. ## 라이선스 Apache License 2.0 – 저장소의 `LICENSE` 파일을 참조하세요.