start-vibing-stacks 2.29.0 → 2.30.0

package/stacks/_shared/ads-agents/references/meta-creative-specs.md

@@ -0,0 +1,134 @@
+# Meta Creative Specs: Generation Guide
+
+<!-- Updated: 2026-03-12 -->
+<!-- Source: platform-specs.md + Meta Ads Manager requirements -->
+<!-- Used by: ads-generate, visual-designer agent -->
+
+## Purpose
+
+Generation-ready specifications for Meta (Facebook + Instagram) ad creative. Includes
+safe zone diagrams, copy limits, and prompt modifiers for each placement type.
+
+---
+
+## Image Specs by Placement
+
+| Placement | Ratio | Dimensions | Priority |
+|-----------|-------|-----------|----------|
+| Feed (preferred) | 4:5 | 1080×1350 | **Primary target** |
+| Feed (square) | 1:1 | 1080×1080 | High |
+| Stories | 9:16 | 1080×1920 | High |
+| Reels | 9:16 | 1080×1920 | High |
+| Right Column | 1:1 | 1080×1080 | Low |
+| Max file size: 30MB. Min width: 600px (1080px recommended).
+
+**Primary generation target: 1080×1350 (4:5)**
+This ratio performs best in Feed and covers Instagram Feed.
+Always generate this first. Generate 9:16 for Stories/Reels campaigns.
+
+---
+
+## Safe Zones: Reels and Stories (1080×1920)
+
+```
+┌─────────────────────────────────┐ ← Top (Y:0)
+│         STATUS BAR              │ ← Y:0-120 (avoid)
+│                                 │
+│      ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓   │ ← SAFE START Y:120
+│      ▓                     ▓   │
+│      ▓   SAFE CONTENT ZONE  ▓   │
+│      ▓      1080×1300px     ▓   │
+│      ▓  (center of frame)   ▓   │
+│      ▓                     ▓   │
+│      ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓   │ ← SAFE END Y:1420
+│                                 │
+│   CTA BUTTON / CAPTION AREA     │ ← Y:1420-1920 (avoid)
+│   REACTIONS / PROFILE INFO      │
+└─────────────────────────────────┘ ← Bottom (Y:1920)
+```
+
+**Bottom 35% (~670px) is UI overlay.** Keep all critical text, faces, and product
+in the center 1080×1300px zone.
+
+**Generation instruction for 9:16 prompts:**
+- Subject and key visual elements in top 60% of frame
+- Bottom 450px should be background only (solid color or soft gradient)
+- Vertical composition only; horizontal crops are rejected at upload
+
+---
+
+## Safe Zone: Feed (1080×1350, 4:5)
+
+No hard safe zone required. The full frame is visible. However:
+- Bottom 120px may be covered by the like/comment bar on mobile
+- Keep primary subject in upper 80% of frame
+
+---
+
+## Copy Limits
+
+| Component | Recommended | Platform Max |
+|-----------|------------|-------------|
+| Primary Text | 40-125 chars | 2,200 |
+| Headline | 27-40 chars | N/A |
+| Description | 20 chars (carousel) | N/A |
+| Reels Primary Text | 72 chars max visible | N/A |
+| CTA Button | Predefined list | N/A |
+
+**Copy generation rule:** Write primary text ≤125 chars. Anything over 125 chars
+gets truncated with "See More" on mobile; the critical message must land in 125.
+
+---
+
+## Carousel Specs
+
+- 2-10 cards per carousel
+- All cards: 1:1 (1080×1080)
+- Per card: Headline ≤40 chars, Description ≤20 chars
+- Generate each card as a separate image prompt
+- Maintain consistent visual style across all cards (same background, same lighting)
+
+---
+
+## Advantage+ Creative
+
+When Advantage+ Creative enhancements are enabled, Meta may:
+- Crop the image to different aspect ratios
+- Adjust brightness/contrast
+- Add music to static images
+- Generate text variations from your primary text
+
+**Implication for generation:** Generate a "base" image that looks good at both
+1:1 and 4:5 ratios. Avoid placing critical elements near edges.
+
+---
+
+## Video Specs (for storyboard reference)
+
+| Placement | Ratio | Resolution | Duration |
+|-----------|-------|-----------|----------|
+| Feed | 4:5 | 1080×1350 | Up to 241 min |
+| Reels | 9:16 | 1080×1920 | ≤90s (rec 15-30s) |
+| Stories | 9:16 | 1080×1920 | ≤120s |
+| In-Stream | 16:9 | 1920×1080 | ≤15 min |
+
+---
+
+## Image Generation Prompt Modifiers
+
+**For Feed (4:5 and 1:1):**
+- `"vertical composition"` or `"square composition"`
+- `"subject fills upper portion of frame"`
+- `"clean, scroll-stopping visual"`
+- `"no text overlay"` (text added via ad copy fields)
+
+**For Stories/Reels (9:16):**
+- `"vertical composition, subject in top 60% of frame"`
+- `"bottom third is clear background or soft gradient"`
+- `"bold, high-contrast visual"`
+- `"mobile-first, designed for small screen viewing"`
+
+**Always avoid:**
+- Cluttered backgrounds (compete with feed content)
+- Low contrast (thumb-stop requires visual pop)
+- Faces cropped at edges (Instagram crops aggressively on some placements)

package/stacks/_shared/ads-agents/references/microsoft-audit.md

@@ -0,0 +1,158 @@
+# Microsoft Ads Audit Checklist
+
+<!-- Updated: 2026-05-14 | v1.6 -->
+<!-- Sources: Google Research PDF 1 (MS01-MS20), Claude Research, Gemini Research, Seer Interactive, 2026 Verification Pass -->
+<!-- Total Checks: 24 | Categories: 6 | See scoring-system.md for weights and algorithm -->
+
+## Quick Reference
+
+| Category | Weight | Check Count |
+|----------|--------|-------------|
+| Technical Setup | 25% | MS01-MS03 (3 checks) |
+| Syndication & Bidding | 20% | MS04-MS07 (4 checks) |
+| Structure & Audience | 20% | MS08-MS10 (3 checks) |
+| Creative & Extensions | 20% | MS11-MS13 + MS19-MS20 (5 checks) |
+| Settings & Performance | 15% | MS14-MS18 (5 checks) |
+| Import Safety, Compliance & Video (v1.5) | N/A | MS-SI1, MS-CM1, MS-CT1, MS-VD1 (4 checks) |
+
+---
+
+## Technical Setup (25% weight)
+
+| ID | Check | Severity | Pass | Warning | Fail |
+|----|-------|----------|------|---------|------|
+| MS01 | UET tag installed | Critical | Universal Event Tracking tag firing on all pages | Firing on most pages (>90%) | UET tag not installed or broken |
+| MS02 | Enhanced conversions | High | Enhanced conversions enabled for improved matching | N/A | Not enabled |
+| MS03 | Google Ads import validation | High | If imported: all settings verified (URLs, extensions, bids). Scheduled auto-imports deactivated after initial setup | Minor discrepancies found | Import errors not resolved (broken URLs, missing goals). Scheduled imports still active without monitoring |
+
+### Import Validation Critical Note
+Google Ads imports are the most common Microsoft Ads setup method. Common import issues:
+- Conversion goals often break during import
+- Tracking templates may not transfer
+- Extensions may be partially imported
+- Bid adjustments may not match
+- **Scheduled auto-imports can re-enable paused campaigns** (a common billing surprise)
+- ALWAYS validate conversion tracking after import
+- **Deactivate auto-imports immediately after initial setup** to prevent silent campaign re-enablement and overwritten manual bid/budget changes
+
+---
+
+## Syndication & Bidding (20% weight)
+
+| ID | Check | Severity | Pass | Warning | Fail |
+|----|-------|----------|------|---------|------|
+| MS04 | Brand syndication control | Critical | Brand campaigns excluded from syndicated partners OR low-performers excluded | Partners enabled, monitored regularly | Brand campaigns on syndicated partners, never reviewed (massive budget waste risk) |
+| MS05 | Audience Network settings | High | Audience Network enabled only if testing intentionally. Run Website URL publisher reports weekly and maintain account-level exclusion lists | Audience Network enabled with regular publisher report monitoring | Audience Network ON by default without review. B2B clients see CPA 2-4x higher from Audience Network than search alone (Seer Interactive). Microsoft auto-includes it by default |
+| MS06 | Bid strategy alignment | High | Strategy matches goal + conversion volume; targets 20-35% lower than Google | Strategy matches but targets not adjusted for Bing | Mismatched strategy for conversion volume |
+| MS07 | Target New Customers (PMax) | Medium | "Target New Customers" enabled for growth campaigns (Beta 2026) | N/A | Not tested for eligible PMax campaigns |
+
+---
+
+## Structure & Audience (20% weight)
+
+| ID | Check | Severity | Pass | Warning | Fail |
+|----|-------|----------|------|---------|------|
+| MS08 | Campaign structure | High | Mirrors Google structure (if imported) or follows best practices | Minor structural issues | Disorganized structure, no naming convention |
+| MS09 | Budget allocation | Medium | Budget proportional to Bing search volume (typically 20-30% of Google) | Slightly over/under-allocated | Budget >50% of Google budget (over-investment) |
+| MS10 | LinkedIn profile targeting | High | LinkedIn targeting utilized for B2B: up to 16% greater CTR and 64% greater conversion rate vs non-audience-targeted ads. Available across Search, DSA, Shopping, PMax, and Multimedia ads. Dimensions: Company (80,000+), Industry (148), Job Function (26). Use Observation (Bid Only) mode first. CPCs 30-70% cheaper than LinkedIn Ads directly | Partial LinkedIn targeting | No LinkedIn targeting for B2B campaigns (unique advantage missed) |
+
+---
+
+## Creative & Extensions (20% weight)
+
+| ID | Check | Severity | Pass | Warning | Fail |
+|----|-------|----------|------|---------|------|
+| MS11 | RSA asset count | High | ≥8 headlines, ≥3 descriptions per RSA | 3-7 headlines, 2 descriptions | <3 headlines (minimum) |
+| MS12 | Multimedia Ads | Medium | Multimedia Ads tested (unique rich visual format) | N/A | Not tested |
+| MS13 | Ad copy uniqueness | Medium | Ad copy optimized for Bing demographics (older, affluent, educated) | Same copy as Google, untested | N/A |
+| MS19 | Action Extension | Medium | Action Extension utilized (unique to Microsoft) | N/A | Not tested |
+| MS20 | Filter Link Extension | Medium | Filter Link Extension tested for product/service categories | N/A | Not tested |
+
+### Microsoft-Unique Formats
+These extensions are ONLY available on Microsoft Ads:
+- **Action Extension**: Predefined action buttons (clickable CTAs)
+- **Filter Link Extension**: Category-based deep links (product filters)
+- **Multimedia Ads**: Rich visual search ads (image + headline + description)
+- **Review Extension**: Third-party review quotes in ads
+
+---
+
+## Settings & Performance (15% weight)
+
+| ID | Check | Severity | Pass | Warning | Fail |
+|----|-------|----------|------|---------|------|
+| MS14 | Copilot placement | Medium | Copilot chat placement enabled for PMax campaigns. CTV ads now serve on Netflix, Max, Hulu, Roku, discovery+. Auto-generated RSA assets enabled by default globally Jan 2026 (5% CTR increase). Image Animation via Copilot pilot (Nov 2025): static images converted to video assets | N/A | Not enabled (73% higher CTR opportunity) |
+| MS15 | Conversion goals | High | Goals configured natively (not relying on Google-imported goals) | Imported goals verified and working | Imported goals not verified |
+| MS16 | CPC vs Google comparison | Medium | Microsoft CPC 20-40% lower than Google for same keywords | CPC within 0-20% of Google | CPC equal to or higher than Google |
+| MS17 | Conversion rate comparison | Medium | Microsoft CVR comparable to Google | CVR 25-50% lower | CVR >50% lower than Google |
+| MS18 | Impression share | Medium | IS tracked for brand and top non-brand terms | Partially tracked | Not tracked |
+
+---
+
+## Quick Wins (Microsoft)
+
+| Check | Fix | Time |
+|-------|-----|------|
+| MS10: LinkedIn targeting | Enable LinkedIn profile targeting for B2B campaigns | 5 min |
+| MS14: Copilot placement | Enable Copilot chat placement in PMax settings | 2 min |
+| MS04: Partner network | Review syndicated partner performance, exclude low-performers | 10 min |
+| MS19: Action Extension | Add Action Extension to campaigns | 5 min |
+| MS12: Multimedia Ads | Create Multimedia Ad from existing assets | 10 min |
+| MS03: Import validation | Verify conversion goals and tracking post-import | 10 min |
+
+---
+
+## Microsoft-Specific Context
+
+| Fact | Value |
+|------|-------|
+| Average CPC | $1.20-$1.55 (20-35% discount vs Google) |
+| Average CTR | 2.83-3.1% (higher than Google's ~2.0%) |
+| US desktop share | 16.75-17.58%; with partners ~25% |
+| Copilot CTR lift | 73% higher than traditional search |
+| Copilot CVR lift | 16% stronger conversion rates |
+| Copilot journey | 33% shorter customer journeys |
+| Purchase intent | 194% more likely to purchase in Copilot |
+| Copilot Checkout | Launched Jan 2026 (in-conversation commerce) |
+| 37% of advertisers | Report higher ROAS vs Google |
+| Bing users click paid ads | 25% more often than Google users |
+| Audience skew | Affluent (~50% top 25% HHI), educated (34% degrees), older (45-64: 38%) |
+| Import options | Quick Import, Smart Import, Advanced Import (Feb 2025) |
+| API version | v13 stable, SOAP-based with REST emerging |
+
+---
+
+## Copilot Integration (2026)
+
+Microsoft's Copilot represents the biggest unique advantage:
+
+1. **Copilot Chat Placement**: Ads appear within conversational search
+2. **Copilot Checkout** (Jan 2026); Full commerce within conversations
+3. **Higher engagement**: 73% CTR lift, 16% CVR lift, 33% shorter journeys
+4. **Shopping intent**: Users 194% more likely to purchase
+5. **Launch partners**: Urban Outfitters, Etsy, Ashley Furniture
+
+Ensure PMax campaigns have Copilot placement enabled to capture this growing channel.
+
+---
+
+## Import Safety, Compliance & Video (v1.5)
+
+| ID | Check | Severity | Pass | Warning | Fail |
+|----|-------|----------|------|---------|------|
+| MS-SI1 | Scheduled import status | Critical | Scheduled Google Ads imports disabled or closely monitored. Auto-imports can silently re-enable paused campaigns and overwrite manual bid/budget changes | Imports active with manual review schedule | Scheduled imports running unmonitored (risk of re-enabling paused campaigns and unexpected spend) |
+| MS-CM1 | Consent Mode compliance (EEA/UK) | High | Consent Mode implemented by May 5, 2025 deadline for EEA/UK/Switzerland audiences. Required for behavioral modeling and conversion recovery | Implementation in progress | Not implemented for EEA/UK/CH audiences (non-compliant since May 2025) |
+| MS-CT1 | CTV ad inventory coverage | Medium | CTV placements evaluated for brand/awareness campaigns. Microsoft CTV now serves on Netflix, Max, Hulu, Roku, discovery+. 30-second non-skippable format available | N/A | CTV not evaluated despite brand awareness objectives |
+| MS-VD1 | Video ad inventory utilization | Medium | Video formats tested: 9:16 vertical video (available since Apr 2025), up to 90-second duration. Copilot Image Animation (Nov 2025 pilot) evaluated for static-to-video conversion | N/A | No video assets despite available inventory and video-capable campaigns |
+
+---
+
+## Context Notes
+
+- **PMax on Microsoft**: Up to 300 campaigns per account (vs 100 on Google). LinkedIn profile data integration. No video placements. Self-serve negative keywords in open beta (Feb 2026)
+- **Scheduled imports danger**: Can re-enable paused campaigns silently. Deactivate after initial setup
+- **CTV inventory (2025-2026)**: Netflix, Max, Hulu, Roku, discovery+. 30-second non-skippable on CTV
+- **Auto-generated RSA (Jan 2026)**: Enabled by default globally. 5% CTR increase
+- **Smart Shopping to PMax (Aug 2025)**: All Smart Shopping auto-upgraded
+- **Copilot ads**: Show beneath AI responses with "Sponsored" labels in Copilot conversations
+- **9:16 vertical video (Apr 2025)**: 90-second duration support added

package/stacks/_shared/ads-agents/references/microsoft-creative-specs.md

@@ -0,0 +1,123 @@
+# Microsoft Creative Specs: Generation Guide
+
+<!-- Updated: 2026-03-12 -->
+<!-- Source: platform-specs.md + Microsoft Advertising requirements -->
+<!-- Used by: ads-generate, visual-designer agent -->
+
+## Purpose
+
+Generation-ready specifications for Microsoft (Bing) Ads creative. Microsoft creative
+is largely a subset of Google creative; most Google assets can be reused directly.
+The unique format is the Multimedia Ad.
+
+---
+
+## Multimedia Ads (Microsoft-Unique)
+
+The primary image-based format unique to Microsoft Ads.
+
+| Component | Spec |
+|-----------|------|
+| Image | 1200×628 (1.91:1) |
+| Short Headline | 30 chars |
+| Long Headline | 90 chars |
+| Description | 90 chars |
+| Business Name | 25 chars |
+
+**Generation target: 1200×628 (1.91:1)**
+This is the only unique image dimension for Microsoft. Everything else mirrors Google.
+
+---
+
+## Responsive Search Ads (RSA)
+
+Identical to Google RSA character limits:
+
+| Component | Min | Max | Character Limit |
+|-----------|-----|-----|-----------------|
+| Headlines | 3 | 15 | 30 chars each |
+| Descriptions | 2 | 4 | 90 chars each |
+| Display Paths | N/A | 2 | 15 chars each |
+
+**Asset reuse:** RSA copy written for Google can be used directly in Microsoft
+with no changes. Use the same headlines and descriptions.
+
+---
+
+## Audience Ads (Display Network)
+
+| Size | Dimensions |
+|------|-----------|
+| Landscape | 1200×628 (1.91:1) |
+| Square | 1200×1200 (1:1) |
+| Small square | 628×628 (1:1) |
+
+These display on the Microsoft Audience Network (MSN, Outlook, Edge).
+**Asset reuse:** Generate the same 3 Google Display assets (1200×628, 1200×1200, and
+960×1200 scaled to 628×628). No unique generation needed.
+
+---
+
+## Microsoft-Unique Extensions
+
+These require copy but no image generation:
+
+| Extension | Description |
+|-----------|-------------|
+| Action Extension | Pre-defined action buttons (Book Now, Download, etc.) |
+| Filter Link Extension | Category-based deep links (e.g., product categories) |
+| Review Extension | Third-party review quotes with source attribution |
+
+---
+
+## Copilot Ad Integration (2025-2026)
+
+Microsoft Ads now surface in Bing/Copilot AI responses. This affects:
+- **Ad copy relevance**: Copilot reads headline + description for context matching
+- **Sitelinks**: More likely to be shown in AI responses than on traditional SERPs
+- **Image assets**: Multimedia Ad images may appear in Copilot responses
+
+**Generation implication:** Use clear, descriptive product language in image alt context.
+Generate images that visually communicate the product/service without requiring copy.
+
+---
+
+## Google Import Strategy
+
+Most advertisers import Google campaigns to Microsoft. After import:
+- Bid adjustment: Microsoft CPCs are typically 20-35% lower than Google
+- Image assets: All Google PMax images (1200×628, 1200×1200, 960×1200) import directly
+- No additional image generation needed for Microsoft-only
+
+**When to generate Microsoft-specific assets:**
+- Multimedia Ads (1200×628) if not using Google import
+- Custom copy for Copilot-optimized RSA headlines
+
+---
+
+## Image Generation Prompt Modifiers
+
+**For Multimedia Ads (1200×628):**
+- `"horizontal composition, 1.91:1 aspect ratio"`
+- `"clean professional background"`
+- `"Microsoft Bing search audience; professional, trustworthy aesthetic"`
+- `"product or service clearly visible"`
+
+**Tone guidance:** Microsoft's audience skews slightly older (35+) and more professional
+than Google Search. Apply a slightly more conservative, trust-signaling visual style.
+Avoid TikTok-style dramatic edits or Meta-style casual lifestyle photography.
+
+---
+
+## Asset Reuse Summary
+
+| Source | Reusable for Microsoft? |
+|--------|------------------------|
+| Google PMax 1200×628 | ✅ Direct reuse for Multimedia Ads |
+| Google PMax 1200×1200 | ✅ Direct reuse for Audience Ads |
+| Google RSA copy | ✅ Use as-is |
+| Meta 4:5 (1080×1350) | ❌ Wrong ratio |
+| TikTok 9:16 (1080×1920) | ❌ Wrong ratio |
+
+**When using Google import:** No new image generation needed for Microsoft.
+Generate Microsoft-specific assets only if running Microsoft-native campaigns.

package/stacks/_shared/ads-agents/references/platform-specs.md

@@ -0,0 +1,276 @@
+# Platform Creative Specifications
+
+<!-- Updated: 2026-05-14 | v1.6 -->
+<!-- Sources: Google Research PDF 3, Claude Research, 2026 Platform Research, 2026 Verification Pass -->
+
+## Google Ads
+
+### Responsive Search Ads (RSA)
+| Component | Min | Max | Char Limit |
+|-----------|-----|-----|------------|
+| Headlines | 3 | 15 | 30 chars each |
+| Descriptions | 2 | 4 | 90 chars each |
+| Display Paths | N/A | 2 | 15 chars each |
+| Final URL | 1 | 1 | Required |
+
+Best practice: 8-10 headlines, 2-3 descriptions (Claude), 12-15 for Excellent (Google).
+
+**Pinning Rules:**
+- Pin 1 headline to Position 1 (brand/main keyword)
+- Pin 1 headline to Position 2 (secondary angle)
+- Each pinned position: provide 2-3 variants
+- Leave Position 3 unpinned
+- Never pin all positions (kills Ad Strength)
+
+**Dynamic Insertion:**
+```
+{KeyWord:Default Text}              # Keyword insertion
+{COUNTDOWN(YYYY/MM/DD HH:MM:SS)}   # Countdown timer
+{LOCATION(City)}                    # Location insertion
+{CUSTOMIZER.attribute:default}      # Ad customizer
+```
+
+### Performance Max Asset Groups
+| Asset Type | Spec | Max Per Group |
+|-----------|------|---------------|
+| Marketing Image | 1200×628 (1.91:1) | 20 total |
+| Square Image | 1200×1200 (1:1) | (in 20) |
+| Portrait Image | 960×1200 (4:5) | (in 20) |
+| Logo (landscape) | 1200×300 (4:1) | 5 total |
+| Logo (square) | 1200×1200 (1:1) | (in 5) |
+| Video (landscape) | 1920×1080 (16:9) | 5 total |
+| Video (square) | 1080×1080 (1:1) | (in 5) |
+| Video (vertical) | 1080×1920 (9:16) | 5 vertical |
+| Headlines | 30 chars | 5 |
+| Long Headlines | 90 chars | 5 |
+| Descriptions | 90 chars | 5 |
+| Short Description | 60 chars | 1 |
+| Business Name | 25 chars | 1 |
+
+**Image:** Min 128×128, max 5120×5120, max 5MB, JPG/PNG
+**Video:** Min 10s, rec 60s, min 480p, rec 1080p+, MP4/MOV, max 256MB
+
+### YouTube Ad Formats
+| Format | Ratio | Resolution | Duration | Skip |
+|--------|-------|-----------|----------|------|
+| Skippable In-Stream | 16:9 | 1920×1080 | 12s-3min (rec 15-30s) | After 5s |
+| Non-Skippable | 16:9 | 1920×1080 | 15-60s (expanded 2025) | No |
+| Bumper | 16:9 | 1920×1080 | ≤6s | No |
+| In-Feed | 16:9 | 1920×1080 | Any | N/A |
+| YouTube Shorts | 9:16 | 1080×1920 | ≤60s | Swipe |
+
+**YouTube Shorts Safe Zone:** Center 1080×1420px. Bottom 480px = UI overlay.
+**Shorts CTA timing:** CTA button appears at **3 seconds** for PMax/App/Demand Gen campaigns, **10 seconds** for Video View/Reach campaigns. Music/voiceover increases conversions by 20%+.
+
+### Google Extensions / Assets
+| Type | Char Limit | Max Count | Notes |
+|------|-----------|-----------|-------|
+| Sitelink | 25 text, 35 desc ×2 | 20 | Min 4 rec; +3.5% conv with 6 |
+| Callout | 25 chars | 20 | Min 4 rec |
+| Structured Snippet | 25 chars | 2 sets | Predefined headers |
+| Image | 1:1 or 1.91:1 | 20 | Min 1MB |
+| Call | Phone number | 1 | With call tracking |
+| Lead Form | 30 headline, 200 desc | 1 | Privacy URL required |
+| Price | 25 header, 25 desc | 8 items | Min 3 |
+| Promotion | 20 item | 1 | Schedulable |
+
+### Ad Strength Scoring
+- Headline uniqueness (Levenshtein distance)
+- Keyword inclusion in headlines
+- 3-7 headlines = Poor/Average, 8-10 = Good, 11-15 = Excellent
+- "Excellent" → ~12-15% more conversions (diagnostic, not direct factor)
+
+---
+
+## Meta Ads
+
+### Image Specs
+| Placement | Ratio | Size | Max |
+|-----------|-------|------|-----|
+| Feed (preferred) | 4:5 | 1080×1350 | 30MB |
+| Feed (supported) | 1:1 | 1080×1080 | 30MB |
+| Stories/Reels | 9:16 | 1080×1920 | 30MB |
+| Right Column | 1:1 | 1080×1080 | 30MB |
+| Min width: 600px (1080px rec). No hard 20% text rule but AI penalizes heavy text.
+
+### Video Specs
+| Placement | Ratio | Resolution | Max Duration | Max Size |
+|-----------|-------|-----------|-------------|----------|
+| Feed | 4:5 (pref) | 1080×1350 | 241 min | 4GB |
+| Feed | 1:1 | 1080×1080 | 241 min | 4GB |
+| Stories | 9:16 | 1080×1920 | 120s | 4GB |
+| Reels | 9:16 | 1080×1920 | 90s (rec 15-30s) | 4GB |
+| In-Stream | 16:9 | 1920×1080 | 15 min | 4GB |
+
+**Reels Safe Zone:** Center 1080×1300px. Bottom 35% (~670px) = CTA, caption, reactions.
+
+### Text Limits
+| Component | Recommended | Max |
+|-----------|------------|-----|
+| Primary Text | 125 chars | 2200 |
+| Headline | 27-40 chars | N/A |
+| Description | 20 chars (carousel) | N/A |
+| Reels Primary | 72 chars | N/A |
+
+### Carousel
+- 2-10 cards, all 1:1 (1080×1080)
+- Per card: Headline 40 chars, Description 20 chars
+- Unique URL per card supported
+
+### Advantage+ Creative Enhancements
+Auto-adjustments when enabled: brightness/contrast, art filters, aspect ratio crops, music addition, text variations, video from static images. Test via A/B split.
+
+### Quality Rankings
+Three signals: Quality Ranking, Engagement Rate Ranking, Conversion Rate Ranking.
+Rated: Above Average / Average / Below Average (10th, 35th, 55th percentile).
+
+---
+
+## TikTok Ads
+
+### Video Specs
+| Type | Min Resolution | Duration | Max Size | Min Bitrate |
+|------|---------------|----------|----------|-------------|
+| In-Feed (Non-Spark) | 540×960 (9:16) | 5-60s | 500MB | 516kbps |
+| Spark Ads | Organic specs | Organic | N/A | N/A |
+| TopView | 720×1280 (9:16) | 5-60s | 500MB | 2500kbps |
+| Brand Takeover | 720×1280 | 3-5s | 2MB img / 500MB vid | N/A |
+
+Recommended: 1080×1920, MP4/MOV, H.264, audio required, captions required.
+
+### TikTok Safe Zone
+```
+Top:    0-150px   → Status bar, account info
+Right:  0-140px   → Like, comment, share, profile
+Bottom: 0-450px   → Caption, music, CTA, nav bar
+
+SAFE BOX: X:40-940px, Y:150-1470px (900×1320px)
+```
+All critical text, logos, CTAs MUST be within safe box.
+**Video Shopping Ads (VSA):** Increase bottom clearance to **450px** for product card overlay. Safe box becomes X:40-940px, Y:150-1320px.
+
+### Smart+ Specs
+- Up to 30 ad groups per campaign
+- Up to 50 creatives per asset group
+- Symphony AI auto-generates variations
+
+---
+
+## LinkedIn Ads
+
+### Single Image
+| Component | Spec |
+|-----------|------|
+| Image (landscape) | 1200×627 (1.91:1) |
+| Image (square) | 1080×1080 (1:1): better engagement |
+| Max file | 5MB, PNG/JPG |
+| Intro text | 150 chars rec / 600 max |
+| Headline | 70 chars rec / 200 max |
+| Description | 100 chars (desktop only) |
+| CTA Button | Predefined list |
+
+### Video
+| Component | Spec |
+|-----------|------|
+| Format | MP4 required |
+| Size | 75KB - 500MB |
+| Duration | 3s - 30min (rec 15-30s) |
+| Resolution | 360p min (720p+ rec) |
+| Aspect Ratios | 16:9 (landscape), 1:1 (square), 9:16 (mobile only) |
+
+### Document Ads
+- PDF, DOC, DOCX, PPT, PPTX
+- 100MB max, 300 pages max (10-20 rec)
+
+### Messaging
+| Type | Component | Limit |
+|------|-----------|-------|
+| Message Ad | Subject | 60 chars |
+| Message Ad | Body | 1,500 chars |
+| Message Ad | CTA | 20 chars |
+| Conversation Ad | Intro | 500 chars |
+| Conversation Ad | CTA buttons | 5 max, 25 chars each |
+
+### Audience Requirements
+- Minimum: 500 members for delivery
+- Recommended: 50,000-300,000
+- Predictive Audiences seed: 300+ members
+- Company list upload: up to 300,000
+
+---
+
+## Microsoft Ads
+
+### RSA (mirrors Google)
+| Component | Limit |
+|-----------|-------|
+| Headlines | 3-15, 30 chars each |
+| Descriptions | 2-4, 90 chars each |
+| Display Paths | 2, 15 chars each |
+
+### Multimedia Ads (unique)
+| Component | Spec |
+|-----------|------|
+| Image | 1200×628 (1.91:1) |
+| Short Headline | 30 chars |
+| Long Headline | 90 chars |
+| Description | 90 chars |
+| Business Name | 25 chars |
+
+### Video Ads (v1.5, April 2025+)
+| Format | Ratio | Resolution | Duration | Notes |
+|--------|-------|-----------|----------|-------|
+| Vertical Video | 9:16 | 1080×1920 | Up to 90s | Added April 2025 |
+| Horizontal Video | 16:9 | 1920×1080 | Up to 90s | Standard |
+| Square Video | 1:1 | 1080×1080 | Up to 90s | Audience Network |
+| CTV Non-Skippable | 16:9 | 1920×1080 | 30s | Netflix, Max, Hulu, Roku, discovery+ |
+
+**Copilot Image Animation (Nov 2025 pilot):** Converts static images to video assets automatically.
+
+### Microsoft-Unique Extensions
+| Extension | Description |
+|-----------|-------------|
+| Action Extension | Predefined action buttons |
+| Filter Link Extension | Category-based deep links |
+| Review Extension | Third-party review quotes |
+
+---
+
+## Cross-Platform Standards
+
+### Universal Safe Zone (Vertical Video)
+For content running across TikTok + Reels + Shorts + Stories:
+```
+Safe intersection: 900×1000px center
+X: 40-940px (900px wide)
+Y: 450-1450px (1000px tall)
+```
+
+### Character Normalization
+| Component | Safe Limit | Strictest Platform |
+|-----------|-----------|-------------------|
+| Short headline | 30 chars | Google/Microsoft RSA |
+| Long headline | 70 chars | LinkedIn recommended |
+| Primary description | 90 chars | Google/Microsoft RSA |
+| Short description | 25 chars | Extension callouts |
+
+### Video Encoding Standard
+| Component | Recommended |
+|-----------|-------------|
+| Video codec | H.264 High Profile |
+| Audio codec | AAC |
+| Audio level | -14 LUFS |
+| Container | MP4 |
+| Frame rate | 30fps |
+| Color space | Rec. 709 |
+| Bitrate (1080p) | 8-12 Mbps |
+
+### Aspect Ratio Master Chart
+| Ratio | Dimensions | Used By |
+|-------|-----------|---------|
+| 16:9 | 1920×1080 | YouTube, Google Display, LinkedIn Landscape |
+| 9:16 | 1080×1920 | TikTok, Reels, Shorts, Stories |
+| 4:5 | 1080×1350 | Meta Feed (preferred) |
+| 1:1 | 1080×1080 | Meta Feed, LinkedIn, Carousel |
+| 1.91:1 | 1200×628 | Google PMax, LinkedIn Single Image |
+| 4:1 | 1200×300 | Google Logo (landscape) |