Marketing Analytics Auditor

Free, open-source GA4 + GTM + pixel auditor with auto-generated remediation code.

Scan any URL for marketing tags, run a 40-point GA4 property audit, validate pixel and CAPI configurations, and get the exact copy-paste code to fix every issue found. The tool that does what agencies charge $10K for — then goes one step further.

Live at: googleadsagent.ai/tools/auditor

---

What makes this different

Every analytics audit tool tells you what's wrong. This one generates the code to fix it.

Feature	Other Tools	This Tool
GA4 property audit	Some (Sheets-based)	✅ 40-point Admin API checklist
GTM container audit	Enterprise only ($$$)	✅ Free, open source
Pixel detection	Tag scanners exist	✅ 10 platforms + consent detection
CAPI validation	Platform-specific only	✅ Cross-platform in one tool
Remediation code	❌ Nobody does this	✅ Copy-paste dataLayer, GTM JSON, CAPI boilerplate
AI page vision	❌ Nobody does this	✅ AI suggests events from screenshots

---

Quick start

Zero-auth page scan (no setup needed)

1. Go to googleadsagent.ai/tools/auditor/app.html
2. Enter any URL or paste HTML source
3. Get instant tag inventory, health score, and remediation code

Run locally

git clone https://github.com/itallstartedwithaidea/analytics-auditor.git
cd analytics-auditor
# Open app.html in your browser — that's it
open app.html

No build step. No npm install. No dependencies. It's a single HTML file.

---

Features

Phase 1: Page Scanner + Tag Detection ✅ Live

Detects 10 marketing platforms by analyzing DOM script tags, JavaScript global objects, network request patterns, and cookie signatures:

Platform	Detection	Validation	Remediation
Google Analytics 4	✅	Enhanced Measurement, dataLayer events, ecommerce	✅
Google Tag Manager	✅	dataLayer init, noscript fallback	✅
Meta Pixel	✅	PageView, Advanced Matching, standard events, CAPI	✅
Google Ads	✅	Conversion tracking, Enhanced Conversions	✅
TikTok Pixel	✅	Standard events (AddToCart, Purchase)	✅
LinkedIn Insight	✅	Presence	✅
Pinterest Tag	✅	Presence	Planned
Snapchat Pixel	✅	Presence	Planned
X / Twitter Pixel	✅	Presence	Planned
Microsoft UET	✅	Presence	Planned

Plus: Google Consent Mode v2, IAB TCF 2.0, and cookie consent banner detection.

Phase 2: GA4 Property Audit ✅ Live

40-point checklist via Google Analytics Admin API:

• Property Configuration (10 checks): Timezone, currency, data retention, Google Signals, attribution model, data filters, change history
• Data Streams (6 checks): Web stream active, measurement ID valid, enhanced measurement
• Enhanced Measurement (5 checks): Site search, video, file downloads, forms
• Key Events (5 checks): Conversions configured, industry-appropriate, naming conventions
• Product Linking (6 checks): Google Ads, Search Console, BigQuery, DV360, SA360, Firebase
• Custom Definitions (4 checks): Dimensions, metrics, naming, orphan detection
• Audiences & Access (4 checks): Audiences, triggers, user access, data sharing

Phase 3: Pixel & CAPI Detection ✅ Live (via Page Scanner)

Cross-platform pixel detection and CAPI indicator checking integrated into the Page Scanner.

Phase 4: Remediation Engine ✅ Live

For every issue found, generates:

• dataLayer.push() code for ecommerce events (purchase, add_to_cart, view_item, begin_checkout) and lead events (generate_lead)
• Meta CAPI boilerplate (Node.js with Python guidance)
• Google Consent Mode v2 implementation template
• Enhanced Conversions setup code with all user_data fields
• Full pixel installation snippets (LinkedIn Insight, etc.)
• GTM noscript fallback code
• dataLayer initialization code

Phase 5: AI Page Vision ✅ Live

Gemini 2.0 Flash analyzes webpage HTML to identify every trackable interactive element:

• Forms, CTAs, navigation, ecommerce elements, engagement widgets, conversion elements
• Maps each to a recommended GA4 event name with parameters
• Shows priority (Critical/High/Medium/Low) and tracked status (Yes/Partial/No)
• Requires a free Gemini API key from Google AI Studio

---

Scoring

Tag Health Score (0–100):

Severity	Deduction	Example
Critical	-15	No purchase event on ecommerce site
High	-10	Meta Advanced Matching missing
Medium	-5	CAPI not detected
Low	-2	GTM noscript fallback missing

Grades: A (90+), B (80–89), C (70–79), D (60–69), F (<60)

---

Security & Privacy

• Zero server-side storage. No database, no user accounts, no cookies.
• All analysis runs client-side. HTML content is never sent to our servers.
• API keys in sessionStorage only. Cleared when the tab closes. Never persisted.
• No telemetry. No analytics tracking on the tool itself.
• API calls go direct. GA4 Admin API, Gemini, etc. are called directly from your browser.
• Open source. Every line is auditable.

---

File structure

analytics-auditor/
├── index.html          Landing page with animated demo
├── app.html            The auditor application (all features)
├── docs.html           Full documentation with sidebar nav
├── README.md           This file
├── ARCHITECTURE.md     Technical architecture & build plan
├── CONTRIBUTING.md     How to contribute
├── CHANGELOG.md        Version history
├── LICENSE             MIT License
└── .gitignore

---

Exports

Format	Contents	Use Case
JSON	Complete scan results	CI/CD integration, programmatic use
CSV	Tag inventory + issues	Spreadsheet analysis, client reports
Remediation TXT	All fix code + descriptions	Developer handoff
Print / PDF	Full visual report	Client presentations

---

Contributing

See CONTRIBUTING.md for guidelines. The easiest ways to contribute:

1. Add a platform detection signature — Follow the pattern in TAG_DEFS in app.html
2. Add an audit check — Each check is a function that returns pass/warn/fail
3. Add a remediation template — Code snippet templates for common fixes
4. Report bugs — Open an issue with the URL (or sanitized HTML) that caused the problem

---

Roadmap

• Phase 1: Page scanner + tag detection + remediation code
• Phase 2: GA4 Admin API property audit (40-point checklist)
• Phase 3: Pixel & CAPI detection (integrated into page scanner)
• Phase 4: Remediation engine (dataLayer, CAPI, Enhanced Conversions, Consent Mode)
• Phase 5: AI page vision (Gemini 2.0 Flash event discovery)

---

Part of the Google Ads Agent ecosystem

This tool is part of the Google Ads Agent project — an open-source AI agent for Google Ads management.

Tool	Description
Google Ads API Agent	28 Python actions, 6 sub-agents, live Google Ads API access
Google Ads Builder	AI-powered ad copy generator for RSAs, sitelinks, callouts
Analytics Auditor (this tool)	GA4/GTM/pixel audit with auto-remediation

---

Author

John Williams — Senior Paid Media Specialist at Seer Interactive. 15+ years managing $48M+ in digital advertising. Built with Cursor and Claude.

• Website: itallstartedwithaidea.com
• LinkedIn: johnmichaelwilliams
• X: @_johnmwilliams

---

License

MIT — see LICENSE for details.