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/scoring-system.md
View on GitHub# Ad Account Audit Scoring System
## Check ID Convention
- **Sequential IDs** (G01, M01, T01): Original v1.0 checks
- **Hyphenated IDs** (G-AI1, M-AN1, T-SR1, X-PI1): Extension checks added after v1.0
- **Platform prefixes**: G = Google, M = Meta, T = TikTok, X = Cross-platform
## Weighted Scoring Algorithm
```
S_total = Σ(C_pass × W_sev × W_cat) / Σ(C_total × W_sev × W_cat) × 100
```
- `C_pass` = check passed (1) or failed (0); WARNING = 0.5
- `W_sev` = severity multiplier of the individual check
- `W_cat` = category weight for that platform
- Result: 0-100 Health Score
## Severity Multipliers
| Severity | Multiplier | Criteria |
|----------|-----------|----------|
| Critical | 5.0 | Immediate revenue/data loss risk. Remediation urgent. |
| High | 3.0 | Significant performance drag. Fix within 7 days. |
| Medium | 1.5 | Optimization opportunity. Fix within 30 days. |
| Low | 0.5 | Best practice, minor impact. Nice to have. |
## Scoring Per Check Item
| Result | Points Earned |
|--------|--------------|
| PASS | Full severity × category weight |
| WARNING | 50% of full points |
| FAIL | 0 points |
| N/A | Excluded from total possible |
## Category Weights by Platform
### Google Ads
| Category | Weight | Rationale |
|----------|--------|-----------|
| Conversion Tracking | 25% | Foundation for all optimization; Enhanced Conv + Consent Mode V2 + CTV tracking (12 checks) |
| Wasted Spend / Negatives | 20% | Direct money leak; search terms, negative lists (8 checks) |
| Account Structure | 15% | Campaign organization, brand/non-brand separation (12 checks) |
| Keywords & Quality Score | 15% | QS as diagnostic, not KPI; keyword-ad alignment (8 checks) |
| Ads & Assets | 15% | RSA strength, PMax assets, AI Max, Demand Gen (12 checks + PMax 6 + AI/DG 4) |
| Settings & Targeting | 10% | Location, network, audiences, landing pages (12 checks) |
### Meta Ads
| Category | Weight | Rationale |
|----------|--------|-----------|
| Pixel / CAPI Health | 30% | 87% of advertisers have poor EMQ; foundational signal (10 checks) |
| Creative (Diversity & Fatigue) | 30% | Andromeda makes creative the #1 targeting lever (12 checks) |
| Account Structure | 20% | Learning phase, Advantage+ Sales, consolidation (18 checks) |
| Audience & Targeting | 20% | Overlap, exclusions, Advantage+ Audience (6 checks) |
| Andromeda & Platform Changes | N/A | Extension checks scored within above categories (4 checks) |
### TikTok Ads
| Category | Weight | Rationale |
|----------|--------|-----------|
| Creative Quality | 30% | Native-feel content is #1 success factor (10 checks) |
| Technical Setup | 25% | Pixel + Events API Gateway + ttclid passback (2 checks) |
| Bidding & Learning | 20% | 50 conv/week to exit learning; budget sufficiency (3 checks) |
| Structure & Settings | 15% | Smart+ modular control, Search Toggle, Shop integration (6 checks) |
| Performance | 10% | CTR, CPA, completion rate benchmarks (3 checks) |
| Search, Commerce & Tracking | N/A | Extension checks scored within above categories (3 checks) |
## Grading Thresholds
| Grade | Score | Label | Action Required |
|-------|-------|-------|-----------------|
| A | 90-100 | Excellent | Minor optimizations only |
| B | 75-89 | Good | Some improvement opportunities |
| C | 60-74 | Needs Improvement | Notable issues need attention |
| D | 40-59 | Poor | Significant problems present |
| F | <40 | Critical | Urgent intervention required |
## Quick Wins Logic
```
IF severity == "Critical" OR severity == "High"
AND estimated_remediation_time < 15 minutes
THEN flag as "Quick Win"
PRIORITY: Quick Wins sorted by (severity × estimated_impact) DESC
```
Quick Win examples:
- Enable Enhanced Conversions (Critical, 5 min)
- Turn on Search Ads Toggle in TikTok (High, 2 min)
- Add negative keyword lists (Critical, 10 min)
- Fix location targeting method (Critical, 2 min)
- Enable Advantage+ Placements (Medium, 2 min)
## Weighting Rationale
Category weights are calibrated for paid advertising accounts where conversion tracking infrastructure is the highest-impact factor (25-30% weight across platforms). This differs from generic scoring systems because:
- Broken tracking invalidates all optimization decisions downstream
- Creative and targeting quality follow tracking in priority
- Settings and compliance are important but have lower direct revenue impact
- Weights sum to 100% per platform, enabling direct cross-platform comparison
The grading thresholds (A=90-100, B=75-89, C=60-74, D=40-59, F=<40) use wider bands than academic-style scoring because ad account health is typically distributed lower; a score of 75+ represents genuinely well-managed accounts.
---
## Cross-Platform Checks
These checks apply across all platforms during full audits:
| ID | Check | Severity | Description |
|----|-------|----------|-------------|
| X-PI1 | Privacy infrastructure completeness | Critical | Consent Mode V2 (Google) + CAPI (Meta) + Events API + ttclid passback (TikTok). Without proper signals, no optimization works |
| X-CD1 | Creative diversity audit | High | Andromeda (Meta), Smart+ (TikTok), and PMax (Google) all use creative signals for targeting. Flag accounts with <5 genuinely distinct creative concepts |
| X-RF1 | Platform-appropriate refresh cadence | High | TikTok 7-10d, Meta 14-21d, Google 8-12w. Flag overdue refreshes |
Cross-platform checks are scored at 100% weight in the aggregate score (not within any single platform).
---
## Total Check Counts
| Platform | Checks | Notes |
|----------|--------|-------|
| Google | 80 | Includes YouTube video campaigns (G-DG*, G-CTV*) since they share the Google Ads API |
| Meta | 50 | Andromeda, attribution, Incremental, Threads extensions |
| TikTok | 28 | Search, GMV Max, Events API extensions |
| Cross-platform | 3 | Privacy, creative diversity, refresh cadence |
| **Total** | **161** | 158 platform-specific + 3 cross-platform |
---
## Cross-Platform Aggregate Score
When auditing multiple platforms, calculate per-platform scores then aggregate:
```
Aggregate Score = Σ(Platform_Score × Platform_Budget_Share)
Example: Google (82) × 50% + Meta (71) × 35% + TikTok (88) × 15%
= 41.0 + 24.85 + 13.2 = 79.05 → Grade B
```
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 |