Files

Andrew Yim 31506e026d refactor(gtm): Split into lightweight audit and comprehensive manager

- 13-ourdigital-gtm-audit: Lightweight audit-only tool (original)
  - GTM container validation
  - DataLayer event checking
  - Form and checkout analysis
  - No Notion integration, no inject mode

- 14-ourdigital-gtm-manager: Comprehensive management toolkit
  - Full audit capabilities
  - DataLayerInjector for custom HTML tag generation
  - Notion integration for audit logging
  - 20+ GA4 event templates

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2025-12-20 22:46:16 +09:00

2.3 KiB

Raw Blame History

OurDigital GTM Audit

Lightweight Google Tag Manager audit toolkit powered by Playwright.

Note

: For comprehensive GTM management including dataLayer tag generation, see 14-ourdigital-gtm-manager.

Features

Container Detection: Verify GTM installation, position, and duplicates
DataLayer Validation: Event structure, types, sequence checking
Form Tracking: Form discovery, field analysis, event verification
E-commerce Checkout: Full funnel flow simulation and validation
Multi-Platform: GA4, Meta Pixel, LinkedIn, Google Ads, Kakao, Naver

Installation

# Clone or download
cd gtm-audit-claude-code

# Install dependencies
pip install -r requirements.txt

# Install Playwright browsers
playwright install chromium

Usage

# Full audit
python gtm_audit.py --url "https://yoursite.com" --journey full

# Specific container validation
python gtm_audit.py --url "https://yoursite.com" --container "GTM-XXXXXX"

# Form tracking only
python gtm_audit.py --url "https://yoursite.com/contact" --journey form

# E-commerce checkout
python gtm_audit.py --url "https://yoursite.com/cart" --journey checkout

Options

Option	Description	Default
`--url`	Target URL (required)	-
`--container`	Expected GTM container ID	None
`--journey`	Audit type: pageview, scroll, form, checkout, datalayer, full	full
`--output`	Output file path	gtm_audit_report.json
`--timeout`	Page load timeout (ms)	30000
`--headless`	Run browser headless	True

Output

Generates JSON report with:

Container status
DataLayer events and validation issues
Form analysis and tracking readiness
Checkout flow analysis
Network requests by destination
Recommendations and checklist

Using with Claude Code

This project includes a CLAUDE.md file optimized for use with Claude Code.

# In your terminal
claude

# Then ask Claude to run audits
> Run a GTM audit on https://example.com
> Check the form tracking on https://example.com/contact
> Analyze the checkout flow issues in the latest report

Documentation

See docs/ folder for:

GA4 event specifications
E-commerce dataLayer schemas
Form tracking patterns
Checkout flow sequences
Common issues and fixes

License

MIT

2.3 KiB Raw Blame History