start-vibing-stacks 2.28.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/migrate.js +81 -43
- package/dist/setup.js +20 -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/hooks/_state.ts +8 -2
- package/stacks/_shared/hooks/plan-gate.ts +138 -0
- package/stacks/_shared/memories/funnel-content-copy.md +81 -0
- package/templates/CLAUDE-python.md +6 -0
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ads-plan
|
|
3
|
+
version: 1.5.0
|
|
4
|
+
description: "Strategic paid advertising planning with industry-specific templates. Covers platform selection, campaign architecture, budget planning, creative strategy, and phased implementation roadmap. Use when user says ad plan, ad strategy, campaign planning, media plan, PPC strategy, or advertising plan."
|
|
5
|
+
user-invokable: false
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Strategic Paid Advertising Plan
|
|
9
|
+
|
|
10
|
+
## Process
|
|
11
|
+
|
|
12
|
+
### 1. Discovery
|
|
13
|
+
- Business type, products/services, target audience
|
|
14
|
+
- Current advertising status (active platforms, spend, performance)
|
|
15
|
+
- Goals: brand awareness, lead generation, e-commerce sales, app installs
|
|
16
|
+
- Budget range (monthly/quarterly)
|
|
17
|
+
- Timeline and urgency
|
|
18
|
+
- In-house team capacity vs agency needs
|
|
19
|
+
|
|
20
|
+
### 2. Competitive Analysis
|
|
21
|
+
- Identify top 3-5 competitors
|
|
22
|
+
- Analyze their ad presence across platforms (Google Ads Transparency, Meta Ad Library)
|
|
23
|
+
- Estimate competitor spend levels and platform mix
|
|
24
|
+
- Identify messaging themes and creative approaches
|
|
25
|
+
- Note keyword/audience gaps (opportunities competitors are missing)
|
|
26
|
+
|
|
27
|
+
### 3. Platform Selection
|
|
28
|
+
- Load industry template from `assets/` directory
|
|
29
|
+
- Match business type to recommended platform mix
|
|
30
|
+
- Read `ads-agents/references/budget-allocation.md` for platform selection matrix
|
|
31
|
+
- Read `ads-agents/references/conversion-tracking.md` for tracking setup requirements
|
|
32
|
+
- Assess platform fit based on:
|
|
33
|
+
- Target audience demographics per platform
|
|
34
|
+
- Product/service type suitability
|
|
35
|
+
- Budget requirements per platform (minimums)
|
|
36
|
+
- Sales cycle length and attribution needs
|
|
37
|
+
- Creative capabilities and content availability
|
|
38
|
+
|
|
39
|
+
### 4. Campaign Architecture
|
|
40
|
+
|
|
41
|
+
#### Naming Convention
|
|
42
|
+
```
|
|
43
|
+
[Platform]_[Objective]_[Audience]_[Geo]_[Date]
|
|
44
|
+
```
|
|
45
|
+
Example: `META_CONV_Prospecting_US_2026Q1`
|
|
46
|
+
|
|
47
|
+
#### Campaign Structure Template
|
|
48
|
+
```
|
|
49
|
+
Account
|
|
50
|
+
├── Brand Campaign (always-on, protect brand terms)
|
|
51
|
+
├── Non-Brand Prospecting
|
|
52
|
+
│ ├── Campaign 1: [Top Funnel - Awareness]
|
|
53
|
+
│ │ ├── Ad Group/Set 1: [Audience A]
|
|
54
|
+
│ │ └── Ad Group/Set 2: [Audience B]
|
|
55
|
+
│ ├── Campaign 2: [Mid Funnel - Consideration]
|
|
56
|
+
│ │ ├── Ad Group/Set 1: [Interest-based]
|
|
57
|
+
│ │ └── Ad Group/Set 2: [Lookalike/Similar]
|
|
58
|
+
│ └── Campaign 3: [Bottom Funnel - Conversion]
|
|
59
|
+
│ ├── Ad Group/Set 1: [High-intent]
|
|
60
|
+
│ └── Ad Group/Set 2: [Custom audience]
|
|
61
|
+
├── Retargeting
|
|
62
|
+
│ ├── Website Visitors (7-30 days)
|
|
63
|
+
│ ├── Engaged Users (video views, social engagement)
|
|
64
|
+
│ └── Cart Abandoners / Form Starters
|
|
65
|
+
└── Testing
|
|
66
|
+
└── New audiences, formats, or messaging
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### 5. Budget Planning
|
|
70
|
+
|
|
71
|
+
#### Monthly Budget Distribution
|
|
72
|
+
Read `ads-agents/references/budget-allocation.md` for the 70/20/10 framework.
|
|
73
|
+
|
|
74
|
+
| Tier | Allocation | Purpose |
|
|
75
|
+
|------|-----------|---------|
|
|
76
|
+
| Proven (70%) | Primary platforms with proven ROI | Revenue engine |
|
|
77
|
+
| Scaling (20%) | Platforms showing promise | Growth engine |
|
|
78
|
+
| Testing (10%) | New platforms or strategies | Innovation |
|
|
79
|
+
|
|
80
|
+
#### Budget Pacing
|
|
81
|
+
- Month 1-2: heavy testing, expect higher CPA (learning)
|
|
82
|
+
- Month 3-4: optimize based on data, tighten targeting
|
|
83
|
+
- Month 5-6: scale winners, kill losers, expand
|
|
84
|
+
- Ongoing: 70/20/10 maintenance with quarterly reviews
|
|
85
|
+
|
|
86
|
+
### 6. Creative Strategy
|
|
87
|
+
|
|
88
|
+
#### Content Pillars
|
|
89
|
+
- **Pain Point**: address specific problems your audience faces
|
|
90
|
+
- **Social Proof**: testimonials, case studies, reviews
|
|
91
|
+
- **Product Demo**: show the product/service in action
|
|
92
|
+
- **Offer**: promotions, free trials, lead magnets
|
|
93
|
+
- **Education**: teach something valuable related to your product
|
|
94
|
+
|
|
95
|
+
#### Creative Production Plan
|
|
96
|
+
| Priority | Asset Type | Platforms | Quantity |
|
|
97
|
+
|----------|-----------|-----------|----------|
|
|
98
|
+
| P1 | Product/service videos (15-30s) | Meta, TikTok, YouTube | 5-10 |
|
|
99
|
+
| P2 | Static images with copy | Google, Meta, LinkedIn | 10-15 |
|
|
100
|
+
| P3 | Carousel/collection | Meta, LinkedIn | 3-5 |
|
|
101
|
+
| P4 | UGC/testimonial video | TikTok, Meta | 3-5 |
|
|
102
|
+
| P5 | Long-form video (1-3 min) | YouTube | 2-3 |
|
|
103
|
+
|
|
104
|
+
### 7. Tracking Setup Plan
|
|
105
|
+
|
|
106
|
+
Before launching any ads, ensure tracking is configured:
|
|
107
|
+
|
|
108
|
+
| Platform | Client-Side | Server-Side | Priority |
|
|
109
|
+
|----------|------------|-------------|----------|
|
|
110
|
+
| Google | gtag.js | Enhanced Conversions, GTM SS | P1 |
|
|
111
|
+
| Meta | Pixel | CAPI | P1 |
|
|
112
|
+
| LinkedIn | Insight Tag | CAPI (2025) | P2 |
|
|
113
|
+
| TikTok | Pixel | Events API + ttclid | P2 |
|
|
114
|
+
| Microsoft | UET Tag | Enhanced Conversions | P2 |
|
|
115
|
+
|
|
116
|
+
### 8. Implementation Roadmap
|
|
117
|
+
|
|
118
|
+
#### Phase 1: Foundation (Weeks 1-2)
|
|
119
|
+
- Install all tracking pixels and server-side tracking
|
|
120
|
+
- Set up conversion events and goals
|
|
121
|
+
- Create campaign structure and naming conventions
|
|
122
|
+
- Build initial audiences (custom, lookalike/predictive)
|
|
123
|
+
- Produce first batch of creative assets
|
|
124
|
+
|
|
125
|
+
#### Phase 2: Launch (Weeks 3-4)
|
|
126
|
+
- Launch campaigns on primary platform(s) first
|
|
127
|
+
- Set conservative budgets and bidding (Maximize Clicks / Lowest Cost)
|
|
128
|
+
- Monitor daily for the first 7 days
|
|
129
|
+
- Verify conversion tracking is firing correctly
|
|
130
|
+
|
|
131
|
+
#### Phase 3: Optimize (Weeks 5-8)
|
|
132
|
+
- Analyze initial data (minimum 2 weeks of data)
|
|
133
|
+
- Adjust bidding strategies based on conversion volume
|
|
134
|
+
- Kill underperforming ad groups/creatives (3x Kill Rule)
|
|
135
|
+
- Launch secondary platforms
|
|
136
|
+
- Begin A/B testing (creative, landing pages, audiences)
|
|
137
|
+
|
|
138
|
+
#### Phase 4: Scale (Weeks 9-12)
|
|
139
|
+
- Scale winning campaigns (20% rule)
|
|
140
|
+
- Expand to testing platforms (10% budget)
|
|
141
|
+
- Implement advanced strategies (ABM, Shopping feeds, Smart+)
|
|
142
|
+
- Monthly performance reviews
|
|
143
|
+
|
|
144
|
+
## Industry Templates
|
|
145
|
+
|
|
146
|
+
Load from `assets/` directory based on detected or specified business type:
|
|
147
|
+
- `saas.md`: SaaS companies
|
|
148
|
+
- `ecommerce.md`: E-commerce stores
|
|
149
|
+
- `local-service.md`: Local service businesses
|
|
150
|
+
- `b2b-enterprise.md`: B2B enterprise
|
|
151
|
+
- `info-products.md`: Info products and courses
|
|
152
|
+
- `mobile-app.md`: Mobile app companies
|
|
153
|
+
- `real-estate.md`: Real estate
|
|
154
|
+
- `healthcare.md`: Healthcare
|
|
155
|
+
- `finance.md`: Financial services
|
|
156
|
+
- `agency.md`: Marketing agencies
|
|
157
|
+
- `generic.md`: General business template
|
|
158
|
+
|
|
159
|
+
## Output
|
|
160
|
+
|
|
161
|
+
### Deliverables
|
|
162
|
+
- `ADS-STRATEGY.md`: Complete strategic advertising plan
|
|
163
|
+
- `CAMPAIGN-ARCHITECTURE.md`: Campaign structure with naming conventions
|
|
164
|
+
- `BUDGET-PLAN.md`: Budget allocation with monthly pacing
|
|
165
|
+
- `CREATIVE-BRIEF.md`: Creative production plan with specifications
|
|
166
|
+
- `TRACKING-SETUP.md`: Tracking implementation checklist
|
|
167
|
+
- `IMPLEMENTATION-ROADMAP.md`: Phased rollout timeline
|
|
168
|
+
|
|
169
|
+
### KPI Targets
|
|
170
|
+
| Metric | Month 1 | Month 3 | Month 6 | Month 12 |
|
|
171
|
+
|--------|---------|---------|---------|----------|
|
|
172
|
+
| ROAS | Baseline | Target -20% | Target | Target +20% |
|
|
173
|
+
| CPA | Baseline | Target +30% | Target | Target -10% |
|
|
174
|
+
| CVR | Baseline | +10% | +20% | +30% |
|
|
175
|
+
| CTR | Baseline | +15% | +25% | +30% |
|
|
176
|
+
| Budget | Testing | Optimizing | Scaling | Maintaining |
|
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ads-test
|
|
3
|
+
version: 1.5.0
|
|
4
|
+
description: "A/B test design and experiment planning for paid advertising. Structured hypothesis framework, statistical significance calculator, test duration estimator, sample size calculator, and platform-specific experiment setup guides (Meta Experiments, Google Experiments, LinkedIn A/B). Use when user says A/B test, split test, experiment design, test hypothesis, statistical significance, sample size, or test duration."
|
|
5
|
+
user-invokable: false
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# A/B Test Design & Experiment Planning
|
|
9
|
+
|
|
10
|
+
<!-- Created: 2026-04-13 | v1.5 -->
|
|
11
|
+
<!-- Source: OpenClaudia/openclaudia-skills (ab-test-setup concept) -->
|
|
12
|
+
|
|
13
|
+
## Process
|
|
14
|
+
|
|
15
|
+
1. Understand what the user wants to test (creative, audience, bidding, landing page)
|
|
16
|
+
2. Build structured hypothesis using the framework below
|
|
17
|
+
3. Calculate required sample size and estimated duration
|
|
18
|
+
4. Recommend platform-specific test setup
|
|
19
|
+
5. Define success criteria and measurement plan
|
|
20
|
+
|
|
21
|
+
## Hypothesis Framework
|
|
22
|
+
|
|
23
|
+
Every test must start with a structured hypothesis:
|
|
24
|
+
|
|
25
|
+
```
|
|
26
|
+
IF we [change/action]
|
|
27
|
+
THEN [metric] will [increase/decrease] by [estimated %]
|
|
28
|
+
BECAUSE [reasoning based on data or insight]
|
|
29
|
+
|
|
30
|
+
Example:
|
|
31
|
+
IF we replace polished product shots with UGC creator videos
|
|
32
|
+
THEN Meta CTR will increase by 25-40%
|
|
33
|
+
BECAUSE Andromeda prioritizes diverse creative formats and UGC consistently outperforms polished in 2025-2026 benchmarks
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
### Hypothesis Quality Checklist
|
|
37
|
+
- [ ] Single variable being tested (isolate the change)
|
|
38
|
+
- [ ] Specific metric defined (not "performance")
|
|
39
|
+
- [ ] Estimated effect size stated (needed for sample size calculation)
|
|
40
|
+
- [ ] Timeframe defined
|
|
41
|
+
- [ ] Success/failure criteria clear before launch
|
|
42
|
+
|
|
43
|
+
## Statistical Significance Calculator
|
|
44
|
+
|
|
45
|
+
```
|
|
46
|
+
Required Sample Size (per variant):
|
|
47
|
+
|
|
48
|
+
n = (Z_alpha + Z_beta)^2 × 2 × p × (1-p) / MDE^2
|
|
49
|
+
|
|
50
|
+
Where:
|
|
51
|
+
- Z_alpha = 1.96 (for 95% confidence)
|
|
52
|
+
- Z_beta = 0.84 (for 80% power)
|
|
53
|
+
- p = baseline conversion rate
|
|
54
|
+
- MDE = minimum detectable effect (relative %)
|
|
55
|
+
|
|
56
|
+
Simplified lookup:
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
| Baseline CVR | 5% MDE | 10% MDE | 20% MDE | 30% MDE |
|
|
60
|
+
|-------------|---------|---------|---------|---------|
|
|
61
|
+
| 1% | 612,000 | 153,000 | 38,300 | 17,000 |
|
|
62
|
+
| 2% | 302,400 | 75,600 | 18,900 | 8,400 |
|
|
63
|
+
| 5% | 116,800 | 29,200 | 7,300 | 3,200 |
|
|
64
|
+
| 10% | 55,200 | 13,800 | 3,450 | 1,530 |
|
|
65
|
+
| 20% | 24,600 | 6,150 | 1,540 | 680 |
|
|
66
|
+
|
|
67
|
+
*Per variant, 95% confidence, 80% power*
|
|
68
|
+
|
|
69
|
+
## Test Duration Estimator
|
|
70
|
+
|
|
71
|
+
```
|
|
72
|
+
Duration = Required Sample Size / Daily Traffic per Variant
|
|
73
|
+
|
|
74
|
+
Minimum duration: 7 days (capture weekly patterns)
|
|
75
|
+
Maximum recommended: 28 days (avoid seasonal drift)
|
|
76
|
+
Learning phase: Google 7-14 days, Meta 3-7 days, LinkedIn 7-14 days
|
|
77
|
+
|
|
78
|
+
Inputs needed:
|
|
79
|
+
- Daily impressions or clicks
|
|
80
|
+
- Number of variants (2 = A/B, 3+ = multivariate)
|
|
81
|
+
- Baseline conversion rate
|
|
82
|
+
- Minimum detectable effect desired
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
### Duration Quick Estimates
|
|
86
|
+
|
|
87
|
+
| Daily Clicks | 2% CVR, 20% MDE | 5% CVR, 20% MDE | 10% CVR, 20% MDE |
|
|
88
|
+
|-------------|-----------------|-----------------|-----------------|
|
|
89
|
+
| 100 | 189 days | 73 days | 35 days |
|
|
90
|
+
| 500 | 38 days | 15 days | 7 days |
|
|
91
|
+
| 1,000 | 19 days | 7 days | 4 days* |
|
|
92
|
+
| 5,000 | 4 days* | 2 days* | 1 day* |
|
|
93
|
+
|
|
94
|
+
*Minimum 7 days recommended regardless of sample sufficiency
|
|
95
|
+
|
|
96
|
+
## Platform-Specific Test Setup
|
|
97
|
+
|
|
98
|
+
### Meta Experiments
|
|
99
|
+
- Use Ads Manager > Experiments tab (not manual ad set duplication)
|
|
100
|
+
- Automatic audience splitting ensures no overlap
|
|
101
|
+
- Supported test types: A/B (creative, audience, placement), Holdout, Brand Survey
|
|
102
|
+
- Meta's Incremental Attribution (April 2025) provides AI-powered holdout testing for measuring real causal impact
|
|
103
|
+
- Budget: split evenly across variants; minimum $100/day per variant recommended
|
|
104
|
+
- Duration: 7-14 days typical; Meta auto-determines winner at 95% confidence
|
|
105
|
+
|
|
106
|
+
### Google Experiments
|
|
107
|
+
- Campaign Experiments (custom experiments) or Ad Variations
|
|
108
|
+
- Create experiment from existing campaign > select experiment type
|
|
109
|
+
- Traffic split: 50/50 recommended for fastest results
|
|
110
|
+
- Supported: bidding strategy, ad copy, landing page, audience
|
|
111
|
+
- Metrics: choose primary metric (conversions, CPA, ROAS) before launch
|
|
112
|
+
- Duration: 14-30 days recommended; minimum 2 weeks for bidding tests
|
|
113
|
+
|
|
114
|
+
### LinkedIn A/B Testing
|
|
115
|
+
- Built into Campaign Manager for Sponsored Content
|
|
116
|
+
- Duplicate ad set with single variable change
|
|
117
|
+
- Target: same audience segment with automatic rotation
|
|
118
|
+
- Minimum budget: $50/day per variant
|
|
119
|
+
- Key metrics: CTR (>0.44% benchmark), CPL, Lead Form CVR (13% benchmark)
|
|
120
|
+
- Duration: 14-21 days (LinkedIn's smaller daily volumes require longer tests)
|
|
121
|
+
|
|
122
|
+
### TikTok Split Testing
|
|
123
|
+
- Available in TikTok Ads Manager > Create A/B Test
|
|
124
|
+
- Test types: targeting, bidding, creative
|
|
125
|
+
- Auto-splits audience to avoid contamination
|
|
126
|
+
- Minimum 7 days, recommended 14 days
|
|
127
|
+
- Budget: minimum $20/day per ad group
|
|
128
|
+
- Creative tests: isolate hook (first 2-3 seconds) as the primary variable
|
|
129
|
+
- TikTok's enhanced split testing supports modular test variables (targeting, creative, budget, placement) via Smart+ since 2025
|
|
130
|
+
|
|
131
|
+
## What to Test (Priority Order)
|
|
132
|
+
|
|
133
|
+
### High Impact (test first)
|
|
134
|
+
1. **Creative concept** (different messaging angles, not just color changes)
|
|
135
|
+
2. **Hook/first 3 seconds** (video opening on Meta, TikTok, YouTube)
|
|
136
|
+
3. **Offer structure** (pricing, discount type, free trial length)
|
|
137
|
+
4. **Landing page** (headline, CTA, form length)
|
|
138
|
+
5. **Bidding strategy** (tCPA vs tROAS vs Maximize Conversions)
|
|
139
|
+
|
|
140
|
+
### Medium Impact
|
|
141
|
+
6. **Audience targeting** (interest vs lookalike vs broad)
|
|
142
|
+
7. **Ad format** (static vs video vs carousel)
|
|
143
|
+
8. **CTA button** (Learn More vs Sign Up vs Shop Now)
|
|
144
|
+
9. **Campaign structure** (CBO vs ABO, consolidated vs segmented)
|
|
145
|
+
|
|
146
|
+
### Low Impact (test last)
|
|
147
|
+
10. **Ad scheduling** (time of day, day of week)
|
|
148
|
+
11. **Device targeting** (mobile vs desktop)
|
|
149
|
+
12. **Minor copy variations** (word substitutions without concept change)
|
|
150
|
+
|
|
151
|
+
## Common Testing Mistakes to Avoid
|
|
152
|
+
|
|
153
|
+
- Testing too many variables at once (no clear winner attribution)
|
|
154
|
+
- Ending tests too early (before statistical significance)
|
|
155
|
+
- Testing during atypical periods (holidays, launches, incidents)
|
|
156
|
+
- Comparing unequal time periods
|
|
157
|
+
- Not documenting learnings (build institutional knowledge)
|
|
158
|
+
- Testing small changes when big changes are needed (optimize vs innovate)
|
|
159
|
+
- Ignoring learning phase on automated platforms
|
|
160
|
+
|
|
161
|
+
## Output Format
|
|
162
|
+
|
|
163
|
+
```
|
|
164
|
+
## A/B Test Plan
|
|
165
|
+
|
|
166
|
+
### Hypothesis
|
|
167
|
+
IF [change]
|
|
168
|
+
THEN [metric] will [direction] by [amount]
|
|
169
|
+
BECAUSE [reasoning]
|
|
170
|
+
|
|
171
|
+
### Test Design
|
|
172
|
+
| Parameter | Value |
|
|
173
|
+
|-----------|-------|
|
|
174
|
+
| Platform | [platform] |
|
|
175
|
+
| Test Type | [A/B / Multivariate] |
|
|
176
|
+
| Variable | [what's being changed] |
|
|
177
|
+
| Control | [current state] |
|
|
178
|
+
| Variant | [proposed change] |
|
|
179
|
+
| Primary Metric | [KPI] |
|
|
180
|
+
| Traffic Split | [50/50 / other] |
|
|
181
|
+
|
|
182
|
+
### Sample Size & Duration
|
|
183
|
+
| Metric | Value |
|
|
184
|
+
|--------|-------|
|
|
185
|
+
| Baseline CVR | [X%] |
|
|
186
|
+
| MDE | [X%] |
|
|
187
|
+
| Required Sample | [N per variant] |
|
|
188
|
+
| Daily Traffic | [N clicks/day] |
|
|
189
|
+
| Est. Duration | [X days] |
|
|
190
|
+
| Min Duration | 7 days |
|
|
191
|
+
|
|
192
|
+
### Success Criteria
|
|
193
|
+
- Winner declared at 95% confidence
|
|
194
|
+
- [Primary metric] improvement of [X%]+ sustained over [Y] days
|
|
195
|
+
- No negative impact on [secondary metric]
|
|
196
|
+
|
|
197
|
+
### Setup Instructions
|
|
198
|
+
[Platform-specific step-by-step]
|
|
199
|
+
```
|
|
@@ -0,0 +1,190 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ads-tiktok
|
|
3
|
+
version: 1.6.0
|
|
4
|
+
description: "TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 28 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says TikTok Ads, TikTok marketing, TikTok Shop, Spark Ads, Smart+, or TikTok campaign."
|
|
5
|
+
user-invokable: false
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
<!-- Updated: 2026-05-14 | v1.6: Smart+ Catalog Ads 29% CPA improvement, Smart+ expanded to Traffic objective, Symphony Automation in Smart+ workflow, Asset Manager, 30 ad groups × 30 asset groups × 50 creatives campaign structure -->
|
|
9
|
+
|
|
10
|
+
# TikTok Ads Deep Analysis
|
|
11
|
+
|
|
12
|
+
## Process
|
|
13
|
+
|
|
14
|
+
1. Collect TikTok Ads data (Ads Manager export, Pixel/Events API status)
|
|
15
|
+
2. Read `ads-agents/references/tiktok-audit.md` for full 28-check audit
|
|
16
|
+
3. Read `ads-agents/references/benchmarks.md` for TikTok-specific benchmarks
|
|
17
|
+
4. Read `ads-agents/references/platform-specs.md` for creative specifications
|
|
18
|
+
5. Read `ads-agents/references/scoring-system.md` for weighted scoring algorithm
|
|
19
|
+
6. Evaluate all applicable checks as PASS, WARNING, or FAIL
|
|
20
|
+
7. Calculate TikTok Ads Health Score (0-100)
|
|
21
|
+
8. Generate findings report with action plan
|
|
22
|
+
|
|
23
|
+
## What to Analyze
|
|
24
|
+
|
|
25
|
+
### Creative Quality (30% weight)
|
|
26
|
+
- ≥6 creatives per ad group (T05) [Critical]
|
|
27
|
+
- All video 9:16 vertical 1080x1920 (T06) [Critical]
|
|
28
|
+
- Native-looking content, not corporate/polished (T07)
|
|
29
|
+
- Hook in first 1-2 seconds (T08)
|
|
30
|
+
- No creative active >7 days with declining CTR (T09)
|
|
31
|
+
- Spark Ads tested: ~3% CTR vs ~2% standard (T10)
|
|
32
|
+
- TikTok Shop integration for e-commerce (T20)
|
|
33
|
+
- Video Shopping Ads tested (T21)
|
|
34
|
+
- Caption SEO with high-intent keywords (T22)
|
|
35
|
+
- Trending audio used (sound-on platform) (T23)
|
|
36
|
+
- Custom CTA button, not default (T24)
|
|
37
|
+
- Safe zone compliance: X:40-940, Y:150-1470 (T25)
|
|
38
|
+
|
|
39
|
+
### Technical Setup (25% weight)
|
|
40
|
+
- TikTok Pixel installed and firing on all pages (T01)
|
|
41
|
+
- Events API + ttclid passback active (T02)
|
|
42
|
+
- Events API Gateway evaluated for server-side integration
|
|
43
|
+
- Standard events configured (ViewContent, AddToCart, Purchase, CompleteRegistration)
|
|
44
|
+
- Advanced matching parameters configured
|
|
45
|
+
|
|
46
|
+
### Bidding & Budget (20% weight)
|
|
47
|
+
- Bid strategy matches goal: Lowest Cost for volume, Cost Cap for efficiency (T11)
|
|
48
|
+
- Daily budget ≥50x target CPA per ad group (T12)
|
|
49
|
+
- Learning phase: ≥50 conversions per 7 days per ad group (T13)
|
|
50
|
+
- No edits during learning phase (resets learning)
|
|
51
|
+
|
|
52
|
+
### Structure & Settings (15% weight)
|
|
53
|
+
- Separate campaigns for prospecting vs retargeting (T03)
|
|
54
|
+
- Smart+ campaigns tested: 42% adoption, 1.41-1.67 ROAS (T04)
|
|
55
|
+
- Search Ads Toggle enabled (20% conversion uplift combined with In-Feed; 57% of users use search) (T14)
|
|
56
|
+
- Placement selection reviewed: TikTok, Pangle, etc. (T15)
|
|
57
|
+
- Dayparting aligned with audience activity (T16)
|
|
58
|
+
|
|
59
|
+
### Performance (10% weight)
|
|
60
|
+
- CTR ≥1.0% for in-feed ads (T17)
|
|
61
|
+
- CPA within target, 3x Kill Rule applies (T18)
|
|
62
|
+
- Average video watch time ≥6 seconds (T19)
|
|
63
|
+
|
|
64
|
+
## Creative-First Strategy
|
|
65
|
+
|
|
66
|
+
TikTok is a creative-first platform. Unlike Google/Meta where targeting and bidding
|
|
67
|
+
drive most performance, TikTok success depends primarily on creative quality.
|
|
68
|
+
|
|
69
|
+
### What Makes a TikTok Ad Work
|
|
70
|
+
- **Native feel**: looks like organic content, not a polished ad
|
|
71
|
+
- **Sound-on**: 93% of TikTok is consumed with sound (never run silent)
|
|
72
|
+
- **Fast hooks**: capture attention in 1-2 seconds or lose the viewer
|
|
73
|
+
- **Trend alignment**: use trending sounds, formats, and editing styles
|
|
74
|
+
- **UGC style**: user-generated content outperforms studio content
|
|
75
|
+
- **Vertical only**: 9:16 is non-negotiable (no letterboxed horizontal)
|
|
76
|
+
|
|
77
|
+
### Creative Testing Framework
|
|
78
|
+
1. Test 3-5 hooks per winning concept
|
|
79
|
+
2. Rotate creatives every 5-7 days (fatigue sets in fast)
|
|
80
|
+
3. Kill underperformers after 3 days if CTR <0.5%
|
|
81
|
+
4. Scale winners by duplicating (not increasing budget on same ad)
|
|
82
|
+
5. Repurpose winning concepts, not assets (fresh footage, same angle)
|
|
83
|
+
|
|
84
|
+
## Safe Zone
|
|
85
|
+
|
|
86
|
+
All critical text, logos, and CTAs must be within the safe zone:
|
|
87
|
+
|
|
88
|
+
```
|
|
89
|
+
┌──────────────────────┐
|
|
90
|
+
│ UNSAFE (status) │ Y: 0-150px
|
|
91
|
+
├──────────────────────┤
|
|
92
|
+
│ │UNSA│
|
|
93
|
+
│ │FE │
|
|
94
|
+
│ SAFE ZONE │icon│ X: 40-940px
|
|
95
|
+
│ 900×1320px │ │ Y: 150-1470px
|
|
96
|
+
│ │ │
|
|
97
|
+
│ │ │ Right 140px: like/comment/share
|
|
98
|
+
├──────────────────────┤
|
|
99
|
+
│ UNSAFE (caption) │ Y: 1470-1920px
|
|
100
|
+
└──────────────────────┘
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
## TikTok Shop Assessment
|
|
104
|
+
|
|
105
|
+
If e-commerce, evaluate TikTok Shop setup:
|
|
106
|
+
- Product catalog connected and synced
|
|
107
|
+
- Product detail pages complete (images, descriptions, reviews)
|
|
108
|
+
- Video Shopping Ads linking to in-app checkout
|
|
109
|
+
- Shop tab on TikTok profile configured
|
|
110
|
+
- Affiliate program active (if applicable)
|
|
111
|
+
- Shop CVR benchmark: >10% (significantly higher than standard landing page)
|
|
112
|
+
|
|
113
|
+
## Smart+ Campaigns (2026)
|
|
114
|
+
|
|
115
|
+
- 42% of advertisers have adopted Smart+ (TikTok's automated campaign type)
|
|
116
|
+
- Average ROAS: 1.41-1.67
|
|
117
|
+
- **Smart+ Catalog Ads: 29% CPA improvement vs manual** (TikTok internal data, Global 2025 beta)
|
|
118
|
+
- **Modular control (2025+):** Lock targeting, budget, catalog ads, or placements independently (creative now via Symphony Automation)
|
|
119
|
+
- **Smart+ Automatic Placement** lets you manually select placements (TikTok, Pangle, Lemon8, Global App Bundle) where available
|
|
120
|
+
- **Expanded to Traffic objective (2026)** — previously only Sales, App Promotion, Lead Gen
|
|
121
|
+
- **Campaign structure flexibility (2026):** up to 30 ad groups per campaign × 30 asset groups per ad group × 50 creatives per asset group
|
|
122
|
+
- **Asset Manager (2026):** unified dashboard for events + catalog + creative; products are the primary key for Smart+ Catalog Ads
|
|
123
|
+
- **Symphony Automation built into Smart+ workflow:**
|
|
124
|
+
- Recommended Creatives (analyzes library + generates TikTok-ready videos from product URLs)
|
|
125
|
+
- Auto-add (automatically refreshes creatives in running campaigns)
|
|
126
|
+
- Automatic Enhancements (1-click: improves video/image quality, resizes to 9:16, refreshes music/hooks, translates/dubs into 50+ languages)
|
|
127
|
+
- Music Autofix for App Campaigns (auto-detects music blockers, swaps from Commercial Music Library)
|
|
128
|
+
- Best for: e-commerce with product feed, app installs, lead gen with deep funnel optimization
|
|
129
|
+
- Evaluate: is the advertiser testing Smart+ alongside manual campaigns? Compare same objectives. Check which modules are locked vs automated
|
|
130
|
+
|
|
131
|
+
## GMV Max (Shop Ads)
|
|
132
|
+
|
|
133
|
+
Mandatory for all Shop Ads since July 2025. Evaluate:
|
|
134
|
+
- GMV Max campaign active for all TikTok Shop products
|
|
135
|
+
- Product feed quality and completeness
|
|
136
|
+
- Shop Ads performance vs standard in-feed campaigns
|
|
137
|
+
|
|
138
|
+
## Symphony Automation (2026)
|
|
139
|
+
|
|
140
|
+
AI-powered creative variations generated from product URLs, now integrated into the Smart+ workflow.
|
|
141
|
+
- Two main solutions inside Smart+:
|
|
142
|
+
- **Recommended Creatives**: scans library to surface best assets per campaign + generates TikTok-ready videos from product URLs; includes **Auto-add** that refreshes creatives in running campaigns
|
|
143
|
+
- **Automatic Enhancements**: 1-click improves video/image quality, resizes for 9:16, refreshes music or hooks, translates and dubs into 50+ languages
|
|
144
|
+
- Includes built-in creative control settings (kept under advertiser approval)
|
|
145
|
+
- Evaluate whether account uses Symphony-generated vs original creatives
|
|
146
|
+
- Assess impact on creative refresh cadence (Symphony can accelerate testing without burning team capacity)
|
|
147
|
+
- Monitor quality of AI-generated variations vs manual creatives (Symphony can mask low concept diversity if all variations come from one product URL)
|
|
148
|
+
|
|
149
|
+
## TikTok Context
|
|
150
|
+
|
|
151
|
+
| Setting | Value |
|
|
152
|
+
|---------|-------|
|
|
153
|
+
| CPM | 40-60% cheaper than Meta |
|
|
154
|
+
| Spark Ads CTR | ~3% (vs ~2% standard) |
|
|
155
|
+
| Smart+ adoption | 42% of advertisers |
|
|
156
|
+
| Smart+ ROAS | 1.41-1.67 |
|
|
157
|
+
| Shop CVR | >10% |
|
|
158
|
+
| Available markets | 11 countries (US, UK, ID, MY, PH, SG, TH, VN, JP, KR, BR) |
|
|
159
|
+
|
|
160
|
+
## Key Thresholds
|
|
161
|
+
|
|
162
|
+
| Metric | Pass | Warning | Fail |
|
|
163
|
+
|--------|------|---------|------|
|
|
164
|
+
| CTR (in-feed) | ≥1.0% | 0.5-1.0% | <0.5% |
|
|
165
|
+
| Creatives per ad group | ≥6 | 3-5 | <3 |
|
|
166
|
+
| Video watch time | ≥6s | 3-6s | <3s |
|
|
167
|
+
| Learning conversions | ≥50/week | 30-50/week | <30/week |
|
|
168
|
+
| Daily budget | ≥50x CPA | 20-49x CPA | <20x CPA |
|
|
169
|
+
| Creative age (declining) | <7 days | 7-14 days | >14 days |
|
|
170
|
+
|
|
171
|
+
## Output
|
|
172
|
+
|
|
173
|
+
### TikTok Ads Health Score
|
|
174
|
+
|
|
175
|
+
```
|
|
176
|
+
TikTok Ads Health Score: XX/100 (Grade: X)
|
|
177
|
+
|
|
178
|
+
Creative Quality: XX/100 ████████░░ (30%)
|
|
179
|
+
Technical Setup: XX/100 ██████████ (25%)
|
|
180
|
+
Bidding & Budget: XX/100 ███████░░░ (20%)
|
|
181
|
+
Structure: XX/100 █████░░░░░ (15%)
|
|
182
|
+
Performance: XX/100 ████████░░ (10%)
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
### Deliverables
|
|
186
|
+
- `TIKTOK-ADS-REPORT.md`: Full 28-check findings with pass/warning/fail
|
|
187
|
+
- Creative scorecard per ad (hook quality, safe zone, native feel)
|
|
188
|
+
- Smart+ vs manual performance comparison
|
|
189
|
+
- TikTok Shop readiness assessment (if e-commerce)
|
|
190
|
+
- Quick Wins sorted by impact
|