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.
Files changed (66) hide show
  1. package/dist/migrate.js +81 -43
  2. package/dist/setup.js +20 -1
  3. package/package.json +1 -1
  4. package/stacks/_shared/ads-agents/README.md +452 -0
  5. package/stacks/_shared/ads-agents/RESEARCH-REPORT.md +157 -0
  6. package/stacks/_shared/ads-agents/SKILL.md +210 -0
  7. package/stacks/_shared/ads-agents/SKILLS-UPDATE-REPORT.md +255 -0
  8. package/stacks/_shared/ads-agents/agents/audit-budget.md +116 -0
  9. package/stacks/_shared/ads-agents/agents/audit-compliance.md +131 -0
  10. package/stacks/_shared/ads-agents/agents/audit-creative.md +127 -0
  11. package/stacks/_shared/ads-agents/agents/audit-google.md +113 -0
  12. package/stacks/_shared/ads-agents/agents/audit-meta.md +112 -0
  13. package/stacks/_shared/ads-agents/agents/audit-tracking.md +134 -0
  14. package/stacks/_shared/ads-agents/agents/copy-writer.md +188 -0
  15. package/stacks/_shared/ads-agents/agents/creative-strategist.md +199 -0
  16. package/stacks/_shared/ads-agents/agents/format-adapter.md +175 -0
  17. package/stacks/_shared/ads-agents/agents/visual-designer.md +245 -0
  18. package/stacks/_shared/ads-agents/references/additional-platforms.md +106 -0
  19. package/stacks/_shared/ads-agents/references/benchmarks.md +257 -0
  20. package/stacks/_shared/ads-agents/references/bidding-strategies.md +333 -0
  21. package/stacks/_shared/ads-agents/references/brand-dna-template.md +190 -0
  22. package/stacks/_shared/ads-agents/references/budget-allocation.md +150 -0
  23. package/stacks/_shared/ads-agents/references/compliance.md +280 -0
  24. package/stacks/_shared/ads-agents/references/conversion-tracking.md +246 -0
  25. package/stacks/_shared/ads-agents/references/copy-frameworks.md +187 -0
  26. package/stacks/_shared/ads-agents/references/funnel-content-copy-rules.md +44 -0
  27. package/stacks/_shared/ads-agents/references/gaql-notes.md +49 -0
  28. package/stacks/_shared/ads-agents/references/google-audit.md +217 -0
  29. package/stacks/_shared/ads-agents/references/google-creative-specs.md +119 -0
  30. package/stacks/_shared/ads-agents/references/image-providers.md +133 -0
  31. package/stacks/_shared/ads-agents/references/linkedin-audit.md +141 -0
  32. package/stacks/_shared/ads-agents/references/linkedin-creative-specs.md +129 -0
  33. package/stacks/_shared/ads-agents/references/mcp-integration.md +125 -0
  34. package/stacks/_shared/ads-agents/references/meta-audit.md +141 -0
  35. package/stacks/_shared/ads-agents/references/meta-creative-specs.md +134 -0
  36. package/stacks/_shared/ads-agents/references/microsoft-audit.md +158 -0
  37. package/stacks/_shared/ads-agents/references/microsoft-creative-specs.md +123 -0
  38. package/stacks/_shared/ads-agents/references/platform-specs.md +276 -0
  39. package/stacks/_shared/ads-agents/references/scoring-system.md +169 -0
  40. package/stacks/_shared/ads-agents/references/tiktok-audit.md +165 -0
  41. package/stacks/_shared/ads-agents/references/tiktok-creative-specs.md +139 -0
  42. package/stacks/_shared/ads-agents/references/voice-to-style.md +87 -0
  43. package/stacks/_shared/ads-agents/references/youtube-creative-specs.md +134 -0
  44. package/stacks/_shared/ads-agents/skills/ads-apple/SKILL.md +225 -0
  45. package/stacks/_shared/ads-agents/skills/ads-audit/SKILL.md +108 -0
  46. package/stacks/_shared/ads-agents/skills/ads-budget/SKILL.md +198 -0
  47. package/stacks/_shared/ads-agents/skills/ads-competitor/SKILL.md +198 -0
  48. package/stacks/_shared/ads-agents/skills/ads-create/SKILL.md +198 -0
  49. package/stacks/_shared/ads-agents/skills/ads-creative/SKILL.md +208 -0
  50. package/stacks/_shared/ads-agents/skills/ads-dna/SKILL.md +245 -0
  51. package/stacks/_shared/ads-agents/skills/ads-generate/SKILL.md +173 -0
  52. package/stacks/_shared/ads-agents/skills/ads-google/SKILL.md +192 -0
  53. package/stacks/_shared/ads-agents/skills/ads-landing/SKILL.md +186 -0
  54. package/stacks/_shared/ads-agents/skills/ads-linkedin/SKILL.md +200 -0
  55. package/stacks/_shared/ads-agents/skills/ads-math/SKILL.md +216 -0
  56. package/stacks/_shared/ads-agents/skills/ads-meta/SKILL.md +167 -0
  57. package/stacks/_shared/ads-agents/skills/ads-microsoft/SKILL.md +163 -0
  58. package/stacks/_shared/ads-agents/skills/ads-photoshoot/SKILL.md +220 -0
  59. package/stacks/_shared/ads-agents/skills/ads-plan/SKILL.md +176 -0
  60. package/stacks/_shared/ads-agents/skills/ads-test/SKILL.md +199 -0
  61. package/stacks/_shared/ads-agents/skills/ads-tiktok/SKILL.md +190 -0
  62. package/stacks/_shared/ads-agents/skills/ads-youtube/SKILL.md +199 -0
  63. package/stacks/_shared/hooks/_state.ts +8 -2
  64. package/stacks/_shared/hooks/plan-gate.ts +138 -0
  65. package/stacks/_shared/memories/funnel-content-copy.md +81 -0
  66. 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