Hainrixz/claude-ads / ads
ads
UnverifiedFree-first paid advertising audit and optimization skill, focused on the 3 platforms where 95% of advertiser spend lives: Meta, Google, TikTok. Guided onboarding (/ads start) saves context once and step-by-step OAuth walkthroughs; continuous coach (/ads next) ranks Quick Wins after each audit. ~158 weighted checks with scoring, parallel agents, industry templates, and AI creative generation.
references/tracking-tiktok.md
View on GitHub# TikTok Ads Conversion Tracking
## Required Stack
```
1. TikTok Pixel → base code + standard events on all pages
2. Events API → server-side event forwarding
3. ttclid Passback → capture from URL params, send with events
4. Advanced Matching → hashed email/phone
```
## Key Difference: ttclid
- TikTok Click ID (ttclid) comes in landing page URL parameters.
- MUST be captured and stored on first page load (cookie or session storage).
- MUST be sent back with all conversion events to the Events API.
- Without ttclid: attribution breaks for many conversions; TikTok over-claims via modeled attribution.
## Standard Events
```
ViewContent, AddToCart, InitiateCheckout, AddPaymentInfo,
Purchase, CompleteRegistration, Lead, Subscribe
```
Match Pixel + Events API event_id between client-side and server-side to avoid double-counting.
## Learning Phase
- ~50 conversions in 7 days to exit learning.
- Budget ≥50× target CPA per ad group (provides sufficient learning room).
- Avoid edits during learning phase (resets the learning timer).
## Attribution Windows
| Window | TikTok default | Recommended |
|--------|---------------|-------------|
| Click | 7 days | 7-day click for e-commerce, 14-28 day for B2B/considered purchases |
| View | 1 day | Keep at 1 day to avoid view-through over-claim |
## Events API Gateway (2024+)
Recommended for accounts running 100+ conversions/week. Reduces data loss
from ad-blockers and iOS ATT, improves Match Rate by 15-30%.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |