analytics-tracking-automation

analytics-tracking-automation is an AI-agent skill for planning, implementing, and deploying Google Analytics 4 (GA4) plus Google Tag Manager (GTM) event tracking. It addresses the tedious, error-prone work of standing up analytics on a website by automating the full pipeline: crawling and classifying pages, grouping them by business intent, designing GA4 event schemas, syncing tags/triggers/variables into a GTM container, verifying event firing in preview, and publishing the container version. It supports both generic websites and Shopify storefronts with cart/checkout/purchase tracking.

The workflow is driven by an event-tracking CLI (installed via npm or npx). Commands include init (start a new setup), resume (continue from a checkpoint), audit (compare live GTM config against a recommended plan), sync (push schema to GTM), verify (Playwright-based browser checks against GTM preview mode), and publish (release a container version). Each run writes reviewable, editable artifact files (site analysis, page groups, event schema, sync results, verification report, checkpoint) so work is resumable and inspectable. GTM synchronization uses the Google Tag Manager API and requires Google OAuth, which is set up through official Google Cloud credentials and cached locally in the artifact directory.

It targets analytics engineers, marketers, growth teams, and agencies who need to deploy or audit GA4/GTM tracking quickly and repeatably, especially for e-commerce and Shopify stores. Prerequisites are Node.js 18+, Playwright Chromium (auto-installed), and Google OAuth credentials created in Google Cloud Console.