start-vibing-stacks 2.29.0 → 2.30.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/setup.js +15 -1
- package/package.json +1 -1
- package/stacks/_shared/ads-agents/README.md +452 -0
- package/stacks/_shared/ads-agents/RESEARCH-REPORT.md +157 -0
- package/stacks/_shared/ads-agents/SKILL.md +210 -0
- package/stacks/_shared/ads-agents/SKILLS-UPDATE-REPORT.md +255 -0
- package/stacks/_shared/ads-agents/agents/audit-budget.md +116 -0
- package/stacks/_shared/ads-agents/agents/audit-compliance.md +131 -0
- package/stacks/_shared/ads-agents/agents/audit-creative.md +127 -0
- package/stacks/_shared/ads-agents/agents/audit-google.md +113 -0
- package/stacks/_shared/ads-agents/agents/audit-meta.md +112 -0
- package/stacks/_shared/ads-agents/agents/audit-tracking.md +134 -0
- package/stacks/_shared/ads-agents/agents/copy-writer.md +188 -0
- package/stacks/_shared/ads-agents/agents/creative-strategist.md +199 -0
- package/stacks/_shared/ads-agents/agents/format-adapter.md +175 -0
- package/stacks/_shared/ads-agents/agents/visual-designer.md +245 -0
- package/stacks/_shared/ads-agents/references/additional-platforms.md +106 -0
- package/stacks/_shared/ads-agents/references/benchmarks.md +257 -0
- package/stacks/_shared/ads-agents/references/bidding-strategies.md +333 -0
- package/stacks/_shared/ads-agents/references/brand-dna-template.md +190 -0
- package/stacks/_shared/ads-agents/references/budget-allocation.md +150 -0
- package/stacks/_shared/ads-agents/references/compliance.md +280 -0
- package/stacks/_shared/ads-agents/references/conversion-tracking.md +246 -0
- package/stacks/_shared/ads-agents/references/copy-frameworks.md +187 -0
- package/stacks/_shared/ads-agents/references/funnel-content-copy-rules.md +44 -0
- package/stacks/_shared/ads-agents/references/gaql-notes.md +49 -0
- package/stacks/_shared/ads-agents/references/google-audit.md +217 -0
- package/stacks/_shared/ads-agents/references/google-creative-specs.md +119 -0
- package/stacks/_shared/ads-agents/references/image-providers.md +133 -0
- package/stacks/_shared/ads-agents/references/linkedin-audit.md +141 -0
- package/stacks/_shared/ads-agents/references/linkedin-creative-specs.md +129 -0
- package/stacks/_shared/ads-agents/references/mcp-integration.md +125 -0
- package/stacks/_shared/ads-agents/references/meta-audit.md +141 -0
- package/stacks/_shared/ads-agents/references/meta-creative-specs.md +134 -0
- package/stacks/_shared/ads-agents/references/microsoft-audit.md +158 -0
- package/stacks/_shared/ads-agents/references/microsoft-creative-specs.md +123 -0
- package/stacks/_shared/ads-agents/references/platform-specs.md +276 -0
- package/stacks/_shared/ads-agents/references/scoring-system.md +169 -0
- package/stacks/_shared/ads-agents/references/tiktok-audit.md +165 -0
- package/stacks/_shared/ads-agents/references/tiktok-creative-specs.md +139 -0
- package/stacks/_shared/ads-agents/references/voice-to-style.md +87 -0
- package/stacks/_shared/ads-agents/references/youtube-creative-specs.md +134 -0
- package/stacks/_shared/ads-agents/skills/ads-apple/SKILL.md +225 -0
- package/stacks/_shared/ads-agents/skills/ads-audit/SKILL.md +108 -0
- package/stacks/_shared/ads-agents/skills/ads-budget/SKILL.md +198 -0
- package/stacks/_shared/ads-agents/skills/ads-competitor/SKILL.md +198 -0
- package/stacks/_shared/ads-agents/skills/ads-create/SKILL.md +198 -0
- package/stacks/_shared/ads-agents/skills/ads-creative/SKILL.md +208 -0
- package/stacks/_shared/ads-agents/skills/ads-dna/SKILL.md +245 -0
- package/stacks/_shared/ads-agents/skills/ads-generate/SKILL.md +173 -0
- package/stacks/_shared/ads-agents/skills/ads-google/SKILL.md +192 -0
- package/stacks/_shared/ads-agents/skills/ads-landing/SKILL.md +186 -0
- package/stacks/_shared/ads-agents/skills/ads-linkedin/SKILL.md +200 -0
- package/stacks/_shared/ads-agents/skills/ads-math/SKILL.md +216 -0
- package/stacks/_shared/ads-agents/skills/ads-meta/SKILL.md +167 -0
- package/stacks/_shared/ads-agents/skills/ads-microsoft/SKILL.md +163 -0
- package/stacks/_shared/ads-agents/skills/ads-photoshoot/SKILL.md +220 -0
- package/stacks/_shared/ads-agents/skills/ads-plan/SKILL.md +176 -0
- package/stacks/_shared/ads-agents/skills/ads-test/SKILL.md +199 -0
- package/stacks/_shared/ads-agents/skills/ads-tiktok/SKILL.md +190 -0
- package/stacks/_shared/ads-agents/skills/ads-youtube/SKILL.md +199 -0
- package/stacks/_shared/memories/funnel-content-copy.md +81 -0
- package/templates/CLAUDE-python.md +6 -0
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ads-meta
|
|
3
|
+
version: 1.6.0
|
|
4
|
+
description: "Meta Ads deep analysis covering Facebook and Instagram advertising. Evaluates 50 checks across Pixel/CAPI health, creative diversity and fatigue, account structure, and audience targeting. Includes Advantage+ assessment. Use when user says Meta Ads, Facebook Ads, Instagram Ads, Advantage+, or Meta campaign."
|
|
5
|
+
user-invokable: false
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
<!-- Updated: 2026-05-14 | v1.6: Andromeda 2026 playbook (8-12 concepts × 2-3 variations, similarity <40%, 2-3 week fatigue, 20+ tests/month), Advantage+ creative 22% ROAS lift, single-ad-set consolidation -->
|
|
9
|
+
|
|
10
|
+
# Meta Ads Deep Analysis
|
|
11
|
+
|
|
12
|
+
## Andromeda AI Engine (2026)
|
|
13
|
+
|
|
14
|
+
Meta's Andromeda AI engine (global rollout complete Oct 2025) filters ads using
|
|
15
|
+
10,000x more complex retrieval models on the NVIDIA Grace Hopper Superchip. Creative
|
|
16
|
+
diversity is now the #1 performance lever, replacing targeting and bidding as the
|
|
17
|
+
primary optimization surface.
|
|
18
|
+
|
|
19
|
+
**Similarity Score thresholds (2026 verified):**
|
|
20
|
+
- **>60%** = retrieval suppression (ads collapsed under one Entity ID, compete with each other)
|
|
21
|
+
- **<40%** = recommended target across active assets (treated as distinct candidates)
|
|
22
|
+
- 100 minor variations (color swaps, text tweaks on same template) perform no better than 10 genuinely distinct concepts
|
|
23
|
+
|
|
24
|
+
**Creative volume reality (2026 data):**
|
|
25
|
+
- Top third of advertisers run ~395 live ads at any time; bottom third runs ~296 (33% gap)
|
|
26
|
+
- Brands testing 20+ new ads/month see 65% higher ROAS than brands testing <10
|
|
27
|
+
- Andromeda-aligned structures deliver 20-35% higher ROAS than legacy structures
|
|
28
|
+
- Advantage+ creative drives 22% ROAS lift over manual creative setups
|
|
29
|
+
- One ad set with 25 diverse creatives outperformed five ad sets with five each by 17% on conversions, 16% on cost
|
|
30
|
+
|
|
31
|
+
**The 2026 creative system (recommended workflow):**
|
|
32
|
+
1. Build **8-12 conceptually distinct concepts** per campaign (different hooks, formats, emotional triggers, visual treatments)
|
|
33
|
+
2. Produce **2-3 variations per concept** (the variations must differ on visual/audio/structural levels Andromeda actually parses, not just headline swaps)
|
|
34
|
+
3. Refresh on **2-3 week cycle** (fatigue window has shrunk from 6+ weeks pre-Andromeda)
|
|
35
|
+
4. Consolidate into fewer ad sets with more creatives (algorithm performs best when not fragmented)
|
|
36
|
+
5. Mix high-production brand assets with native UGC/founder-led content; neither alone wins
|
|
37
|
+
|
|
38
|
+
## Process
|
|
39
|
+
|
|
40
|
+
1. Collect Meta Ads data (Ads Manager export, Events Manager screenshot, EMQ scores)
|
|
41
|
+
2. Read `ads-agents/references/meta-audit.md` for full 50-check audit
|
|
42
|
+
3. Read `ads-agents/references/benchmarks.md` for Meta-specific benchmarks
|
|
43
|
+
4. Read `ads-agents/references/scoring-system.md` for weighted scoring
|
|
44
|
+
5. Evaluate all applicable checks as PASS, WARNING, or FAIL
|
|
45
|
+
6. Calculate Meta Ads Health Score (0-100)
|
|
46
|
+
7. Generate findings report with action plan
|
|
47
|
+
|
|
48
|
+
## What to Analyze
|
|
49
|
+
|
|
50
|
+
### Pixel / CAPI Health (30% weight)
|
|
51
|
+
- Meta Pixel installed and firing on all pages
|
|
52
|
+
- Conversions API (CAPI) active (30-40% data loss without it post-iOS 14.5)
|
|
53
|
+
- Event deduplication configured (event_id matching, ≥90% dedup rate)
|
|
54
|
+
- Event Match Quality (EMQ) ≥8.0 for Purchase event
|
|
55
|
+
- All standard events configured (ViewContent, AddToCart, Purchase, Lead)
|
|
56
|
+
- Custom conversions created for non-standard events
|
|
57
|
+
- Aggregated Event Measurement (AEM) configured for iOS
|
|
58
|
+
- Domain verification completed
|
|
59
|
+
- Server-side events include customer_information parameters
|
|
60
|
+
- Pixel fires with correct currency and value parameters
|
|
61
|
+
|
|
62
|
+
### Creative (30% weight)
|
|
63
|
+
- ≥3 creative formats active (image, video, carousel, collection)
|
|
64
|
+
- ≥5 creatives per ad set baseline; **target 8-12 distinct concepts** per campaign with 2-3 variations each (Andromeda 2026 standard)
|
|
65
|
+
- Creative fatigue detection: CTR drop >10% week-over-week OR >20% over 14 days = FAIL (Andromeda fatigue window: 2-3 weeks, down from 6+)
|
|
66
|
+
- Video creative: 15s max for Stories/Reels, 30s max for Feed
|
|
67
|
+
- UGC/testimonial creative tested AND mixed with polished brand assets (both belong in rotation)
|
|
68
|
+
- Advantage+ Creative enhancements enabled (drives ~22% ROAS lift over manual)
|
|
69
|
+
- Ad copy: headline under 40 chars, primary text under 125 chars
|
|
70
|
+
- Creative refresh cadence: every 2-3 weeks for high-spend (>$5K/month → 5-15 new creatives/week)
|
|
71
|
+
- Creative Similarity Score <40% across active ads (>60% triggers retrieval suppression)
|
|
72
|
+
|
|
73
|
+
### Account Structure (20% weight)
|
|
74
|
+
- Campaign Budget Optimization (CBO) vs Ad Set Budget (ABO) intentional
|
|
75
|
+
- Campaign consolidation: 1-3 campaigns total recommended
|
|
76
|
+
- Learning phase health: <30% ad sets in "Learning Limited" (FAIL >50%)
|
|
77
|
+
- Budget per ad set: ≥5x target CPA (minimum for learning phase exit)
|
|
78
|
+
- Ad set audience overlap <30% (Audience Overlap tool)
|
|
79
|
+
- Campaign naming conventions consistent and descriptive
|
|
80
|
+
- Advantage+ Sales Campaigns active for e-commerce
|
|
81
|
+
- Simplified campaign structure: 1-3 campaigns total (fewer, larger ad sets preferred)
|
|
82
|
+
|
|
83
|
+
### Audience & Targeting (20% weight)
|
|
84
|
+
- Prospecting frequency (7-day): <3.0 (WARNING 3-5, FAIL >5)
|
|
85
|
+
- Retargeting frequency (7-day): <8.0 (WARNING 8-12, FAIL >12)
|
|
86
|
+
- Custom Audiences: website visitors, customer lists, engagement
|
|
87
|
+
- Lookalike Audiences: multiple seed sizes tested (1%, 3%, 5%)
|
|
88
|
+
- Advantage+ Audience tested vs manual targeting
|
|
89
|
+
- Interest targeting: broad enough for algorithm optimization
|
|
90
|
+
- Exclusions: purchasers excluded from prospecting, overlap managed
|
|
91
|
+
- Location targeting reviewed for relevance
|
|
92
|
+
|
|
93
|
+
## Advantage+ Assessment
|
|
94
|
+
|
|
95
|
+
If Advantage+ features are in use:
|
|
96
|
+
- **Advantage+ Sales Campaigns**: catalog connected, existing customer cap set
|
|
97
|
+
- **Advantage+ Audience**: performance vs manual audience compared
|
|
98
|
+
- **Advantage+ Creative**: enhancements enabled (text, brightness, music)
|
|
99
|
+
- **Advantage+ Placements**: enabled (let Meta optimize placement mix)
|
|
100
|
+
- **Budget allocation**: Advantage+ campaigns getting fair test budget
|
|
101
|
+
|
|
102
|
+
## Special Ad Categories
|
|
103
|
+
|
|
104
|
+
If ads are in restricted categories:
|
|
105
|
+
- Special Ad Category declared before campaign creation
|
|
106
|
+
- Targeting restrictions verified (no ZIP, age 18-65+ only, no Lookalike)
|
|
107
|
+
- Creative compliance with category-specific policies
|
|
108
|
+
- Read `ads-agents/references/compliance.md` for full requirements
|
|
109
|
+
|
|
110
|
+
## EMQ Optimization Guide
|
|
111
|
+
|
|
112
|
+
| EMQ Score | Status | Action |
|
|
113
|
+
|-----------|--------|--------|
|
|
114
|
+
| 8.0-10.0 | Excellent | Maintain current setup |
|
|
115
|
+
| 6.0-7.9 | Good | Add more customer_information parameters |
|
|
116
|
+
| 4.0-5.9 | Fair | Implement CAPI, improve data quality |
|
|
117
|
+
| <4.0 | Poor | Critical: CAPI + Enhanced Matching required |
|
|
118
|
+
|
|
119
|
+
Key parameters to maximize EMQ:
|
|
120
|
+
- `em` (email): highest match rate signal
|
|
121
|
+
- `ph` (phone): second highest match signal
|
|
122
|
+
- `fn`, `ln` (first/last name): improves match accuracy
|
|
123
|
+
- `ct`, `st`, `zp` (city, state, zip): geographic matching
|
|
124
|
+
- `external_id`: CRM/user ID for cross-device matching
|
|
125
|
+
|
|
126
|
+
## Key Thresholds
|
|
127
|
+
|
|
128
|
+
| Metric | Pass | Warning | Fail |
|
|
129
|
+
|--------|------|---------|------|
|
|
130
|
+
| EMQ (Purchase) | ≥8.0 | 6.0-7.9 | <6.0 |
|
|
131
|
+
| Dedup rate | ≥90% | 70-90% | <70% |
|
|
132
|
+
| CTR | ≥1.0% | 0.5-1.0% | <0.5% |
|
|
133
|
+
| Creative formats | ≥3 | 2 | 1 |
|
|
134
|
+
| Creatives per ad set | ≥5 (target 8-12 distinct concepts × 2-3 variations per campaign) | 3-4 | <3 |
|
|
135
|
+
| Distinct concepts (Andromeda) | ≥10 genuinely distinct | 5-9 | <5 |
|
|
136
|
+
| Creative Similarity Score | <40% | 40-60% | >60% (suppression) |
|
|
137
|
+
| Fatigue: CTR WoW drop | <10% | 10-20% | >20% (kill) |
|
|
138
|
+
| Learning Limited | <30% | 30-50% | >50% |
|
|
139
|
+
| Budget per ad set | ≥5x CPA | 2-5x CPA | <2x CPA |
|
|
140
|
+
|
|
141
|
+
## Output
|
|
142
|
+
|
|
143
|
+
### Meta Ads Health Score
|
|
144
|
+
|
|
145
|
+
```
|
|
146
|
+
Meta Ads Health Score: XX/100 (Grade: X)
|
|
147
|
+
|
|
148
|
+
Pixel / CAPI Health: XX/100 ████████░░ (30%)
|
|
149
|
+
Creative: XX/100 ██████████ (30%)
|
|
150
|
+
Account Structure: XX/100 ███████░░░ (20%)
|
|
151
|
+
Audience: XX/100 █████░░░░░ (20%)
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
### Deliverables
|
|
155
|
+
- `META-ADS-REPORT.md`: Full 50-check findings with pass/warning/fail
|
|
156
|
+
- EMQ improvement roadmap
|
|
157
|
+
- Creative fatigue alerts (any creative with CTR declining >20%)
|
|
158
|
+
- Quick Wins sorted by impact
|
|
159
|
+
- Advantage+ adoption recommendations
|
|
160
|
+
|
|
161
|
+
## Threads Placement
|
|
162
|
+
|
|
163
|
+
Threads placement GA Jan 2026, 400M+ MAU. Lower CPMs than Feed/Stories.
|
|
164
|
+
Currently ~0.04% of total spend. Emerging channel. Evaluate:
|
|
165
|
+
- Is Threads placement enabled in Advantage+ Placements?
|
|
166
|
+
- Monitor CPM and engagement vs other placements
|
|
167
|
+
- Early-mover advantage for brands with active Threads presence
|
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ads-microsoft
|
|
3
|
+
version: 1.6.0
|
|
4
|
+
description: "Microsoft/Bing Ads deep analysis covering search, Performance Max, Audience Network, and Copilot integration. Evaluates 24 checks with focus on Google import validation, unique Microsoft features, and cost advantage assessment. Use when user says Microsoft Ads, Bing Ads, Bing PPC, Copilot ads, or Microsoft campaign."
|
|
5
|
+
user-invokable: false
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
<!-- Updated: 2026-05-14 | v1.6: Copilot ad lift recalibrated (15-25% verified vs older 73% claim), PMax for Microsoft Advertising 2026 (combines search + Audience Network + Copilot), Copilot 400M+ MAU Q1 2026 -->
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
# Microsoft Ads Deep Analysis
|
|
12
|
+
|
|
13
|
+
## Process
|
|
14
|
+
|
|
15
|
+
1. Collect Microsoft Ads data (account export, UET tag status, import results)
|
|
16
|
+
2. Read `ads-agents/references/microsoft-audit.md` for full 24-check audit
|
|
17
|
+
3. Read `ads-agents/references/benchmarks.md` for Microsoft-specific benchmarks
|
|
18
|
+
4. Read `ads-agents/references/scoring-system.md` for weighted scoring
|
|
19
|
+
5. Evaluate all applicable checks as PASS, WARNING, or FAIL
|
|
20
|
+
6. Calculate Microsoft Ads Health Score (0-100)
|
|
21
|
+
7. Generate findings report with action plan
|
|
22
|
+
|
|
23
|
+
## What to Analyze
|
|
24
|
+
|
|
25
|
+
### Technical Setup (25% weight)
|
|
26
|
+
- UET tag installed and firing on all pages (MS01)
|
|
27
|
+
- Enhanced conversions enabled (MS02)
|
|
28
|
+
- Google Ads import validated: URLs, extensions, bids, goals (MS03)
|
|
29
|
+
|
|
30
|
+
### Syndication & Bidding (20% weight)
|
|
31
|
+
- Search partner network reviewed, low-performers excluded (MS04)
|
|
32
|
+
- Audience Network enabled only if testing intentionally (MS05)
|
|
33
|
+
- Bid targets 20-35% lower than Google (CPC advantage) (MS06)
|
|
34
|
+
- PMax: 300 campaigns/account (vs 100 Google), LinkedIn profile data available, no video support
|
|
35
|
+
- Target New Customers enabled for PMax, Beta 2026 (MS07)
|
|
36
|
+
|
|
37
|
+
### Campaign Structure (20% weight)
|
|
38
|
+
- Campaign structure mirrors Google or follows best practices (MS08)
|
|
39
|
+
- Budget proportional to Bing volume: typically 20-30% of Google (MS09)
|
|
40
|
+
- LinkedIn profile targeting for B2B (unique advantage) (MS10)
|
|
41
|
+
|
|
42
|
+
### Creative & Extensions (20% weight)
|
|
43
|
+
- RSA: ≥8 headlines, ≥3 descriptions (MS11)
|
|
44
|
+
- Multimedia Ads tested (unique rich format) (MS12)
|
|
45
|
+
- Ad copy optimized for Bing demographics (MS13)
|
|
46
|
+
- Action Extension utilized (unique to Microsoft) (MS19)
|
|
47
|
+
- Filter Link Extension tested (MS20)
|
|
48
|
+
|
|
49
|
+
### Settings & Performance (15% weight)
|
|
50
|
+
- Copilot chat placement enabled for PMax: 15-25% CTR lift verified 2026 (MS14)
|
|
51
|
+
- Conversion goals configured natively, not relying on imported (MS15)
|
|
52
|
+
- CPC 20-40% lower than Google for same keywords (MS16)
|
|
53
|
+
- CVR comparable to Google, not >50% lower (MS17)
|
|
54
|
+
- Impression share tracked for brand and top terms (MS18)
|
|
55
|
+
|
|
56
|
+
## Google Import Validation
|
|
57
|
+
|
|
58
|
+
Most Microsoft Ads accounts start as Google Ads imports. Critical validation:
|
|
59
|
+
|
|
60
|
+
### What Transfers Correctly
|
|
61
|
+
- Campaign structure and ad groups
|
|
62
|
+
- Keywords and match types
|
|
63
|
+
- RSA headlines and descriptions
|
|
64
|
+
- Basic bid strategies
|
|
65
|
+
|
|
66
|
+
### What Needs Manual Review
|
|
67
|
+
- **URLs**: verify all landing page URLs are correct post-import
|
|
68
|
+
- **Extensions**: not all Google extensions have Microsoft equivalents
|
|
69
|
+
- **Bid amounts**: should be 20-35% lower (don't import Google bids as-is)
|
|
70
|
+
- **Conversion goals**: re-create natively for better tracking
|
|
71
|
+
- **Audiences**: import may miss segments, verify all are present
|
|
72
|
+
- **Negative keywords**: verify shared negative lists transferred
|
|
73
|
+
|
|
74
|
+
### Import Schedule
|
|
75
|
+
- Auto-import: useful but review changes monthly
|
|
76
|
+
- **Warning:** Scheduled imports can re-enable paused campaigns. Deactivate scheduled imports after initial setup.
|
|
77
|
+
- Manual import: more control, recommended for large accounts
|
|
78
|
+
- Never import without post-import audit
|
|
79
|
+
|
|
80
|
+
## Copilot Integration (2026)
|
|
81
|
+
|
|
82
|
+
Microsoft's AI assistant creates unique ad opportunities. **400M+ MAU on Copilot
|
|
83
|
+
across Microsoft ecosystem as of Q1 2026** (Stackmatix April 2026).
|
|
84
|
+
|
|
85
|
+
### Copilot Chat Ads
|
|
86
|
+
- Available in Performance Max campaigns
|
|
87
|
+
- **Conversational placements deliver 15-25% higher CTR** vs traditional search ads (verified 2026 partner data); the older "73% lift" figure was early closed-beta and should be treated as anecdotal — use 15-25% as the realistic working range
|
|
88
|
+
- Copilot Checkout launched Jan 2026 (in-chat purchase)
|
|
89
|
+
- Natural language ad delivery (conversational context)
|
|
90
|
+
- Copilot ads show beneath AI responses with Sponsored labels
|
|
91
|
+
- Sponsored responses GA across Copilot since 2025
|
|
92
|
+
|
|
93
|
+
### How to Evaluate
|
|
94
|
+
- Is Copilot placement enabled? (If not, HIGH priority for PMax)
|
|
95
|
+
- What % of impressions/clicks come from Copilot?
|
|
96
|
+
- CTR/CVR comparison: Copilot vs traditional placements (expect 15-25% lift, not 73%)
|
|
97
|
+
- Ad copy quality: does it read well in conversational context? Leads with specific benefit (not brand name), second-person language, proof points (numbers/outcomes) that give AI context to surface ad appropriately
|
|
98
|
+
|
|
99
|
+
### PMax for Microsoft Advertising (2026)
|
|
100
|
+
- Combines search + Audience Network + Copilot placements into a single campaign type with automated creative optimization
|
|
101
|
+
- Works best when fed strong first-party conversion data (offline conversions, Enhanced Conversions, CRM imports)
|
|
102
|
+
- LinkedIn profile targeting layered on top remains the unique B2B advantage
|
|
103
|
+
|
|
104
|
+
## Microsoft-Unique Features
|
|
105
|
+
|
|
106
|
+
These features are exclusive to Microsoft Ads; evaluate adoption:
|
|
107
|
+
|
|
108
|
+
| Feature | Description | Priority |
|
|
109
|
+
|---------|-------------|----------|
|
|
110
|
+
| CTV Ads | Netflix, Max, Hulu, Roku, discovery+. 30-second non-skippable. | Medium |
|
|
111
|
+
| Multimedia Ads | Image-rich search ads with visual elements | Medium |
|
|
112
|
+
| Action Extension | CTA button directly in search ad | Medium |
|
|
113
|
+
| Filter Link Extension | Filterable category links in ad | Low |
|
|
114
|
+
| LinkedIn Profile Targeting | Target by company, industry, job function | High (B2B) |
|
|
115
|
+
| Copilot Chat Placement | Ads within Copilot conversations | High |
|
|
116
|
+
| Auto-generated RSA | Enabled by default Jan 2026, 5% CTR increase | Medium |
|
|
117
|
+
| 9:16 Vertical Video | Vertical video ads (Apr 2025), 90-second max duration | Medium |
|
|
118
|
+
|
|
119
|
+
## Bing Demographic Context
|
|
120
|
+
|
|
121
|
+
Microsoft Ads reach a distinct audience:
|
|
122
|
+
- Older demographic (35-65+ over-indexed)
|
|
123
|
+
- Higher household income (top 25% income brackets)
|
|
124
|
+
- Desktop-heavy (Windows default browser = Edge = Bing)
|
|
125
|
+
- Enterprise/corporate users (Office 365 integration)
|
|
126
|
+
|
|
127
|
+
Ad copy optimization for this audience:
|
|
128
|
+
- Professional tone, less casual than Google/Meta
|
|
129
|
+
- Emphasize quality, reliability, premium positioning
|
|
130
|
+
- Desktop-optimized landing pages matter more
|
|
131
|
+
- B2B messaging resonates strongly
|
|
132
|
+
|
|
133
|
+
## Key Thresholds
|
|
134
|
+
|
|
135
|
+
| Metric | Pass | Warning | Fail |
|
|
136
|
+
|--------|------|---------|------|
|
|
137
|
+
| CTR (Search) | ≥2.83% | 1.5-2.83% | <1.5% |
|
|
138
|
+
| CPC (Search) | ≤$1.55 | $1.55-2.50 | >$2.50 |
|
|
139
|
+
| CPC vs Google | 20-40% lower | 10-20% lower | Same or higher |
|
|
140
|
+
| CVR vs Google | Within 20% | 20-50% lower | >50% lower |
|
|
141
|
+
| Impression share (brand) | ≥80% | 60-80% | <60% |
|
|
142
|
+
|
|
143
|
+
## Output
|
|
144
|
+
|
|
145
|
+
### Microsoft Ads Health Score
|
|
146
|
+
|
|
147
|
+
```
|
|
148
|
+
Microsoft Ads Health Score: XX/100 (Grade: X)
|
|
149
|
+
|
|
150
|
+
Technical Setup: XX/100 ████████░░ (25%)
|
|
151
|
+
Syndication: XX/100 ██████████ (20%)
|
|
152
|
+
Structure: XX/100 ███████░░░ (20%)
|
|
153
|
+
Creative: XX/100 █████░░░░░ (20%)
|
|
154
|
+
Settings: XX/100 ████████░░ (15%)
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
### Deliverables
|
|
158
|
+
- `MICROSOFT-ADS-REPORT.md`: Full 24-check findings with pass/warning/fail
|
|
159
|
+
- Google import validation results
|
|
160
|
+
- Copilot integration readiness assessment
|
|
161
|
+
- Cost advantage analysis (CPC savings vs Google)
|
|
162
|
+
- Microsoft-unique feature adoption checklist
|
|
163
|
+
- Quick Wins sorted by impact
|
|
@@ -0,0 +1,220 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ads-photoshoot
|
|
3
|
+
version: 1.5.0
|
|
4
|
+
description: "Product photography enhancement for ad creatives using banana-claude image generation. Takes a product image and generates 5 professional photography styles for ad use: Studio, Floating, Ingredient, In Use, and Lifestyle. Requires banana-claude (v1.4.1+) with nanobanana-mcp. Triggers on: product photo, product photography, photoshoot, enhance product image, product shoot, product photos for ads, generate product photos, studio shot, lifestyle photo."
|
|
5
|
+
user-invokable: false
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Ads Photoshoot: AI Product Photography
|
|
9
|
+
|
|
10
|
+
Transforms a product image or description into professional ad-ready photography
|
|
11
|
+
in 5 distinct visual styles. Each style generates at two sizes: 1:1 (Meta/LinkedIn)
|
|
12
|
+
and 9:16 (TikTok/Reels/Stories).
|
|
13
|
+
|
|
14
|
+
## Quick Reference
|
|
15
|
+
|
|
16
|
+
| Command | What it does |
|
|
17
|
+
|---------|-------------|
|
|
18
|
+
| `/ads photoshoot` | Interactive: ask for product + styles |
|
|
19
|
+
| `/ads photoshoot --styles studio floating` | Generate only selected styles |
|
|
20
|
+
| `/ads photoshoot --product shoe.jpg` | Start with a product image file |
|
|
21
|
+
| `/ads photoshoot --all-platforms` | Generate all 5 sizes per style |
|
|
22
|
+
|
|
23
|
+
## Environment Setup
|
|
24
|
+
|
|
25
|
+
Requires banana-claude (v1.4.1+) with nanobanana-mcp configured.
|
|
26
|
+
Run `/banana setup` to configure API key and MCP.
|
|
27
|
+
|
|
28
|
+
## Process
|
|
29
|
+
|
|
30
|
+
### Step 1: Collect Product Information
|
|
31
|
+
|
|
32
|
+
Ask (combine into one message):
|
|
33
|
+
1. **Product image**: Path to product image file (local) OR product URL OR text description
|
|
34
|
+
> "Provide a product image path (e.g. ./product.jpg), a URL, or describe your product"
|
|
35
|
+
2. **Product description**: What is it? Key features to highlight? (helps prompt quality)
|
|
36
|
+
3. **Styles to generate**: Which of the 5 styles? (default: all 5)
|
|
37
|
+
- Studio, Floating, Ingredient, In Use, Lifestyle
|
|
38
|
+
4. **Target platforms**: Which platforms will these run on?
|
|
39
|
+
- Determines output sizes (default: Meta + TikTok → 1:1 + 9:16)
|
|
40
|
+
|
|
41
|
+
### Step 2: Load Brand Profile (Optional)
|
|
42
|
+
|
|
43
|
+
Check for `brand-profile.json` in the current directory.
|
|
44
|
+
|
|
45
|
+
If found, extract for style injection:
|
|
46
|
+
- `colors.primary` → inject into backgrounds and accent elements
|
|
47
|
+
- `aesthetic.mood_keywords` → inject as atmosphere descriptors
|
|
48
|
+
- `target_audience` → use for Lifestyle and In Use context
|
|
49
|
+
- `imagery.forbidden` → exclude from all prompts
|
|
50
|
+
|
|
51
|
+
If not found, proceed with standard style templates.
|
|
52
|
+
|
|
53
|
+
### Step 3: Verify banana-claude
|
|
54
|
+
|
|
55
|
+
Verify banana-claude is installed (run `/banana setup` to check). If not installed,
|
|
56
|
+
display setup instructions and exit.
|
|
57
|
+
|
|
58
|
+
### Step 4: Construct Prompts per Style
|
|
59
|
+
|
|
60
|
+
For each selected style, build the prompt using the template + product description + brand DNA.
|
|
61
|
+
|
|
62
|
+
#### Style 1: Studio
|
|
63
|
+
Clean, e-commerce style product shot.
|
|
64
|
+
|
|
65
|
+
**Base template:**
|
|
66
|
+
```
|
|
67
|
+
"[product description], professional product photography, clean white seamless
|
|
68
|
+
background, even studio lighting, soft drop shadow, high detail product focus,
|
|
69
|
+
ecommerce style, [brand.colors.primary] subtle accent reflections if applicable,
|
|
70
|
+
top-down or 3/4 angle, no distractions, catalog quality"
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
**Composition:** Centered, slight 3/4 angle or flat lay.
|
|
74
|
+
**Output sizes:** 1080×1080, 1080×1920
|
|
75
|
+
|
|
76
|
+
#### Style 2: Floating
|
|
77
|
+
Dramatic levitation effect.
|
|
78
|
+
|
|
79
|
+
**Base template:**
|
|
80
|
+
```
|
|
81
|
+
"[product description] floating in mid-air, dramatic floating product shot,
|
|
82
|
+
[brand.colors.primary or brand.aesthetic.mood_keywords[0]] gradient background,
|
|
83
|
+
atmospheric shadow below product, levitation effect, product defying gravity,
|
|
84
|
+
clean modern aesthetic, high contrast, striking visual"
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
**Composition:** Product centered vertically, ample space above and below.
|
|
88
|
+
**Output sizes:** 1080×1080, 1080×1920
|
|
89
|
+
|
|
90
|
+
#### Style 3: Ingredient
|
|
91
|
+
Flat lay with components.
|
|
92
|
+
|
|
93
|
+
**Base template:**
|
|
94
|
+
```
|
|
95
|
+
"[product description] centered flat lay, surrounded by its key ingredients
|
|
96
|
+
or materials artfully arranged, top-down overhead view, clean light background,
|
|
97
|
+
natural texture surface, product as hero element, ingredients scattered with
|
|
98
|
+
intentional negative space, editorial food photography style"
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
**Composition:** Top-down, product in center, ingredients fanning out.
|
|
102
|
+
**Output sizes:** 1080×1080 (optimal for this style). Also generate 9:16 vertical for TikTok/Reels/Stories placements.
|
|
103
|
+
|
|
104
|
+
#### Style 4: In Use
|
|
105
|
+
Authentic usage context.
|
|
106
|
+
|
|
107
|
+
**Base template:**
|
|
108
|
+
```
|
|
109
|
+
"person's hands using [product description] in natural context, lifestyle
|
|
110
|
+
photography, focus on product-hand interaction, shallow depth of field,
|
|
111
|
+
warm natural window light, authentic not staged, [brand.target_audience.profession]
|
|
112
|
+
implied context, [brand.aesthetic.mood_keywords] atmosphere"
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
**Composition:** Hands prominent, product clearly identifiable, background soft-focus.
|
|
116
|
+
**Note:** Hands only; no full face (avoids model release complications).
|
|
117
|
+
**Output sizes:** 1080×1080, 1080×1920
|
|
118
|
+
|
|
119
|
+
#### Style 5: Lifestyle
|
|
120
|
+
Aspirational full-context shot.
|
|
121
|
+
|
|
122
|
+
**Base template:**
|
|
123
|
+
```
|
|
124
|
+
"[product description] in aspirational lifestyle scene, [brand.target_audience.age_range]
|
|
125
|
+
demographic implied environment, [brand.target_audience.profession] context,
|
|
126
|
+
[brand.aesthetic.mood_keywords] atmosphere, golden hour or clean natural lighting,
|
|
127
|
+
editorial photography style, [brand.aesthetic.negative_space] composition,
|
|
128
|
+
product clearly visible and prominent"
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
**Composition:** Environmental context, product as hero element within the scene.
|
|
132
|
+
**Output sizes:** 1080×1080, 1080×1920
|
|
133
|
+
|
|
134
|
+
### Iterative Refinement
|
|
135
|
+
|
|
136
|
+
For iterative refinement: if initial generation doesn't match brand expectations, adjust the prompt by specifying: lighting direction, color temperature, background texture, or product angle before regenerating.
|
|
137
|
+
|
|
138
|
+
### Step 5: Generate Images
|
|
139
|
+
|
|
140
|
+
**Domain mode selection per style:**
|
|
141
|
+
- Use banana **Product** mode for Studio, Floating, and Ingredient styles
|
|
142
|
+
- Use banana **Editorial** mode for In Use and Lifestyle styles
|
|
143
|
+
- Set resolution to 2K (default) for all generations
|
|
144
|
+
|
|
145
|
+
**Aspect ratio setup:** Use banana MCP `set_aspect_ratio` before each generation:
|
|
146
|
+
- For 1080x1080: set ratio to 1:1
|
|
147
|
+
- For 1080x1920: set ratio to 9:16
|
|
148
|
+
|
|
149
|
+
For each style x size combination, use `/banana generate` with the constructed
|
|
150
|
+
prompt, selected domain mode, and correct aspect ratio. Save output to
|
|
151
|
+
`./product-photos/[style]/[product-slug]-[style]-[WxH].png`.
|
|
152
|
+
|
|
153
|
+
Track results. If a generation fails, retry once with a simplified prompt.
|
|
154
|
+
|
|
155
|
+
### Step 6: Organize and Report
|
|
156
|
+
|
|
157
|
+
**Output directory structure:**
|
|
158
|
+
```
|
|
159
|
+
./product-photos/
|
|
160
|
+
studio/
|
|
161
|
+
product-studio-1080x1080.png
|
|
162
|
+
product-studio-1080x1920.png
|
|
163
|
+
floating/
|
|
164
|
+
product-floating-1080x1080.png
|
|
165
|
+
product-floating-1080x1920.png
|
|
166
|
+
ingredient/
|
|
167
|
+
product-ingredient-1080x1080.png
|
|
168
|
+
product-ingredient-1080x1920.png
|
|
169
|
+
in-use/
|
|
170
|
+
product-in-use-1080x1080.png
|
|
171
|
+
product-in-use-1080x1920.png
|
|
172
|
+
lifestyle/
|
|
173
|
+
product-lifestyle-1080x1080.png
|
|
174
|
+
product-lifestyle-1080x1920.png
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
**Summary:**
|
|
178
|
+
```
|
|
179
|
+
✓ Product photos generated: [N] images
|
|
180
|
+
|
|
181
|
+
Studio: ./product-photos/studio/ (2 sizes)
|
|
182
|
+
Floating: ./product-photos/floating/ (2 sizes)
|
|
183
|
+
Ingredient: ./product-photos/ingredient/ (2 sizes)
|
|
184
|
+
In Use: ./product-photos/in-use/ (2 sizes)
|
|
185
|
+
Lifestyle: ./product-photos/lifestyle/ (2 sizes)
|
|
186
|
+
|
|
187
|
+
Cost: see .banana/costs.json for total spend
|
|
188
|
+
|
|
189
|
+
Best for:
|
|
190
|
+
• Meta Feed → Studio (4:5) or Lifestyle (4:5)
|
|
191
|
+
• TikTok/Reels → Floating (9:16) or In Use (9:16)
|
|
192
|
+
• LinkedIn → Studio (1:1) or Lifestyle (1:1)
|
|
193
|
+
• Google PMax → Studio (1:1); crop to 1.91:1 after
|
|
194
|
+
|
|
195
|
+
Run `/ads generate` to use these in a full campaign.
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
## Cost Estimate
|
|
199
|
+
|
|
200
|
+
Before generating, show:
|
|
201
|
+
- Number of styles selected x 2 sizes = total images
|
|
202
|
+
- Estimated cost based on banana pricing tiers
|
|
203
|
+
- If >$0.50, ask for confirmation
|
|
204
|
+
|
|
205
|
+
## Platform Recommendations
|
|
206
|
+
|
|
207
|
+
| Style | Best Platforms | Rationale |
|
|
208
|
+
|-------|---------------|-----------|
|
|
209
|
+
| Studio | Meta Feed, LinkedIn, Google PMax | Universal, clean, platform-safe |
|
|
210
|
+
| Floating | Meta Reels, TikTok, Stories | High visual impact on vertical placements |
|
|
211
|
+
| Ingredient | Meta Feed, Pinterest | Works best as square; tells product story |
|
|
212
|
+
| In Use | TikTok, Meta Reels, Stories | Authentic, native-feeling content |
|
|
213
|
+
| Lifestyle | All platforms | Aspirational, broad audience appeal |
|
|
214
|
+
|
|
215
|
+
## Reference Files
|
|
216
|
+
|
|
217
|
+
- `ads-agents/references/image-providers.md`: API setup and pricing
|
|
218
|
+
- `ads-agents/references/brand-dna-template.md`: Brand injection schema
|
|
219
|
+
- `ads-agents/references/meta-creative-specs.md`: Safe zone for 9:16
|
|
220
|
+
- `ads-agents/references/tiktok-creative-specs.md`: Safe zone constraints
|