statable-tag-template

## Overview Statable is a privacy‑first web analytics service that works without cookies or consent banners. This repository supplies an official Google Tag Manager (GTM) community template that simplifies adding Statable to any site. ## Features - **Initialization tag** – loads the Statable tracking script once per page. - **Custom Event tag** – sends pageview or custom events after the script is loaded. - No need to write Custom HTML tags; all configuration is done through the GTM UI. - Apache 2.0 licensed. ## Installation 1. Open your GTM workspace → **Tags → New → Tag Configuration**. 2. Click **Discover more tag types in the Community Template Gallery** and search for `Statable`. 3. Add the template. 4. Choose a tag type: - **Initialization** – set your *Site ID* (numeric ID from Statable’s tracking snippet) and trigger on **All Pages**. - **Custom Event** – specify an *Event Name* (e.g., `Signup`) and optional *Custom Props* (key/value pairs). Ensure the Initialization tag fires first. ## Usage Details - **Site ID**: Extract the number from the Statable script tag provided in your Statable dashboard, e.g. `https://statable.com/js/3093962/s.js` → `3093962`. - **Triggers**: Use the built‑in *Page View* trigger for initialization. For events, you can attach the tag to any GTM trigger that matches the user action you want to track. - **Custom Props**: Pass additional data with each event via the *Custom Props* field; these are sent as name/value pairs to Statable. ## Limitations - GTM’s sandbox cannot set custom attributes on the injected script tag, so advanced snippet attributes (`data-statable-*`, `data-before-send`, `data-tracking-api`) are not configurable through this template. Use a Custom HTML tag if you need those. - Hobby‑level Statable sites use a widget bundle that must be placed at a specific location in the page; GTM cannot guarantee that placement, so the template does not support hobby sites. ## Documentation & Support - Full installation guide: https://statable.com/docs/install/google-tag-manager/ - Issues and feature requests can be opened in the repository’s **Issues** section. ## License Apache License 2.0 – see the `LICENSE` file in the repository.