# 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](../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

```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 |

## 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.

```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
