gtm-telemetry-wizard
Declarative GTM Container IaC Compiler, Playwright E2E Live Verifier, and GA4 Telemetry Ingestion Setup Wizard.
gtm-telemetry-wizard is a standalone CLI tool and Python library for automating Google Tag Manager (GTM) container setups, compiling declarative IaC specs, verifying live webpage telemetry with Playwright, and warming up GA4 measurement streams to achieve Container Quality: Excellent.
Features
- 5-Phase Setup Wizard: Diagnostic check, container spec compilation, live Playwright verification, GA4 ingest warm-up, and container quality reporting.
- GA4 Ingest Warm-Up: Delivers initial telemetry pings directly to GA4 (
/g/collect), automatically clearing 48-hour missing traffic quality alerts. - Playwright E2E Verification: Headless/Headful browser verification inspecting
gtm.jssnippet loading,dataLayerevents, and UTM parameters. - Dual Deployment Options: Automated browser import (via Playwright CDP persistent Chrome profile) or GTM REST API v2 deployment.
- Borderless Terminal UI: Clean Rich-powered terminal interface.
Installation
pip install gtm-telemetry-wizard
Or install from source:
git clone https://github.com/bizkite-co/gtm-telemetry-wizard.git
cd gtm-telemetry-wizard
pip install -e .
Quick Start
1. Guided Setup Wizard
Run the 5-phase setup wizard for any website and container ID:
telemetry-wizard wizard --domain example.com --container-id GTM-XXXXXXX --ga4-id G-YYYYYYYY
2. Using telemetry.toml Configuration File
Create a telemetry.toml in your project directory:
[site]
domain = "example.com"
container_id = "GTM-53F6J2WX"
ga4_measurement_id = "G-HJJ9TK2TKY"
[deployment]
mode = "browser"
headful = true
Then run:
telemetry-wizard wizard --config telemetry.toml
Python API Usage
from gtm_telemetry_wizard import TelemetryConfig, TelemetryProvider
# Initialize provider
config = TelemetryConfig(domain="example.com", container_id="GTM-XXXXXXX")
provider = TelemetryProvider(config)
# Run live telemetry verification
results = provider.verify_live_telemetry()
print("GTM Loaded:", results["gtm_script_loaded"])
# Send initial GA4 warm-up ping
ping_res = provider.ping_ga4_measurement_id("G-YYYYYYYY")
print("Ping Status:", ping_res["status"])
CLI Reference
telemetry-wizard wizard- Guided 5-phase telemetry setup wizard.telemetry-wizard sync- Compile GTM container IaC spec.telemetry-wizard verify- Run Playwright E2E live URL verification.telemetry-wizard ping- Deliver initial GA4 warm-up measurement hit.
License
MIT License © 2026 Bizkite Co.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file gtm_telemetry_wizard-0.1.0.tar.gz.
File metadata
- Download URL: gtm_telemetry_wizard-0.1.0.tar.gz
- Upload date:
- Size: 9.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1e30416c1c9db43d24a41c7ba530243f1dcbc76185ec8e574542fe375c8b2a88
|
|
| MD5 |
6032109ec0d12afef95d569f7d1650e5
|
|
| BLAKE2b-256 |
69f4c565d52fea6eb656e52f39452ad9490f162bfdfaf711f3640f1df87754d3
|
Provenance
The following attestation bundles were made for gtm_telemetry_wizard-0.1.0.tar.gz:
Publisher:
publish.yml on bizkite-co/gtm-telemetry-wizard
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
gtm_telemetry_wizard-0.1.0.tar.gz -
Subject digest:
1e30416c1c9db43d24a41c7ba530243f1dcbc76185ec8e574542fe375c8b2a88 - Sigstore transparency entry: 2773768011
- Sigstore integration time:
-
Permalink:
bizkite-co/gtm-telemetry-wizard@53f958ba8b5110b7d4268301112040f2b58d0a6a -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/bizkite-co
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@53f958ba8b5110b7d4268301112040f2b58d0a6a -
Trigger Event:
push
-
Statement type:
File details
Details for the file gtm_telemetry_wizard-0.1.0-py3-none-any.whl.
File metadata
- Download URL: gtm_telemetry_wizard-0.1.0-py3-none-any.whl
- Upload date:
- Size: 10.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cb12a68e36e1120ad15ff0dd3913fd05ec3a7109f2c20c7f2a2986c227e0e616
|
|
| MD5 |
5f83f971d27aac2da557cded11a3b2c5
|
|
| BLAKE2b-256 |
659ea3d784800043cb551a810c1365587ab1351d69518fd912e3a36255dce1b4
|
Provenance
The following attestation bundles were made for gtm_telemetry_wizard-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on bizkite-co/gtm-telemetry-wizard
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
gtm_telemetry_wizard-0.1.0-py3-none-any.whl -
Subject digest:
cb12a68e36e1120ad15ff0dd3913fd05ec3a7109f2c20c7f2a2986c227e0e616 - Sigstore transparency entry: 2773768064
- Sigstore integration time:
-
Permalink:
bizkite-co/gtm-telemetry-wizard@53f958ba8b5110b7d4268301112040f2b58d0a6a -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/bizkite-co
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@53f958ba8b5110b7d4268301112040f2b58d0a6a -
Trigger Event:
push
-
Statement type:
