Andrew Yim
fb2a653866
- Automated GTM container detection and validation - DataLayer event validation against GA4 specs - Form tracking analysis and interaction simulation - E-commerce checkout flow analysis - Multi-platform support (GA4, Meta, LinkedIn, Google Ads, Kakao, Naver) - Notion database export with detailed reporting - Korean market considerations 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
116 lines
3.1 KiB
Markdown
116 lines
3.1 KiB
Markdown
# GTM Audit Tool
|
|
|
|
Automated Google Tag Manager audit toolkit powered by Playwright.
|
|
|
|
## 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
|
|
- **Notion Integration**: Export audit results to Notion database for tracking
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
# Clone or download
|
|
cd gtm-audit-claude-code
|
|
|
|
# Install dependencies
|
|
pip install -r requirements.txt
|
|
|
|
# Install Playwright browsers
|
|
playwright install chromium
|
|
```
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
# 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 |
|
|
| `--notion` | Export results to Notion database | False |
|
|
| `--notion-database` | Custom Notion database ID | OurDigital GTM Audit Log |
|
|
| `--notion-detailed` | Add detailed content to Notion page | False |
|
|
|
|
## 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
|
|
|
|
## Notion Integration
|
|
|
|
Export audit results directly to Notion for team collaboration and historical tracking.
|
|
|
|
```bash
|
|
# Set Notion API token
|
|
export NOTION_TOKEN="secret_xxxxx"
|
|
|
|
# Export to Notion (default database)
|
|
python gtm_audit.py --url "https://yoursite.com" --notion
|
|
|
|
# Export with detailed content (issues, recommendations, checklist)
|
|
python gtm_audit.py --url "https://yoursite.com" --notion --notion-detailed
|
|
```
|
|
|
|
The audit creates a new row in the Notion database with:
|
|
- Site name and URL
|
|
- Audit date and unique ID
|
|
- GTM status and container IDs
|
|
- Tags fired (GA4, Meta, etc.)
|
|
- Issue counts and overall status
|
|
- Summary of findings
|
|
|
|
## Using with Claude Code
|
|
|
|
This project includes a `CLAUDE.md` file optimized for use with Claude Code.
|
|
|
|
```bash
|
|
# 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
|