Skip to content

Hainrixz/claude-ads / ads

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

FileKindSize
SKILL.mdskill md18.6 KB
references/additional-platforms.mdmarkdown3.6 KB
references/audit-history-schema.jsonconfig2.5 KB
references/audit-methodology.mdmarkdown4.3 KB
references/audit-output-schema.jsonconfig4.9 KB
references/benchmarks-cross.mdmarkdown1003 B
references/benchmarks-google.mdmarkdown1.6 KB
references/benchmarks-social.mdmarkdown2.6 KB
references/benchmarks.mdmarkdown929 B
references/bidding-google.mdmarkdown5.2 KB
references/bidding-meta.mdmarkdown1.8 KB
references/bidding-strategies.mdmarkdown989 B
references/bidding-tiktok.mdmarkdown2.0 KB
references/brand-dna-template.mdmarkdown6.9 KB
references/budget-allocation.mdmarkdown5.8 KB
references/compliance-changes-2025-2026.mdmarkdown2.5 KB
references/compliance-platforms.mdmarkdown3.6 KB
references/compliance-privacy.mdmarkdown3.1 KB
references/compliance.mdmarkdown1.6 KB
references/conciencia-schema.jsonconfig5.3 KB
references/conciencia.mdmarkdown5.2 KB
references/conversion-tracking.mdmarkdown1.2 KB
references/copy-frameworks.mdmarkdown8.9 KB
references/gaql-notes.mdmarkdown2.8 KB
references/google-audit-notes.mdmarkdown3.9 KB
references/google-audit.mdmarkdown12.5 KB
references/google-changelog-30d.mdmarkdown3.6 KB
references/google-creative-specs.mdmarkdown3.7 KB
references/image-providers.mdmarkdown4.9 KB
references/mcp-integration.mdmarkdown5.7 KB
references/mcp-meta-integration.mdmarkdown5.8 KB
references/meta-audit.mdmarkdown12.4 KB
references/meta-changelog-30d.mdmarkdown4.0 KB
references/meta-creative-specs.mdmarkdown4.5 KB
references/platform-specs-cross.mdmarkdown1.3 KB
references/platform-specs.mdmarkdown799 B
references/profile-schema.jsonconfig4.5 KB
references/scoring-system.mdmarkdown6.1 KB
references/setup-google.mdmarkdown7.1 KB
references/setup-meta-developers.mdmarkdown4.7 KB
references/setup-meta.mdmarkdown7.0 KB
references/setup-tiktok.mdmarkdown5.2 KB
references/setup-zernio.mdmarkdown4.5 KB
references/tiktok-audit.mdmarkdown10.1 KB
references/tiktok-changelog-30d.mdmarkdown3.5 KB
references/tiktok-creative-specs.mdmarkdown4.8 KB
references/tracking-cross.mdmarkdown1.5 KB
references/tracking-google.mdmarkdown2.8 KB
references/tracking-meta.mdmarkdown2.4 KB
references/tracking-tiktok.mdmarkdown1.5 KB
references/update-cost-warning.mdmarkdown2.0 KB
references/voice-to-style.mdmarkdown3.9 KB
research-sources/README.mdmarkdown883 B
research-sources/claude-research.mdmarkdown3.9 KB
research-sources/gemini-research.mdmarkdown10.2 KB
research-sources/google-audit-checklists.mdmarkdown25.9 KB
research-sources/google-optimization-logic.mdmarkdown11.9 KB
research-sources/google-platform-specs.mdmarkdown16.6 KB

research-sources/gemini-research.md

View on GitHub
# Gemini Deep Research: The State of Paid Advertising 2026

> Source: Gemini Deep Research, February 2026
> Original file: `~/Downloads/the state of paid advertising 2026.txt`
> 344 lines, 36 cited sources

## Executive Summary

The 2026 advertising ecosystem operates under a **signal-based paradigm**; transition from keyword-centric targeting to signal-based intent modeling. Key shifts:

1. **Privacy Sandbox is dead**: Google retired it October 2025 (CMA pressure + performance issues)
2. **Third-party cookies persist** in Chrome but signal fidelity is degraded
3. **Server-side integrations (CAPI) are the standard**: pixel-only = vulnerability
4. **AI Max for Search**: LLMs match landing page content to conversational queries, bypassing keyword matching
5. **Media Mix Modeling (MMM) renaissance**: Google Meridian, Meta Robyn for budget allocation
6. **Platform "black boxes" dominate**: PMax, Advantage+, Smart+ are the norm

---

## Section 1: Macro-Environment & Privacy

### Post-Sandbox Reality
- Privacy Sandbox APIs (Topics, Protected Audience, Attribution Reporting) shut down on Chrome AND Android
- Third-party cookies remain but with browser-level protections + iOS ATT
- **Audit implication**: Penalize accounts lacking dual-tagging (Pixel + Server-Side)
- Must verify Enhanced Conversions (Google) and EMQ (Meta)

### AI Max & Generative Search
- Ads now appear in AI Overviews (AIO) via "AI Max"
- Landing pages need machine-interpretability: Schema markup (FAQPage, Product), semantic hierarchy
- Keyword density less relevant than structured data

### MMM Renaissance
- Hybrid strategy: MTA for tactical optimization + MMM for strategic budget setting
- Platform-reported ROAS often overclaims; weight down by ~30% based on MMM incrementality
- Tools: Google Meridian, Meta Robyn (Bayesian methods)

---

## Section 2: Google Ads Architecture

### Broad Match + Smart Bidding = "Power Pairing"
- Exact Match now captures "same meaning"
- Broad Match captures "intent" from user history + landing page context
- **Critical error**: Broad Match + Manual CPC = unrestricted spend on irrelevant queries
- Negative keyword lists mandatory: "Competitor," "Cheap/Free," "Jobs" themes
- Brand Guidelines must be configured in PMax/Search

### Performance Max (PMax) Maturity
- Now a "grey box"; campaign-level negatives, brand exclusions, improved reporting
- Share of Voice reporting + Search Term Insights available
- Structure Asset Groups by **User Intent** not Product Category
- **Asset requirements**: Max 15 headlines, 5 descriptions, 20 images per group
- Missing video assets → PMax generates low-quality robotic videos (High Risk)
- New Customer Acquisition (NCA) rules essential for prospecting

### Quality Score 2026
- Ad Rank = CPC Bid × Quality Score (unchanged formula)
- Priority: Expected CTR (heaviest) > Landing Page Experience > Ad Relevance
- Score < 5 = Critical, 5-7 = Warning, 8-10 = Healthy
- Actual CPC = (Ad Rank Below / Your QS) + $0.01

### Google Ads API v23 (January 2026)
- InvoiceService: campaign-level cost breakdowns
- PMax Share of Voice: impression share lost to budget/rank
- Ad Strength Diagnostic: "Good"/"Excellent" ratings for RSA assets
- Campaign scheduling: start/end down to the minute

---

## Section 3: Meta Ads: Andromeda Engine

### Andromeda Algorithm Update (2025/2026)
- AI-driven matching system, not simple auction
- Optimizes for "creative portfolios" not single ads
- Requires larger creative volume (old "3-5 ads per ad set" = obsolete)
- **Creative IS the targeting**: broad targeting + specific creative angles

### 3-Stage Account Structure
1. **Testing Campaign (ABO)**: Test new concepts, multiple batches per ad set
2. **Challenger ASC**: Graduate winners, prevents budget starvation
3. **Core/Evergreen Campaign (CBO)**: Proven, scalable assets

### Red Flags
- >5 active campaigns targeting same country/funnel stage = fragmentation
- High auction overlap rates = bidding against yourself

### Creative Signals
- Social-native content rewarded: 9:16, handheld, selfie POV, lo-fi
- Hook Rate: first 3 seconds critical, >50% skip rate = flag for refresh
- Organic boosting (Reels → partnership ads) most effective strategy

### Meta API
- Rate limits: rolling 1-hour window, check X-Business-Use-Case-Usage header
- >75% usage = pause 5 min, error 613/80004 = exponential backoff
- EMQ score < 7.0 = severe data loss = high-priority alert

---

## Section 4: TikTok Ads

### TikTok as Search Engine
- Primary search for Gen Z by 2026
- "Search Ads Toggle" ON → 70% stronger CPA
- Captions = SEO meta descriptions (high-intent keywords in text overlays)

### Smart+ Campaigns
- Automates targeting, bidding, creative selection
- Creative fatigue: >7 days + declining CTR = flag for replacement
- Minimum 6 creative assets per ad group

### TikTok Shop
- Primary e-commerce conversion engine
- Video Shopping Ads (VSA) = in-app purchase
- Spark Ads outperform non-Spark (creator authority + profile linkage)

### API
- Rate limit: 600 req/min for core endpoints
- Implement queuing for multi-client, respect Retry-After on 429s

---

## Section 5: LinkedIn Ads

### Thought Leader Ads (TLA): Dominant B2B Format
- 1.7x higher CTR, 1.6x more engagement vs standard
- CPC: $4.14 (TLA) vs $22+ (standard brand)
- Allocate 30% budget to TLAs for trust-building

### Conversation Ads vs Message Ads
- Conversation Ads: 12% CTR, choose-your-own-path, for complex offers
- Message Ads: Linear, single CTA, for direct invites
- Frequency cap: 1 message per 30-45 days per user

### Benchmarks
- CPC: $13.23 (single image), $2.29 (TLA)
- CTR benchmark: 0.44%-0.65%, >1% = exceptional
- Video ads lowest efficiency (1.5), TLAs highest (9.5)

---

## Section 6: Microsoft Ads & Copilot

- PMax inventory includes Copilot chat sessions → 63% conversion rate increase
- "Target New Customers" goal in PMax (Beta 2026)
- Google Ads PMax import available; validate URL settings transfer

---

## Section 7: Cross-Platform Benchmarks 2026

| Metric | E-Commerce | B2B SaaS | Legal | Finance | Healthcare | Local Services |
|--------|-----------|----------|-------|---------|------------|---------------|
| Google Search CTR | 4.13% | 4.28% | 5.20% | 4.65% | 4.90% | 5.50% |
| Google Search CPC | $1.15 | $4.50 | $750+ | $900+ | $40+ | $15-$30 |
| Google Search CVR | 2.81% | 1.65% | 4.60% | 3.50% | 3.10% | 15.0% |
| Meta Ads CTR | 1.38% | 0.90% | 0.85% | 0.70% | 1.10% | 1.50% |
| Meta Ads CPM | $12.50 | $35.00 | $45.00 | $50.00 | $28.00 | $18.00 |
| LinkedIn CPC | N/A | $13.23 | $25.00 | $35.00 | N/A | N/A |
| LinkedIn CTR | N/A | 0.56% | 0.45% | 0.40% | N/A | N/A |
| TikTok Ads CPM | $3.21 | $8.00 | N/A | N/A | N/A | $5.00 |
| ROAS Benchmark | 4.0x-7.5x | N/A | 3.0x | 3.5x | 2.8x | 5.0x |

---

## Section 8: Universal Audit Framework

### Category A: Conversion Data Hygiene (25%)
1. Enhanced Conversions enabled? (Pass/Fail)
2. Server-Side Tracking (CAPI/OCI) active? (Pass/Fail)
3. Micro vs Primary conversions separated in bidding? (Pass/Fail)
4. New Customer value rule applied? (Pass/Fail)

### Category B: Account Structure & Bidding (20%)
1. Broad Match only with Smart Bidding? (Pass/Fail)
2. Portfolio Bid Strategies used? (Pass/Fail)
3. <5 active campaigns per funnel stage? (Pass/Fail)
4. Brand vs Non-Brand traffic separated? (Pass/Fail)

### Category C: Creative Diversity & Health (25%)
1. (Meta) >3 distinct formats active? (Pass/Fail)
2. (Google) PMax has 9:16 video assets? (Pass/Fail)
3. <10% ads with "Poor" Ad Strength? (Pass/Fail)
4. No CTR drop >30% in last 14 days? (Pass/Fail)

### Category D: Targeting & Exclusions (15%)
1. Account-level placement exclusions applied? (Pass/Fail)
2. Customer Match lists refreshed <30 days? (Pass/Fail)
3. (Meta) Advantage+ Audience enabled? (Pass/Fail)

### Category E: Landing Page Experience (15%)
1. Mobile LCP < 2.0s? (Pass/Fail)
2. Valid Schema markup present? (Pass/Fail)
3. H1 matches Ad Headline? (Semantic similarity)

---

## Section 9: Industry Playbooks

### B2B SaaS: "SME Engine"
- TOFU: LinkedIn TLAs + Meta Video Views (ungated value)
- MOFU: Conversation Ads / Lead Forms (calculators, audits)
- BOFU: Google Search retargeting (brand + competitor keywords)
- Key metric: Pipeline ROI via Offline Conversion Import

### E-Commerce DTC: "Four Peaks" Theory
- Plan quarterly peaks to reset algorithmic fatigue
- Acquisition: PMax + ASC + TikTok Shop (1 hero campaign per platform)
- Retention: Email/SMS + Customer Match cross-sells
- Key metric: MER (Marketing Efficiency Ratio), POAS

### Local Services
- Google LSA (pay-per-lead) + Google Guaranteed badge
- Geo-fenced Meta/YouTube retargeting (+5 miles)
- Key metric: Cost Per Booked Appointment
- Dispute invalid LSA leads weekly, sync CRM for Smart Bidding

### Info Products: "Selfie-Style" Authority
- Founder-led video on Meta/YouTube
- Funnel: Short video → VSL/Webinar → Low-ticket tripwire ($27-$97) → High-ticket upsell
- Monitor Hook Rate (<30% = rewrite intro) and Hold Rate (ThruPlay)

---

## Section 10: API Engineering

### Rate Limits
| Platform | Limit | Strategy |
|----------|-------|----------|
| Google Ads API | 15,000 ops/day (Basic) | Batch up to 5,000 ops, partial_failure=true |
| Meta Marketing API | Rolling 1-hour window (spend-based) | Check X-Business-Use-Case-Usage, pause at 75% |
| TikTok Ads API | 600 req/min | Client-side throttling, respect Retry-After |

### Authentication
- Google: Refresh Token → short-lived Access Token (1hr), handle invalid_grant
- Meta: Short-lived → Long-lived tokens (60 days), warn if <7 days remain

### Critical Audit Endpoints
| Platform | Goal | Endpoint | Field |
|----------|------|----------|-------|
| Google | Budget | CampaignBudgetService | recommended_budget_amount |
| Google | Quality Score | KeywordView | quality_score |
| Google | Ad Strength | AdGroupAdService | ad_strength |
| Meta | Ad Quality | Insights | quality_ranking, engagement_rate_ranking |
| Meta | Creative Fatigue | Insights (time series) | ctr (7d vs 30d) |
| TikTok | Account Health | Account Health | is_restricted, policy_violations |
| LinkedIn | Audience Quality | AdAnalytics | demographic_metrics |

### Safe Write Operations
- All write ops = "Dry Run" or explicit user confirmation
- Log every change to claude-ads.log with timestamps + previous values
- Generative copy must use platform character limits as strict constraints
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall