arkaos 4.26.0 → 4.28.0

package/departments/marketing/skills/paid-campaign/references/ad-copy-templates.md

@@ -0,0 +1,207 @@
+# Ad Copy Templates Reference
+
+Detailed formulas and templates for writing high-converting ad copy.
+
+## Contents
+- Primary Text Formulas (Problem-Agitate-Solve, Before-After-Bridge, Social Proof Lead, Feature-Benefit Bridge, Direct Response)
+- Headline Formulas (For Search Ads, For Social Ads)
+- CTA Variations (Soft CTAs, Hard CTAs, Urgency CTAs, Action-Oriented CTAs)
+- Platform-Specific Copy Guidelines (Google Search Ads, Meta Ads, LinkedIn Ads)
+- Copy Testing Priority
+
+## Primary Text Formulas
+
+### Problem-Agitate-Solve (PAS)
+
+```
+[Problem statement]
+[Agitate the pain]
+[Introduce solution]
+[CTA]
+```
+
+**Example:**
+> Spending hours on manual reporting every week?
+> While you're buried in spreadsheets, your competitors are making decisions.
+> [Product] automates your reports in minutes.
+> Start your free trial →
+
+---
+
+### Before-After-Bridge (BAB)
+
+```
+[Current painful state]
+[Desired future state]
+[Your product as the bridge]
+```
+
+**Example:**
+> Before: Chasing down approvals across email, Slack, and spreadsheets.
+> After: Every approval tracked, automated, and on time.
+> [Product] connects your tools and keeps projects moving.
+
+---
+
+### Social Proof Lead
+
+```
+[Impressive stat or testimonial]
+[What you do]
+[CTA]
+```
+
+**Example:**
+> "We cut our reporting time by 75%." — Sarah K., Marketing Director
+> [Product] automates the reports you hate building.
+> See how it works →
+
+---
+
+### Feature-Benefit Bridge
+
+```
+[Feature]
+[So that...]
+[Which means...]
+```
+
+**Example:**
+> Real-time collaboration on documents
+> So your team always works from the latest version
+> Which means no more version confusion or lost work
+
+---
+
+### Direct Response
+
+```
+[Bold claim/outcome]
+[Proof point]
+[CTA with urgency if genuine]
+```
+
+**Example:**
+> Cut your reporting time by 80%
+> Join 5,000+ marketing teams already using [Product]
+> Start free → First month 50% off
+
+---
+
+## Headline Formulas
+
+### For Search Ads
+
+| Formula | Example |
+|---------|---------|
+| [Keyword] + [Benefit] | "Project Management That Teams Actually Use" |
+| [Action] + [Outcome] | "Automate Reports \| Save 10 Hours Weekly" |
+| [Question] | "Tired of Manual Data Entry?" |
+| [Number] + [Benefit] | "500+ Teams Trust [Product] for [Outcome]" |
+| [Keyword] + [Differentiator] | "CRM Built for Small Teams" |
+| [Price/Offer] + [Keyword] | "Free Project Management \| No Credit Card" |
+
+### For Social Ads
+
+| Type | Example |
+|------|---------|
+| Outcome hook | "How we 3x'd our conversion rate" |
+| Curiosity hook | "The reporting hack no one talks about" |
+| Contrarian hook | "Why we stopped using [common tool]" |
+| Specificity hook | "The exact template we use for..." |
+| Question hook | "What if you could cut your admin time in half?" |
+| Number hook | "7 ways to improve your workflow today" |
+| Story hook | "We almost gave up. Then we found..." |
+
+---
+
+## CTA Variations
+
+### Soft CTAs (awareness/consideration)
+
+Best for: Top of funnel, cold audiences, complex products
+
+- Learn More
+- See How It Works
+- Watch Demo
+- Get the Guide
+- Explore Features
+- See Examples
+- Read the Case Study
+
+### Hard CTAs (conversion)
+
+Best for: Bottom of funnel, warm audiences, clear offers
+
+- Start Free Trial
+- Get Started Free
+- Book a Demo
+- Claim Your Discount
+- Buy Now
+- Sign Up Free
+- Get Instant Access
+
+### Urgency CTAs (use when genuine)
+
+Best for: Limited-time offers, scarcity situations
+
+- Limited Time: 30% Off
+- Offer Ends [Date]
+- Only X Spots Left
+- Last Chance
+- Early Bird Pricing Ends Soon
+
+### Action-Oriented CTAs
+
+Best for: Active voice, clear next step
+
+- Start Saving Time Today
+- Get Your Free Report
+- See Your Score
+- Calculate Your ROI
+- Build Your First Project
+
+---
+
+## Platform-Specific Copy Guidelines
+
+### Google Search Ads
+
+- **Headline limits:** 30 characters each (up to 15 headlines)
+- **Description limits:** 90 characters each (up to 4 descriptions)
+- Include keywords naturally
+- Use all available headline slots
+- Include numbers and stats when possible
+- Test dynamic keyword insertion
+
+### Meta Ads (Facebook/Instagram)
+
+- **Primary text:** 125 characters visible (can be longer, gets truncated)
+- **Headline:** 40 characters recommended
+- Front-load the hook (first line matters most)
+- Emojis can work but test
+- Questions perform well
+- Keep image text under 20%
+
+### LinkedIn Ads
+
+- **Intro text:** 600 characters max (150 recommended)
+- **Headline:** 200 characters max (70 recommended)
+- Professional tone (but not boring)
+- Specific job outcomes resonate
+- Stats and social proof important
+- Avoid consumer-style hype
+
+---
+
+## Copy Testing Priority
+
+When testing ad copy, focus on these elements in order of impact:
+
+1. **Hook/angle** (biggest impact on performance)
+2. **Headline**
+3. **Primary benefit**
+4. **CTA**
+5. **Supporting proof points**
+
+Test one element at a time for clean data.

package/departments/marketing/skills/paid-campaign/references/audience-targeting.md

@@ -0,0 +1,243 @@
+# Audience Targeting Reference
+
+Detailed targeting strategies for each major ad platform.
+
+## Contents
+- Google Ads Audiences (Search Campaign Targeting, Display/YouTube Targeting)
+- Meta Audiences (Core Audiences, Custom Audiences, Lookalike Audiences)
+- LinkedIn Audiences (Job-Based Targeting, Company-Based Targeting, High-Performing Combinations)
+- Twitter/X Audiences
+- TikTok Audiences
+- Audience Size Guidelines
+- Exclusion Strategy
+
+## Google Ads Audiences
+
+### Search Campaign Targeting
+
+**Keywords:**
+- Exact match: [keyword] — most precise, lower volume
+- Phrase match: "keyword" — moderate precision and volume
+- Broad match: keyword — highest volume, use with smart bidding
+
+**Audience layering:**
+- Add audiences in "observation" mode first
+- Analyze performance by audience
+- Switch to "targeting" mode for high performers
+
+**RLSA (Remarketing Lists for Search Ads):**
+- Bid higher on past visitors searching your terms
+- Show different ads to returning searchers
+- Exclude converters from prospecting campaigns
+
+### Display/YouTube Targeting
+
+**Custom intent audiences:**
+- Based on recent search behavior
+- Create from your converting keywords
+- High intent, good for prospecting
+
+**In-market audiences:**
+- People actively researching solutions
+- Pre-built by Google
+- Layer with demographics for precision
+
+**Affinity audiences:**
+- Based on interests and habits
+- Better for awareness
+- Broad but can exclude irrelevant
+
+**Customer match:**
+- Upload email lists
+- Retarget existing customers
+- Create lookalikes from best customers
+
+**Similar/lookalike audiences:**
+- Based on your customer match lists
+- Expand reach while maintaining relevance
+- Best when source list is high-quality customers
+
+---
+
+## Meta Audiences
+
+### Core Audiences (Interest/Demographic)
+
+**Interest targeting tips:**
+- Layer interests with AND logic for precision
+- Use Audience Insights to research interests
+- Start broad, let algorithm optimize
+- Exclude existing customers always
+
+**Demographic targeting:**
+- Age and gender (if product-specific)
+- Location (down to zip/postal code)
+- Language
+- Education and work (limited data now)
+
+**Behavior targeting:**
+- Purchase behavior
+- Device usage
+- Travel patterns
+- Life events
+
+### Custom Audiences
+
+**Website visitors:**
+- All visitors (last 180 days max)
+- Specific page visitors
+- Time on site thresholds
+- Frequency (visited X times)
+
+**Customer list:**
+- Upload emails/phone numbers
+- Match rate typically 30-70%
+- Refresh regularly for accuracy
+
+**Engagement audiences:**
+- Video viewers (25%, 50%, 75%, 95%)
+- Page/profile engagers
+- Form openers
+- Instagram engagers
+
+**App activity:**
+- App installers
+- In-app events
+- Purchase events
+
+### Lookalike Audiences
+
+**Source audience quality matters:**
+- Use high-LTV customers, not all customers
+- Purchasers > leads > all visitors
+- Minimum 100 source users, ideally 1,000+
+
+**Size recommendations:**
+- 1% — most similar, smallest reach
+- 1-3% — good balance for most
+- 3-5% — broader, good for scale
+- 5-10% — very broad, awareness only
+
+**Layering strategies:**
+- Lookalike + interest = more precision early
+- Test lookalike-only as you scale
+- Exclude the source audience
+
+---
+
+## LinkedIn Audiences
+
+### Job-Based Targeting
+
+**Job titles:**
+- Be specific (CMO vs. "Marketing")
+- LinkedIn normalizes titles, but verify
+- Stack related titles
+- Exclude irrelevant titles
+
+**Job functions:**
+- Broader than titles
+- Combine with seniority level
+- Good for awareness campaigns
+
+**Seniority levels:**
+- Entry, Senior, Manager, Director, VP, CXO, Partner
+- Layer with function for precision
+
+**Skills:**
+- Self-reported, less reliable
+- Good for technical roles
+- Use as expansion layer
+
+### Company-Based Targeting
+
+**Company size:**
+- 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5000+
+- Key filter for B2B
+
+**Industry:**
+- Based on company classification
+- Can be broad, layer with other criteria
+
+**Company names (ABM):**
+- Upload target account list
+- Minimum 300 companies recommended
+- Match rate varies
+
+**Company growth rate:**
+- Hiring rapidly = budget available
+- Good signal for timing
+
+### High-Performing Combinations
+
+| Use Case | Targeting Combination |
+|----------|----------------------|
+| Enterprise sales | Company size 1000+ + VP/CXO + Industry |
+| SMB sales | Company size 11-200 + Manager/Director + Function |
+| Developer tools | Skills + Job function + Company type |
+| ABM campaigns | Company list + Decision-maker titles |
+| Broad awareness | Industry + Seniority + Geography |
+
+---
+
+## Twitter/X Audiences
+
+### Targeting options:
+- Follower lookalikes (accounts similar to followers of X)
+- Interest categories
+- Keywords (in tweets)
+- Conversation topics
+- Events
+- Tailored audiences (your lists)
+
+### Best practices:
+- Follower lookalikes of relevant accounts work well
+- Keyword targeting catches active conversations
+- Lower CPMs than LinkedIn/Meta
+- Less precise, better for awareness
+
+---
+
+## TikTok Audiences
+
+### Targeting options:
+- Demographics (age, gender, location)
+- Interests (TikTok's categories)
+- Behaviors (video interactions)
+- Device (iOS/Android, connection type)
+- Custom audiences (pixel, customer file)
+- Lookalike audiences
+
+### Best practices:
+- Younger skew (18-34 primarily)
+- Interest targeting is broad
+- Creative matters more than targeting
+- Let algorithm optimize with broad targeting
+
+---
+
+## Audience Size Guidelines
+
+| Platform | Minimum Recommended | Ideal Range |
+|----------|-------------------|-------------|
+| Google Search | 1,000+ searches/mo | 5,000-50,000 |
+| Google Display | 100,000+ | 500K-5M |
+| Meta | 100,000+ | 500K-10M |
+| LinkedIn | 50,000+ | 100K-500K |
+| Twitter/X | 50,000+ | 100K-1M |
+| TikTok | 100,000+ | 1M+ |
+
+Too narrow = expensive, slow learning
+Too broad = wasted spend, poor relevance
+
+---
+
+## Exclusion Strategy
+
+Always exclude:
+- Existing customers (unless upsell)
+- Recent converters (7-14 days)
+- Bounced visitors (<10 sec)
+- Employees (by company or email list)
+- Irrelevant page visitors (careers, support)
+- Competitors (if identifiable)

package/departments/marketing/skills/paid-campaign/references/b2b-paid-playbook.md

@@ -0,0 +1,115 @@
+# B2B Paid Playbook
+
+Cross-platform operating rules for B2B paid acquisition — where sales cycles run 2–24 months, in-platform conversions mislead, and lead *quality* matters more than lead cost. Use this alongside the platform playbooks ([Meta decision system](meta-decision-system.md), [LinkedIn](linkedin-b2b-playbook.md), [Google Search](google-search-playbook.md), [ABM](abm-playbook.md)).
+
+## Contents
+
+- The Demand Lifecycle (5 stages, past the funnel)
+- Budget by stage
+- Leading vs. lagging signals
+- Unit economics: breakeven CPL and CPC
+- Kill rules
+- The optimize-to-quality trap (and the offline conversion loop)
+- Lead quality scoring (Urgency / Budget / Fit)
+- The scaling quadrant
+- Measurement maturity check
+- Channel selection
+
+## The Demand Lifecycle (5 stages, past the funnel)
+
+TOFU/MOFU/BOFU stops at conversion. B2B revenue doesn't — closed-lost deals, open pipeline, and existing customers are all addressable with ads. Plan across five stages:
+
+| Stage | Outcome | Buyer awareness | Typical offers | KPIs |
+|-------|---------|-----------------|----------------|------|
+| **Create** | Build affinity & trust | Unaware / Problem-aware | Educational content, POV | Cost per consumption, blended cost/opp |
+| **Capture** | Convert in-market buyers | Solution / Product-aware | Demos, trials | Pipe-to-spend, direct cost/opp |
+| **Accelerate** (sales-led) / **Activate** (product-led) | Close open deals faster / convert free users | Product / Offer-aware | Case studies, webinars, events | Pipeline velocity, paid signups |
+| **Revive** | Restart closed-lost | Offer-aware | Incentivized demos, guided trials | SQOs created, cost/SQO |
+| **Expand** | Grow existing accounts | Most aware | Referral programs, new-feature content | Expansion revenue, influenced SQOs |
+
+**Build bottom-up for fastest ROI**: Expand → Revive → Accelerate/Activate → Capture → Create. The bottom stages are cheap, small-audience, and quick to pay back; Create is the biggest and slowest investment. Most teams build top-down and burn months waiting for ROI.
+
+## Budget by stage
+
+| Stage | Budget size | Time to ROI | Difficulty |
+|-------|------------|-------------|------------|
+| Create | High | 90+ days | High (needs strong content + POV) |
+| Capture | Moderate | <45 days | High (expensive, competitive) |
+| Accelerate/Activate | Low | Tracks sales cycle | Low |
+| Revive | Low | <45 days | Low |
+| Expand | Low | <60 days | Medium (small audiences) |
+
+Weight by motion: product-led skews budget to Create + Capture; sales-led with a small TAM skews to Create + Accelerate. The stage with the most *pipeline* isn't automatically the stage that deserves the most *budget* — fund where pipeline share exceeds budget share and the audience is under-penetrated.
+
+## Leading vs. lagging signals
+
+You can't optimize on closed-won when deals close in 6 months. Split every stage's metrics:
+
+- **Leading** (moves in <1 month — optimize on these): CTR, engagement, CPL, cost per qualified lead, accounts reached
+- **Lagging** (moves in >1 month — the truth, reviewed monthly/quarterly): pipe-to-spend, influenced revenue, time-to-close, expansion revenue
+
+The leading metric must demonstrably correlate with the lagging one — a proxy metric worth optimizing is measurable, moveable, not an average, and hard to game. If CPL falls while pipeline doesn't move, the proxy broke; fix the proxy, not the ads.
+
+## Unit economics: breakeven CPL and CPC
+
+Derive targets from deal math, not platform benchmarks:
+
+- **Breakeven CPL** = average deal size × lead-to-close rate. ($3,000 ACV × 10% close = $300 CPL.)
+- **Breakeven CPC** = target CPL × landing page conversion rate. ($300 CPL × 5% LP conversion = $15 CPC.)
+
+Set the actual target below breakeven by your required margin. Every kill rule and scaling decision keys off this number.
+
+## Kill rules
+
+Two hard rules that remove emotion from pausing decisions:
+
+- **Non-performer rule** (new ads, any time): pause once an ad has spent **2–3× target CPL with zero conversions**. Target CPL $300 → kill at $600–900 spent, no conversions.
+- **Maintenance rule** (ads past ~7–14 days): pause when an ad's CPL runs **1.5–2× over target**. Target $300 → kill at $450–600 CPL.
+
+These aren't statistically rigorous — they're repeatable, cheap to apply, and better than deciding by mood. Never pause a producer without a replacement staged (see the swap rules in the [Meta decision system](meta-decision-system.md)).
+
+## The optimize-to-quality trap (and the offline conversion loop)
+
+Smart bidding optimizes toward whatever you call a "conversion." Feed it raw form-fills and it will buy you cheap junk form-fills — CPL improves while pipeline dies. The fix, in order:
+
+1. **Close the offline conversion loop.** Push CRM stage changes (MQL → SQL → opportunity → closed-won) back to the ad platforms — GCLID + offline import on Google, CAPI lifecycle events on Meta, conversion API on LinkedIn. This is the single highest-impact move in a B2B ad account: the algorithm starts buying pipeline instead of form-fills.
+2. **Value conversions differently.** A demo request is not an ebook download.
+3. **Until offline data flows, keep a human reading lead quality weekly** — job titles and companies, not just CPL.
+
+Reconcile platform-reported conversions against the CRM monthly. When they disagree, **the CRM wins**.
+
+## Lead quality scoring (Urgency / Budget / Fit)
+
+The platform can't see lead quality — score it yourself and rank ads by it:
+
+- **Urgency** (0–3): 0 browsing → 3 burning need with timeline
+- **Budget** (0–3): 0 none/no authority → 3 approved and ready
+- **Fit** (0–3): 0 not ICP → 3 perfect ICP
+
+Whoever runs the sales calls scores each lead (max 9) and logs it against the originating ad. After ~20 scored calls, **rank ads by average quality score, not CPL or CTR** — the ad with the best CPL is regularly the one producing 3/9 leads. Scale the high-score ads; kill variations whose average drops below ~5.
+
+## The scaling quadrant
+
+Route scaling tactics by your actual constraint:
+
+| | Low effort | High effort |
+|---|---|---|
+| **High budget** | **Audiences** — bigger audiences, more segments, more frequency | **Geography** — new countries/regions (localization work) |
+| **Low budget** | **Ads** — new creative, angles, formats | **Objectives & bids** — change objective or bid strategy to buy cheaper |
+
+- Have budget but no time → work the top row (audiences, then geo).
+- Need scale but capped on budget → work the bottom row (better creative and cheaper bidding free up money).
+
+## Measurement maturity check
+
+Before scaling spend, score yourself 1–3 on each: blended pipeline dashboard; per-channel dashboard; conversion tracking (1 = none, 2 = pixel only, 3 = offline conversions flowing); web analytics; a documented, agreed attribution process. Under ~6/15, fix visibility before adding budget — you're flying blind and every optimization is a guess. Fix the lowest score first.
+
+## Channel selection
+
+Five channel families: paid social, paid search, **paid review listings** (G2, Capterra, Software Advice — often skipped, high intent), programmatic (display, audio, CTV, native), and sponsorships (newsletters, podcasts, events, creators). Evaluate on four axes: can you actually target your ICP; media cost (CPC/CPM); reach at your targeting; platform policy for your industry.
+
+Before committing to a new channel, **run a ~$100 test campaign** to learn its real CPC/CPM for your targeting — platform estimates and published benchmarks are consistently wrong for specific ICPs.
+
+---
+
+*Framework lineage: several operating rules in this file are adapted (re-expressed, restructured, and extended) from practitioner playbooks, notably Ivan Falco's ads-skills. Benchmarks and thresholds are practitioner-reported starting points — always recalibrate against your own account's first 30 days.*