absolute-marketing
Unified marketing skill for every channel and stage. Use when writing copy, optimizing conversions, planning content strategy, running SEO audits, building email sequences, launching products, setting up paid ads, designing pricing, running A/B tests, crafting brand positioning, or any marketing task. Replaces individual skills for copywriting, SEO, content marketing, email, social media, growth hacking, brand strategy, and CRO.
marketing marketingseocopywritinggrowthcrobrandWhat is absolute-marketing?
Unified marketing skill for every channel and stage. Use when writing copy, optimizing conversions, planning content strategy, running SEO audits, building email sequences, launching products, setting up paid ads, designing pricing, running A/B tests, crafting brand positioning, or any marketing task. Replaces individual skills for copywriting, SEO, content marketing, email, social media, growth hacking, brand strategy, and CRO.
Quick Start
- Open your terminal or command prompt
- Run:
npx skills add AbsolutelySkilled/AbsolutelySkilled --skill absolute-marketing - Start your AI coding agent (Claude Code, Cursor, Gemini CLI, or any supported agent)
- The absolute-marketing skill is now active and ready to use
absolute-marketing
absolute-marketing is a production-ready AI agent skill for claude-code, gemini-cli, openai-codex, mcp. The unified marketing skill covering content, copy, SEO, email, social, paid ads, CRO, brand, growth, pricing, launches, and measurement.
Quick Facts
| Field | Value |
|---|---|
| Category | marketing |
| Version | 0.1.0 |
| Platforms | claude-code, gemini-cli, openai-codex, mcp |
| License | MIT |
How to Install
- Make sure you have Node.js installed on your machine.
- Run the following command in your terminal:
npx skills add AbsolutelySkilled/AbsolutelySkilled --skill absolute-marketing- The absolute-marketing skill is now available in your AI coding agent (Claude Code, Gemini CLI, OpenAI Codex, etc.).
Overview
Absolute Marketing is the unified marketing skill that replaces 10+ individual marketing skills with a single, comprehensive orchestrator. It covers every marketing channel and stage: copywriting and persuasion frameworks, content strategy and editorial calendars, SEO (traditional + AI search optimization), email campaigns and cold outreach, social media and community, paid advertising, conversion rate optimization, brand positioning, growth engineering, pricing strategy, product launches, A/B testing, and marketing analytics. The skill uses a product marketing context document as its foundation, ensuring all recommendations are tailored to your specific product, audience, and goals. It includes 13 deep-reference files covering specialized domains and a library of 139 proven marketing tactics organized by stage, budget, and use case.
Tags
marketing seo copywriting growth cro brand
Platforms
- claude-code
- gemini-cli
- openai-codex
- mcp
Related Skills
Pair absolute-marketing with these complementary skills:
Frequently Asked Questions
What is absolute-marketing?
The unified marketing skill for AI agents. Use it for any marketing task: writing copy, planning content, running SEO audits, building email sequences, launching products, setting up paid ads, designing pricing, running A/B tests, or crafting brand positioning. It replaces individual skills for copywriting, SEO, content marketing, email, social media, growth hacking, brand strategy, and CRO.
How do I install absolute-marketing?
Run npx skills add AbsolutelySkilled/AbsolutelySkilled --skill absolute-marketing in your terminal. The skill will be immediately available in your AI coding agent.
What AI agents support absolute-marketing?
This skill works with claude-code, gemini-cli, openai-codex, mcp. Install it once and use it across any supported AI coding agent.
Does it replace my existing marketing skills?
Yes. absolute-marketing consolidates content-marketing, copywriting, brand-strategy, keyword-research, email-marketing, social-media-strategy, aeo-optimization, growth-hacking, content-seo, and seo-mastery into a single unified skill with 13 deep-reference files.
Maintainers
Generated from AbsolutelySkilled
SKILL.md
📣 You are now the user's full-stack marketing partner.
Absolute Marketing
The unified marketing skill - covering content, copy, SEO, email, social, paid ads, CRO, brand, growth, pricing, launches, and measurement. One skill to replace them all.
This skill works for any business type: SaaS, e-commerce, services, creators, agencies, local businesses - anyone who needs to market effectively.
When to use this skill
Use this skill when the user wants to:
- Write marketing copy, headlines, CTAs, landing pages, or product descriptions
- Plan or audit content strategy, editorial calendars, or topic clusters
- Optimize pages, signup flows, forms, or onboarding for conversions (CRO)
- Run SEO audits, keyword research, or optimize for AI search (AEO/GEO)
- Build email campaigns, drip sequences, cold outreach, or improve deliverability
- Create or optimize paid ad campaigns on Google, Meta, LinkedIn, or TikTok
- Design pricing, packaging, or monetization strategy
- Plan product launches, go-to-market strategy, or sales enablement materials
- Build brand positioning, voice guidelines, or messaging hierarchy
- Set up A/B tests, analytics tracking, or attribution models
- Design referral programs, reduce churn, or build growth loops
- Create social media content, calendars, or community engagement plans
Do NOT use this skill for:
- UI/UX design or frontend implementation (use frontend-design or ui-ux-pro-max)
- Product management or roadmap prioritization (use product-strategy)
Step 0: Product Marketing Context
Before any marketing work, check if .agents/product-marketing-context.md exists.
If it exists: Read it silently. Use it to tailor all recommendations to the user's product, audience, and positioning. Do not ask the user to repeat information already captured.
If it does NOT exist: Ask the user which path they prefer:
Path A - Auto-Draft (recommended): Scan the repo for README, landing page copy, package.json, meta tags, marketing pages, and any existing brand or messaging docs. Draft a V1 context doc covering the sections below. Present it for review.
Path B - Guided Build: Walk through each section conversationally. One section at a time. Do not dump all questions at once.
Context Document Template
# Product Marketing Context
## 1. Product Overview
What the product does in 1-2 sentences. Core value proposition.
## 2. Target Audience
Who buys this. Be specific: role, company size, industry, geography.
## 3. Personas (2-3 max)
For each: Role, goals, frustrations, how they evaluate solutions.
## 4. Problems & Pain Points
Top 3-5 problems the product solves. Use customer language.
## 5. Competitive Landscape
- Direct competitors (same solution, same problem)
- Secondary competitors (different solution, same problem)
- Indirect competitors (conflicting approach)
## 6. Differentiation
What makes you different. Not features - positioning.
## 7. Objections & Anti-Personas
Common objections from prospects. Who is NOT a fit.
## 8. Switching Dynamics (JTBD Four Forces)
- Push: Frustrations with current solution
- Pull: What attracts them to you
- Habit: What keeps them on current solution
- Anxiety: Worries about switching
## 9. Customer Language
Verbatim phrases from customers. Exact words > polished descriptions.
## 10. Brand Voice
Personality, vocabulary, rhythm, perspective. "We are X, we are not Y."
## 11. Proof Points
Metrics, case studies, logos, testimonials, awards.
## 12. Goals
Current marketing goals and success metrics.Save to .agents/product-marketing-context.md. Revisit quarterly.
For the full context-building workflow with VOC research methods and persona frameworks, load references/product-context.md.
Key Principles
- Customer language over marketing speak. Use their exact words. "We were drowning in spreadsheets" beats "manual process inefficiency."
- Fix the bottleneck first. If traffic is low, more CRO won't help. If traffic is high but conversions are low, more content won't help. Diagnose before prescribing.
- Searchable before shareable. Capture existing demand with SEO content first. Layer brand-building and social on top. Foundation before amplification.
- Test one thing at a time. Pre-commit to sample size. Stop peeking at results early. Document every test, winners AND losers.
- Specificity beats cleverness. "Save 4 hours every week" beats "streamline your workflow." Numbers, timeframes, concrete outcomes.
Domain Router
When the user's request matches a domain, load the corresponding reference file for deep guidance.
| User wants to... | Load this reference |
|---|---|
| Build or update product/audience context, run customer research, create personas | references/product-context.md |
| Optimize pages, signup flows, forms, onboarding, popups, or paywalls for conversions | references/conversion-optimization.md |
| Write copy, headlines, CTAs, content strategy, content calendars, lead magnets | references/content-and-copy.md |
| SEO audit, keyword research, technical SEO, AEO/GEO, programmatic SEO, schema markup | references/search-visibility.md |
| Email campaigns, drip sequences, cold email, deliverability, outreach | references/email-and-outreach.md |
| Paid ads (Google, Meta, LinkedIn), ad creative, analytics tracking, attribution | references/paid-and-performance.md |
| Growth loops, churn prevention, referral programs, pricing strategy, PLG, free tools | references/growth-and-retention.md |
| Brand positioning, voice and tone, messaging hierarchy, competitive positioning | references/brand-and-messaging.md |
| Apply psychology to marketing - persuasion, pricing psychology, behavioral design | references/marketing-psychology.md |
| Social media content, platform strategy, community building, engagement | references/social-and-community.md |
| Product launches, go-to-market, sales enablement, pitch decks, battle cards | references/launch-and-gtm.md |
| A/B testing, analytics setup, marketing KPIs, attribution models, RevOps | references/testing-and-measurement.md |
| Browse marketing ideas by stage, budget, or use case | references/ideas-library.md |
For requests spanning multiple domains, load the primary reference and cross-reference as needed.
Quick-Start Playbooks
These handle the most common requests without loading reference files.
Write a Positioning Statement
Use Geoffrey Moore's template:
"For [target audience] who [need/opportunity], [Brand] is the [category] that [key benefit]. Unlike [alternative], [Brand] [primary differentiator]."
Test it: Can someone unfamiliar with your product understand what you do and why you're different?
Audit a Landing Page (5-Minute CRO Check)
Check in this order - highest impact first:
- Value prop clarity - Can a visitor understand what you do in 5 seconds?
- Headline - Outcome-focused? Specific? ("Get [outcome] without [pain]")
- CTA - Action + benefit? ("Start My Free Trial" not "Submit")
- Social proof - Specific and relevant? (logos, metrics, testimonials)
- Objection handling - FAQ or comparison addressing top 3 concerns?
- Friction - Can they complete the action without unnecessary fields or steps?
Plan a Content Calendar
- Define 3-5 content pillars aligned to product value
- Map content types to funnel stages: TOFU (awareness), MOFU (consideration), BOFU (decision)
- Set cadence (2 posts/week minimum for SEO traction)
- Fields per entry: Title, target keyword, funnel stage, pillar, format, publish date, owner
- Plan 6-8 weeks ahead. Calendar without deadlines is fiction.
Build a Welcome Email Sequence (5 emails, 14 days)
- Immediate - Welcome + deliver promised value
- Day 1-2 - Quick win (one actionable tip)
- Day 3-4 - Story or "why we built this"
- Day 5-7 - Social proof (case study or testimonial)
- Day 10-14 - Conversion CTA (trial, demo, purchase)
Subject lines: under 50 chars, lowercase feels personal, questions drive opens.
Set Up an A/B Test
Hypothesis: Because [observation/data],
we believe [change] will cause [expected outcome]
for [audience]. We'll know when [metric] changes by [amount].- One variable per test. Pre-commit to sample size.
- Primary metric (one), secondary metrics (explain why), guardrail metrics (shouldn't get worse).
- Minimum 100 conversions per variant before reading results.
Plan a Product Launch
Use the ORB framework for channel selection:
- Owned (email, blog, community) - compound over time, no algorithm risk
- Rented (social, marketplaces) - speed, not stability
- Borrowed (guest content, partnerships, influencers) - instant credibility
Launch tiers: Tier 1 (new product, full GTM) | Tier 2 (major feature, blog + enablement) | Tier 3 (minor update, release notes) | Tier 4 (patch, changelog only)
Marketing Ideas Quick Reference
Need ideas? Load references/ideas-library.md for 139 proven marketing tactics organized by:
| Filter | Options |
|---|---|
| Stage | Pre-launch, Early, Growth, Scale |
| Budget | Free, Low, Medium, High |
| Timeline | Quick win (days), Medium (weeks), Long-term (months) |
Quick picks by situation:
- Need leads fast: Google Ads, LinkedIn Ads, free tool / calculator
- Building authority: Conference talks, podcast guesting, original research
- Low budget: SEO content, Reddit marketing, comment marketing, community building
- PLG focus: Viral loops, powered-by marketing, in-app upsells, freemium design
Anti-Patterns
- "Our target audience is everyone." Positioning that tries to win everyone wins no one. Get specific.
- Optimizing the wrong bottleneck. More CRO on a page with no traffic. More traffic to a page that doesn't convert. Diagnose first.
- Vanity metrics obsession. Followers, impressions, and page views feel good but don't pay bills. Track pipeline, revenue, activation.
- Copying competitor tactics without their context. Their audience, budget, and stage are different. Understand the principle, adapt the tactic.
- Content without distribution. Publishing and hoping is not a strategy. Every piece needs a distribution plan.
- Discounting as default response. Competing on price is a race to the bottom. Compete on value, positioning, and experience.
- Feature-listing instead of benefit-selling. "AI-powered analytics" means nothing. "Surface insights you'd miss manually" means everything.
- Launching once and moving on. Marketing compounds. The best channel is the one you stick with long enough to learn.
Gotchas
- No product context = generic advice. Always check for
.agents/product-marketing-context.mdbefore any recommendation. If missing, build it first. - Platform-specific rules change fast. LinkedIn penalizes external links in post body. Instagram now favors 3-5 hashtags (not 30). AI search engines update ranking factors monthly. Verify current best practices.
- AI search is eating clicks. AI Overviews appear in ~45% of Google searches and reduce clicks by up to 58%. Optimize for citation, not just ranking. Load
references/search-visibility.mdfor AEO/GEO strategy. - Email deliverability is infrastructure. SPF + DKIM + DMARC must be configured before any email marketing. Gmail clips HTML over 102KB. Apple MPP inflates open rates since iOS 15.
- Schema markup detection requires a browser.
web_fetchandcurlcannot reliably detect JSON-LD injected via client-side JavaScript. Use browser tools or Google Rich Results Test. - Sample size math is non-negotiable. At 1% baseline conversion and 10% minimum detectable effect, you need ~150K visitors per variant. Don't run tests you can't power.
References
All reference files live in the references/ directory. Load them on demand when the domain router points to them.
| Reference | Lines | Covers |
|---|---|---|
product-context.md |
~350 | Full context doc workflow, VOC research, persona frameworks, ICP definition |
conversion-optimization.md |
~390 | Page CRO, signup flows, onboarding, forms, popups, paywalls |
content-and-copy.md |
~380 | Persuasion frameworks, headlines, content strategy, calendars, lead magnets |
search-visibility.md |
~390 | SEO audit, keywords, technical SEO, AEO/GEO, programmatic SEO, schema |
email-and-outreach.md |
~370 | Email campaigns, sequences, cold email, deliverability |
paid-and-performance.md |
~370 | Google/Meta/LinkedIn ads, ad creative, analytics, attribution |
growth-and-retention.md |
~380 | AARRR, growth loops, churn, referrals, pricing, PLG, free tools |
brand-and-messaging.md |
~350 | Positioning, voice/tone, messaging, archetypes, competitive positioning |
marketing-psychology.md |
~400 | 40+ mental models: buyer psychology, persuasion, pricing, behavioral design |
social-and-community.md |
~350 | Platform strategy, content formats, calendars, community, engagement |
launch-and-gtm.md |
~370 | Launch phases, ORB framework, Product Hunt, sales enablement, GTM |
testing-and-measurement.md |
~350 | A/B testing, analytics, attribution, KPIs, RevOps |
ideas-library.md |
~400 | 139 proven marketing tactics by stage, budget, and use case |
References
brand-and-messaging.md
Brand and Messaging Reference
Positioning
Geoffrey Moore Positioning Statement
Template:
For [target customer] who [statement of need/opportunity], [Brand] is the [product category] that [key benefit/reason to buy]. Unlike [primary competitive alternative], [Brand] [primary differentiator].
Fill every bracket. If you cannot fill one, you have not done enough customer research.
Positioning Discipline
- Give positioning 18+ months before evaluating. Changing after 6 months wipes accumulated equity. You are starting over, not pivoting.
- Positioning that wins everyone wins no one. A strong position repels the wrong customers as clearly as it attracts the right ones.
- Test positioning with the "only we" filter: can a competitor copy-paste your statement and have it still be true? If yes, it is not positioning - it is a category description.
- Positioning lives upstream of all messaging. Change the positioning, and every headline, email, and sales deck must change with it.
- Validate with 10+ customer interviews before committing. Listen for their words, not yours.
Position Validation Checklist
- Target customer is specific enough to find in a room
- Need is something the customer already feels (not something you have to explain)
- Category is one the buyer already has budget for
- Benefit is measurable or clearly observable
- Differentiator is defensible for 18+ months
- A competitor cannot truthfully make the same claim
Brand Voice Framework
Define voice across four dimensions. Guidelines without examples are ignored - include 3-5 real examples per dimension.
1. Personality
Who the brand would be at a dinner party. Define 3-4 personality traits and their boundaries.
| We are | We are not |
|---|---|
| Confident | Arrogant |
| Approachable | Casual or sloppy |
| Direct | Blunt or dismissive |
| Curious | Scattered |
Examples:
- "Here is what we found after analyzing 2M data points" (confident, not arrogant)
- "Stuck on setup? Here is the fast path" (approachable, not casual)
- "This feature ships Tuesday" (direct, not dismissive)
2. Vocabulary
Words you use and words you never use. This is the fastest way to make voice tangible.
| Always use | Never use |
|---|---|
| "Build" | "Leverage" |
| "Ship" | "Utilize" |
| "People" | "Resources" (for humans) |
| "Problem" | "Pain point" |
| "Fast" | "Blazingly fast" |
Examples:
- "Build your first integration in 5 minutes" not "Leverage our platform to utilize integrations"
- "We help people ship faster" not "We empower resources to accelerate delivery"
- "This solves the problem of..." not "This addresses the pain point around..."
3. Rhythm
Sentence structure, paragraph length, punctuation patterns.
| Pattern | Guideline |
|---|---|
| Sentence length | 8-20 words average. Vary for cadence. |
| Paragraph length | 1-3 sentences max |
| Lists | Use bullets for 3+ items. Never nest more than one level. |
| Contractions | Yes in blog/docs, no in legal/enterprise |
| Punctuation | One exclamation mark per page maximum |
Examples:
- Short then long: "It ships today. We rebuilt the entire pipeline to handle 10x the volume without touching your existing configuration."
- Bullets over prose: Instead of a comma-separated list in a sentence, break it out.
- No stacking: "Amazing! Incredible! Game-changing!" - never do this.
4. Perspective
Point of view, tense, and how the brand relates to the reader.
| Choice | Default |
|---|---|
| Person | "You" for the customer, "We" for the company |
| Tense | Present for features, past for case studies |
| Authority | Earned through evidence, not claimed |
| Humor | Dry wit allowed, puns and memes avoided |
Examples:
- "You can deploy in one click" not "Users can deploy in one click"
- "We reduced latency by 40%" not "Latency was reduced by 40%"
- "Tested across 500 production environments" not "We are the industry leader"
Messaging Hierarchy
Three levels. No more. If you have more, you have a feature list, not a message.
Level 1: Primary Message (1 sentence)
The single core promise. If a customer remembers only one thing, this is it.
- Must be customer-outcome focused, not product-feature focused
- Should pass the "so what?" test three times
- Example: "Ship production-ready code in half the time"
Level 2: Supporting Messages (3-5 maximum)
Each supporting message proves the primary message is true from a different angle.
| Supporting Message | Proves Primary Because |
|---|---|
| "AI that understands your codebase" | Speed comes from context |
| "Catches bugs before they ship" | Speed without sacrificing quality |
| "Works in your existing editor" | No workflow disruption |
Level 3: Proof Points (2-3 per supporting message)
Concrete, verifiable evidence. Numbers, customer quotes, case studies, benchmarks.
- "Teams ship 47% more PRs per sprint (internal benchmark, n=200)"
- "Reduced bug escape rate by 62% at [Customer]"
- "Zero setup - works with VS Code, JetBrains, and Neovim"
Anti-pattern: The Feature List
Six or more equal-weight messages is a feature list, not a hierarchy. Symptoms:
- Every message starts with the product name
- Messages could be reordered without losing meaning
- No single message is clearly the most important
- Sales team picks a different "lead" message each call
Brand Archetypes
| Archetype | Core Desire | Example Brand | Voice Characteristics |
|---|---|---|---|
| Hero | Prove worth through courage | Nike | Bold, motivational, challenge-oriented |
| Sage | Understand the world | Informed, analytical, clear | |
| Explorer | Freedom to discover | Patagonia | Adventurous, independent, authentic |
| Rebel | Overturn what is not working | Harley-Davidson | Provocative, disruptive, unapologetic |
| Creator | Build something of lasting value | Apple | Visionary, innovative, refined |
| Caregiver | Protect and care for others | Johnson & Johnson | Warm, reassuring, nurturing |
| Ruler | Create order from chaos | Mercedes-Benz | Authoritative, commanding, premium |
| Magician | Make dreams real | Disney | Imaginative, transformative, wonder |
| Lover | Create connection and beauty | Chanel | Sensual, elegant, intimate |
| Jester | Live in the moment with joy | Old Spice | Witty, irreverent, entertaining |
| Everyman | Belong and connect | IKEA | Friendly, honest, practical |
| Innocent | Find happiness through simplicity | Coca-Cola | Optimistic, simple, wholesome |
Using Archetypes
- Pick one primary, one secondary. Never three.
- Archetype defines voice guardrails, not scripts.
- Test: would this archetype say this sentence? If not, rewrite.
- Archetype without behavioral commitments is a poster on the wall.
Brand Storytelling
Brand as Guide Framework
Adapted from the Hero's Journey. The customer is the hero. The brand is the guide.
| Stage | Role | Example |
|---|---|---|
| 1. Character | Customer with a desire | "Dev teams want to ship faster" |
| 2. Problem | External, internal, and philosophical | "Bugs slow releases. Devs feel frustrated. Quality should not require slowness." |
| 3. Guide appears | Brand demonstrates empathy + authority | "We have been there. We built this after 10 years in the trenches." |
| 4. Plan | Simple steps to engage | "Install. Connect your repo. Get your first review." |
| 5. Call to Action | Direct and transitional | "Start free" (direct). "See how it works" (transitional). |
| 6. Success | What life looks like after | "Teams shipping daily with confidence" |
| 7. Transformation | Identity shift | "From firefighting team to engineering team" |
Founding Story Structure
Every company needs an origin story. Structure it as:
- Frustration - The founder experienced the problem firsthand
- Failed alternatives - Existing solutions did not work because...
- Solution moment - The insight that changed everything
- Early validation - First customers confirmed it was real
- Vision - Where this leads if it works at scale
Keep it under 200 words. Tell it in first person. Include one specific, concrete detail that makes it feel real ("at 2 AM staring at a failing deploy" not "we experienced challenges").
Competitive Positioning
2x2 Positioning Map
Build a 2x2 matrix with axes that matter to buyers (not to you).
Rules:
- X-axis and Y-axis must represent real buyer decision criteria
- You must credibly own the top-right quadrant
- If you cannot, choose different axes
- Update the map when a competitor shifts position
- Never use "quality" or "innovation" as axes - they are too vague
Comparison Page Formats
Four proven formats for competitive pages:
| Format | URL Pattern | Use When |
|---|---|---|
| [Competitor] Alternative | /alternative-to-competitor | You are a direct replacement |
| [Competitor] Alternatives | /competitor-alternatives | You are one of several options (SEO play) |
| You vs [Competitor] | /you-vs-competitor | Head-to-head evaluation |
| [Competitor A] vs [Competitor B] | /a-vs-b | Capture comparison traffic you are not in |
Comparison Page Principles
- Honesty builds trust. Acknowledge competitor strengths explicitly.
- Be clear about who the competitor is best for. "If you need X, they are the better choice."
- Lead with the criteria that matter, not the criteria where you win.
- Include pricing if public. Do not if it is not.
- For "[Competitor] Alternatives" pages, include 4-7 alternatives (including yourself).
- Update quarterly for pricing and feature changes. Full rewrite annually.
Competitive Positioning Rules
- Never trash-talk. State facts. Link to sources.
- Compete on the dimension where you are genuinely strongest.
- If a competitor is better at something, say so and explain why your trade-off is intentional.
- Screenshot competitor UIs only with permission or from public marketing pages.
- Comparison tables must be verifiable. Every claim needs a source.
Brand Guidelines (Minimum Viable)
A brand guide that nobody reads is worse than no guide. Keep it under 15 pages. Version it.
The 8 Required Sections
| Section | Content | Length |
|---|---|---|
| 1. Promise | One sentence the brand commits to | 1 paragraph |
| 2. Positioning | Moore statement + context | 1 page |
| 3. Audience | Primary and secondary personas | 1 page |
| 4. Archetype | Primary + secondary with rationale | 0.5 page |
| 5. Voice and Tone | We are/we are not + examples per dimension | 2-3 pages |
| 6. Messaging hierarchy | Three levels with proof points | 1-2 pages |
| 7. Vocabulary | Use/avoid word lists with reasoning | 1 page |
| 8. Channel tone adaptations | How voice flexes by channel | 1-2 pages |
Channel Tone Adaptations
| Channel | Tone Shift | Example |
|---|---|---|
| Website homepage | Confident, concise | "Ship faster. Break nothing." |
| Blog | Conversational, detailed | "Here is how we rebuilt our pipeline..." |
| Email nurture | Helpful, direct | "Three tips to reduce deploy time" |
| Social media | Casual, punchy | "Deployed 47 times today. On a Monday." |
| Sales deck | Authoritative, outcome-focused | "Teams using X see 40% faster cycle times" |
| Support docs | Clear, empathetic | "If you see this error, here is the fix." |
| Error messages | Human, specific | "That file is too large (max 50MB). Try compressing it." |
Brand Audit
Rate each dimension 1-5. Audit quarterly. Track trends over time.
5 Audit Dimensions
| Dimension | 1 (Poor) | 3 (Adequate) | 5 (Excellent) |
|---|---|---|---|
| Voice consistency | Different voice per channel | Most channels aligned | Indistinguishable across all touchpoints |
| Message clarity | Customers cannot repeat your value prop | Some recall core message | Customers articulate your value in their words |
| Positioning differentiation | Interchangeable with competitors | Clear category but fuzzy difference | Customers name you as "the one that..." |
| Audience alignment | Messaging speaks to everyone | Primary audience addressed | Messaging makes target feel "this is for me" |
| Promise delivery | Product contradicts brand promise | Product meets stated expectations | Product exceeds promise; creates advocacy |
Audit Process
- Collect samples from every active channel (last 90 days)
- Score each dimension independently with 2+ reviewers
- Identify the lowest-scoring dimension - that is your priority
- Set a target score and timeline for improvement
- Re-audit in 90 days against the same criteria
Brand Pyramid
Build from the base up. Each level must be earned, not declared.
/\
/ \
/ BC \ Brand Character
/ \ (personality, archetype, voice)
/--------\
/ EB \ Emotional Benefits
/ \ (how customers feel using the product)
/--------------\
/ FA \ Functional Attributes
/ \ (what the product actually does)
/--------------------\- Functional Attributes (base): Concrete capabilities. "Scans code in 200ms." You must deliver here first.
- Emotional Benefits (middle): How it makes them feel. "Confident deploying on Friday." Earned through consistent functional delivery.
- Brand Character (peak): The personality that ties it together. "The expert friend who has your back." Only credible if the lower layers are solid.
Anti-pattern: starting at the top. You cannot define brand character before you know what functional attributes customers actually value.
Anti-Patterns
| Anti-Pattern | Why It Fails | Fix |
|---|---|---|
| Archetype without behavioral commitments | Becomes a poster, not a guide | Define 5+ "would/would not say" examples per archetype |
| Copying competitor voice | You become a worse version of them | Start from customer interviews, not competitor analysis |
| Changing voice quarterly | Destroys recognition and trust | Commit for 18+ months. Iterate tone, not voice. |
| Guidelines nobody reads | Wasted effort, inconsistent output | Under 15 pages. Include real examples. Test with new hires. |
| Over-investing in brand before PMF | Polish on something that will change | Minimum viable brand: positioning + voice + vocabulary only |
| Six equal-weight messages | Feature list, not messaging | Force-rank. One primary. Three to five supporting. |
| Aspirational positioning | Claims you cannot back with evidence | Position on what is true today, not what you hope for next year |
| "We are the leading..." | Unverifiable, everyone says it | Replace with specific, provable claims |
| Internal jargon in external copy | Customers do not speak your language | Use customer interview transcripts as vocabulary source |
| Brand guide as PDF | Static, out of date, unfindable | Living document with version history and owner |
content-and-copy.md
Content and Copywriting Reference
Copywriting Fundamentals
Style Rules (Ranked)
- Simple > Complex - Write at an 8th-grade reading level. Shorter sentences win.
- Specific > Vague - "2,847 teams" beats "many customers." Numbers, names, dates.
- Active > Passive - "We built X" not "X was built by us."
- Confident > Qualified - "This works" not "This might potentially work."
- Show > Tell - Demo the result, don't describe it. Screenshots, data, stories.
- Honest > Sensational - Credibility compounds. Hype erodes trust fast.
Words to Cut
Remove these filler words on every editing pass:
- very
- really
- extremely
- just
- actually
- basically
- "in order to" (replace with "to")
- quite
- literally
- certainly
- definitely
- essentially
Words to Replace
| Instead of | Write |
|---|---|
| Utilize | Use |
| Implement | Set up |
| Leverage | Use |
| Facilitate | Help |
| Innovative | New |
| Robust | Strong |
| Seamless | Smooth |
| Optimize | Improve |
| Synergy | Teamwork |
| Paradigm | Model |
| Holistic | Complete |
| Scalable | Grows with |
Persuasion Frameworks
AIDA - Attention, Interest, Desire, Action
Best for: landing pages, ads, sales pages.
- Attention - Bold headline or surprising stat that stops the scroll.
- Interest - Expand the promise. Show you understand their world.
- Desire - Paint the outcome. Social proof, specifics, transformation.
- Action - Single, clear CTA. Remove friction.
PAS - Problem, Agitate, Solve
Best for: email sequences, blog intros, cold outreach.
- Problem - Name the pain they already feel.
- Agitate - Twist the knife. Show the cost of inaction.
- Solve - Present your solution as the natural relief.
BAB - Before, After, Bridge
Best for: case studies, testimonials, brand stories.
- Before - Their current painful state (relatable).
- After - The transformed state (aspirational).
- Bridge - How your product/service gets them there.
Headline Formulas
| # | Pattern | Template | Example |
|---|---|---|---|
| 1 | How-to | How to [Achieve X] Without [Pain Y] | How to Double Revenue Without Hiring More Reps |
| 2 | Number list | [N] [Adjective] Ways to [Desired Outcome] | 7 Proven Ways to Cut Cloud Costs by 40% |
| 3 | Question | Are You Still [Old Way]? | Are You Still Tracking Leads in Spreadsheets? |
| 4 | Direct benefit | Get [Outcome] in [Timeframe] | Get 10x More Demo Requests in 30 Days |
| 5 | Social proof | How [Known Entity] [Achieved Result] | How Stripe Reduced Churn to Under 2% |
| 6 | Before/After | From [Pain State] to [Desired State] | From 4-Hour Deploys to 4-Minute Deploys |
| 7 | Warning | [N] [Mistakes/Myths] That [Negative Outcome] | 5 Pricing Mistakes That Kill SaaS Growth |
| 8 | Secret | The [Adjective] Secret to [Outcome] | The Counterintuitive Secret to Higher Retention |
| 9 | Challenge | Can You [Achieve X] in [Timeframe]? | Can You Ship a Feature in Under 2 Hours? |
| 10 | Fascination | What [Surprising Entity] Teaches Us About [Topic] | What Netflix Teaches Us About Onboarding UX |
Landing Page Structure
7-Section Framework
- Hero - Headline (benefit-driven, under 10 words) + subheadline (expand the promise) + primary CTA + social proof nugget (e.g., "Trusted by 2,847 teams").
- Problem/Pain - Name 3 specific pains your audience recognizes. Use their words. Quote real customers if possible.
- Solution/Benefits - 3-5 outcomes (not features). Format: icon + outcome headline + 1-sentence explanation. Lead with the biggest transformation.
- How It Works - 3-4 numbered steps. Keep each step to one sentence. Visual aids help. End the sequence at the happy outcome.
- Social Proof - Logos, testimonials with photos and titles, specific metrics ("Cut onboarding from 3 weeks to 3 days"). Mix formats: quotes, case study snippets, rating badges.
- Objection Handling - FAQ section addressing top 3-5 concerns: price, switching cost, security, time to value, support quality.
- Final CTA - Restate the core benefit. Single button. Remove all other navigation. Add risk reversal (free trial, guarantee, easy cancel).
CTA Writing
Core Formula
[Action Verb] + [What They Get]
Good: "Start Your Free Trial" / "Download the Playbook" / "See It in Action" Bad: "Submit" / "Click Here" / "Learn More" (too vague)
Temperature Matching
| Audience Temp | Mindset | CTA Examples |
|---|---|---|
| Cold | Just discovered you | Learn How, See Examples, Read Guide |
| Warm | Evaluating options | Start Free Trial, Book a Demo, Try It |
| Hot | Ready to buy | Buy Now, Get Started, Upgrade Today |
Power Words by Category
- Urgency: Now, Today, Limited, Before, Deadline, Last chance, Instant
- Exclusivity: Members-only, Invite-only, Private, VIP, Inner circle, Early access
- Curiosity: Secret, Surprising, Little-known, Behind the scenes, Revealed
- Credibility: Proven, Backed by data, Research-based, Certified, Trusted by
- Ease: Simple, Quick, Effortless, One-click, No-code, In minutes, Zero setup
Content Strategy
Searchable vs Shareable Content
- Searchable (SEO): Answers existing demand. Compounds over time. Build this first.
- Shareable (Social): Creates new demand. Spiky traffic. Layer this on after SEO foundation.
- Ratio: Start 70% searchable / 30% shareable. Shift as brand grows.
Content Prioritization Scoring
| Factor | Weight | Score 1-5 Criteria |
|---|---|---|
| Customer Impact | 40% | Does it answer real customer questions/pains? |
| Content-Market Fit | 30% | Can we credibly own this topic? |
| Search Potential | 20% | Monthly search volume and ranking feasibility |
| Resources Required | 10% | Can we produce this at quality with current team? |
Score = (Impact x 0.4) + (Fit x 0.3) + (Search x 0.2) + (Resources x 0.1)
Funnel Content Map
| Stage | Goal | Content Types |
|---|---|---|
| TOFU | Awareness | Blog posts, infographics, social content, podcasts |
| MOFU | Consideration | Case studies, webinars, comparison guides, whitepapers |
| BOFU | Decision | Free trials, demos, ROI calculators, pricing pages |
Content Types and Lengths
| Type | Word Count | Purpose |
|---|---|---|
| Blog post | 1,000-3,000 | SEO, education, thought leadership |
| Pillar page | 3,000-6,000 | Topical authority, link hub |
| Case study | 800-1,500 | Social proof, BOFU conversion |
| Whitepaper | 2,000-8,000 | Lead generation, credibility |
| 50-300 | Nurture, conversion | |
| Social post | 50-280 | Awareness, engagement |
Pillar-Cluster Architecture
Structure
- Pillar page: 2,000-5,000 words. Broad topic overview. Links out to every cluster page.
- Cluster pages: 1,000-2,500 words each. Deep-dive into subtopic. Links back to pillar and to sibling clusters.
- Bidirectional linking: Every cluster links to its pillar. Pillar links to every cluster. This signals topical authority to search engines.
Content Calendar Fields
| Field | Purpose |
|---|---|
| Title | Working headline |
| Keyword | Primary target keyword |
| Funnel stage | TOFU / MOFU / BOFU |
| Pillar | Parent pillar page |
| Format | Blog, video, infographic, etc. |
| Persona | Target audience segment |
| Date | Publish date |
| Owner | Writer or content lead |
| Status | Ideation / Draft / Review / Live |
Publishing Cadence
- Minimum 2 posts/week for SEO traction.
- Plan 6-8 weeks ahead to maintain buffer.
- Batch production: research week, writing week, editing week.
- Repurpose every pillar into at least 5 derivative pieces.
Content Repurposing
One Blog Post to 12+ Derivatives
| # | Derivative | Effort | Channel |
|---|---|---|---|
| 1 | Twitter/X thread | 15 min | Twitter/X |
| 2 | LinkedIn post | 15 min | |
| 3 | Email newsletter | 20 min | |
| 4 | Carousel | 30 min | LinkedIn, Instagram |
| 5 | Video script | 30 min | YouTube, TikTok |
| 6 | Podcast points | 15 min | Podcast |
| 7 | Infographic | 1-2 hr | Pinterest, blog embed |
| 8 | Slide deck | 1 hr | SlideShare, webinars |
| 9 | Quote graphics | 15 min | Instagram, Twitter/X |
| 10 | Checklist | 15 min | Lead magnet, blog CTA |
| 11 | Webinar segment | 30 min | Live events |
| 12 | Expanded guide | 2-4 hr | Gated download |
Copy Editing: The Seven Sweeps
Run these passes sequentially on every piece of marketing copy:
Sweep 1: Clarity
- Can a 13-year-old understand this sentence?
- One idea per sentence. One theme per paragraph.
- Kill jargon unless your audience uses it daily.
Sweep 2: Voice and Tone
- Does it sound like our brand, not a textbook?
- Read it aloud. If you stumble, rewrite.
- Match tone to context: casual for social, professional for whitepapers.
Sweep 3: So What
- Every claim must answer: "Why should I care?"
- If a sentence doesn't serve the reader, cut it.
- Test: add "So what?" after each paragraph. If you can't answer, rewrite or remove.
Sweep 4: Prove It
- Replace opinions with evidence: data, quotes, screenshots, examples.
- "Best-in-class" means nothing without proof. Show, don't claim.
- Attribution builds trust. Link to sources.
Sweep 5: Specificity
| Vague | Specific |
|---|---|
| Save time | Save 4 hours every week |
| Many customers | 2,847 teams in 40 countries |
| Fast results | Results in 14 days |
| Significant savings | Cut costs by 37% |
| Industry-leading | #1 rated on G2 for 3 years |
Sweep 6: Emotion
- What feeling should the reader have after each section?
- Use sensory language and concrete imagery.
- Stories beat statistics for emotional connection (but use both).
Sweep 7: Zero Risk
- Have you addressed every objection?
- Is the CTA frictionless? (No unnecessary form fields, clear next step)
- Money-back guarantee, free trial, easy cancel - remove buyer anxiety.
Lead Magnets
Types by Effort
| Type | Creation Time | Best For |
|---|---|---|
| Checklist | 1-2 hours | Quick wins, actionable takeaways |
| Cheat sheet | 2-4 hours | Reference material, shortcuts |
| Template | 2-8 hours | Reusable frameworks, fill-in |
| Swipe file | 4-8 hours | Examples, proven copy/designs |
| Ebook | 1-3 weeks | Comprehensive guides, authority |
Design Principles
- Solve a specific problem (not "everything about marketing").
- High perceived value + low time to consume (under 15 minutes ideal).
- Natural path to your product ("If you liked this checklist, the tool automates steps 3-7").
- Make it look professional - design quality signals content quality.
Gating Strategy
- Email only = highest conversion rate.
- Each additional form field reduces conversion by 5-10%.
- Name + email is the max for most lead magnets.
- Use progressive profiling for returning visitors.
Conversion Benchmarks
| Traffic Source | Expected Rate |
|---|---|
| Warm (existing audience) | 20-40% |
| Cold (paid/organic) | 5-15% |
| Content upgrades (inline) | 2-5x better than sidebar CTAs |
| Exit-intent popups | 2-4% |
Value Proposition Template
[Product] helps [target audience] [achieve specific outcome]
by [unique mechanism] so they can [deeper emotional benefit].Examples
- "Acme helps B2B SaaS teams reduce churn by 30% by predicting at-risk accounts 60 days early so they can hit revenue targets without panic."
- "Relay helps remote managers run effective 1:1s by auto-generating agendas from async updates so they can spend less time on status and more on coaching."
Testing Hierarchy
- Does the target audience recognize themselves?
- Is the outcome specific and measurable?
- Is the mechanism believable and differentiated?
- Does the deeper benefit resonate emotionally?
If any answer is no, rewrite that component.
conversion-optimization.md
Conversion Rate Optimization (CRO) Reference
Page CRO Framework
Analysis Priority Order
Work top-down. Fixing lower items while upper items are broken wastes effort.
- Value Prop Clarity - Can a visitor explain what you do in 5 seconds?
- Headline - Does it communicate the outcome, not the feature?
- CTA - Is the next action obvious and compelling?
- Visual Hierarchy - Does the eye flow toward the conversion action?
- Trust Signals - Are there logos, testimonials, or security badges?
- Objection Handling - Are common hesitations addressed before the CTA?
- Friction - Are there unnecessary fields, steps, or distractions?
Headline Patterns
| Pattern | Template | Example |
|---|---|---|
| Outcome-focused | [Achieve outcome] without [pain point] |
"Ship 2x faster without breaking prod" |
| Social proof | [N] [users] trust [product] to [outcome] |
"12,000 teams trust Acme to manage deploys" |
| Specific benefit | [Verb] your [metric] by [amount] in [time] |
"Cut your build times by 60% in one sprint" |
| Question | [Struggling with / Tired of] [pain point]? |
"Tired of debugging config drift at 2am?" |
Rules: One headline per page. Under 12 words. Test headline before anything else - it moves the needle more than any other element.
CTA Optimization
| Weak CTA | Strong CTA | Why |
|---|---|---|
| Submit | Start Free Trial | Action + what they get |
| Sign Up | Get My Dashboard | First-person + specific outcome |
| Learn More | See It In Action | Implies low commitment |
| Download | Get the Free Guide | Specificity + value framing |
| Buy Now | Start Saving Today | Outcome-oriented |
CTA Formula: [Action Verb] + [What They Get]
First-person CTAs ("Get My Report") outperform third-person ("Get Your Report") by ~90% on warm audiences. However, first-person backfires on cold audiences who have no relationship with the brand yet.
Match CTA temperature to audience:
- Cold (ads, cold email): Low commitment. "See How It Works", "Watch Demo"
- Warm (blog readers, retargeted): Medium commitment. "Start Free Trial", "Get the Guide"
- Hot (pricing page, returning users): Direct. "Start My Plan", "Upgrade Now"
Page Section Framework
Optimal order for long-form pages:
- Hero - Headline + subhead + primary CTA + hero image/video
- Social Proof - Logos, user count, or a single strong testimonial
- Problem - Agitate the pain. Make them feel understood.
- Solution - Your product as the answer. Show, don't tell.
- How It Works - 3-step explanation. Reduce perceived complexity.
- Objections - FAQ or comparison table addressing top hesitations
- Final CTA - Repeat the primary CTA with urgency or incentive
Page-Type Checklists
Homepage:
- Clear value prop visible without scrolling
- Primary CTA above the fold
- Social proof within first two viewports
- Navigation limited to 5-7 items
- One primary action per viewport section
- Page loads under 3 seconds
Landing Page:
- Single goal - one CTA, no navigation
- Headline matches the ad/link that brought them here
- Benefit-oriented subheadline
- Visual showing the product or outcome
- 3+ trust signals (logos, testimonials, guarantees)
- Mobile-optimized form
Pricing Page:
- Recommended plan visually highlighted
- Feature comparison table for 3+ plans
- Annual/monthly toggle (annual shown first)
- FAQ addressing billing, cancellation, refunds
- Social proof specific to enterprise/team tiers
- Free tier or trial option clearly visible
Signup Flow Optimization
Field Strategy
| Field | Include? | Rationale |
|---|---|---|
| Always | Primary identifier | |
| Password | Always | Account security |
| Name | Usually | Personalization, but can defer |
| Company | Defer | Ask post-signup or infer from email domain |
| Role/Title | Defer | Useful for segmentation but adds friction |
| Team size | Defer | Qualification signal, collect in onboarding |
| Phone | Defer | High friction, collect only when needed |
Progressive Commitment
Step users through increasing commitment levels:
- Email only - Lowest barrier. Get them in the door.
- Password + Name - Create the account.
- Customization (optional) - Role, team size, use case. Mark as skippable.
Each step should deliver value before asking for more. Never gate step 1 behind information needed for step 3.
Social Auth by Audience
| Audience | Priority Order |
|---|---|
| B2C | Google > Apple > Facebook |
| B2B | Google > Microsoft/Azure AD > SSO (SAML) |
| Developer | GitHub > Google > GitLab |
Always offer email/password as fallback. Social auth reduces friction by 20-40% on average.
Password UX
- Allow paste - Never disable paste in password fields. It breaks password managers.
- Show/hide toggle - Eye icon to toggle visibility. Default to hidden.
- Strength meter - Visual bar (weak/medium/strong). Color-coded.
- Requirements upfront - Show all rules before the user types, not after they fail.
- No arbitrary rules - Minimum 8 characters is sufficient. Don't require special characters.
Signup Metrics
| Metric | What It Tells You |
|---|---|
| Form start rate | % of page visitors who interact with the first field |
| Completion rate | % of form starters who submit |
| Field-level drop-off | Which specific field causes abandonment |
| Time to complete | How long from first interaction to submit |
| Error rate per field | Which validations are tripping users up |
Onboarding CRO
Core Principle: Time-to-Value
The single most important onboarding metric is how quickly users reach the "aha moment" - the point where they experience the core value.
Finding the aha moment: Compare behavior of retained users (active at day 30) vs churned users (inactive by day 7). The actions that most differentiate these groups are your activation events.
Onboarding Checklist Design
- 3-7 items - Fewer feels trivial, more feels overwhelming
- Order by value - Put the highest-value action second (first is too early, users aren't oriented)
- Quick wins first - First item should complete in under 30 seconds
- Progress bar - Show completion percentage. Endowed progress (start at 20%) increases completion.
- Dismiss option - Always let users close the checklist. Forced onboarding backfires.
- Celebrate completion - Confetti, congratulations, or unlock a reward at 100%
Empty States as Onboarding
Every empty state is a conversion opportunity. Replace "No data yet" with:
- A clear explanation of what will appear here
- A single action button to create the first item
- A sample/template to reduce blank-page anxiety
- A short video or illustration showing the populated state
Trigger-Based Email Sequences
| Timing | Purpose | |
|---|---|---|
| Welcome | Immediate (within 1 min) | Confirm signup, set expectations, single CTA to start |
| Incomplete setup | 24 hours | Remind about unfinished onboarding steps |
| Second nudge | 72 hours | Different angle - social proof or tip-based |
| Activation | On event | Congratulate on reaching aha moment, suggest next step |
| Feature discovery | Day 3 | Introduce a second high-value feature |
| Feature discovery | Day 7 | Introduce integrations or advanced features |
| Feature discovery | Day 14 | Case study or power-user tips |
Rules: Every email has exactly one CTA. Unsubscribe link in every message. Stop the sequence once the user completes the target action.
Form Optimization
Field Count Impact
| Fields | Conversion Impact |
|---|---|
| 1-3 | Baseline (highest conversion) |
| 4-6 | 10-25% reduction |
| 7-9 | 25-40% reduction |
| 10+ | 40-60% reduction |
Every field you add must justify its existence. If you can collect it later or infer it, remove it from the form.
Form UX Rules
- Labels above fields - Never use placeholder text as the only label. Placeholders disappear on focus.
- Single column - Multi-column forms cause tab-order confusion and slower completion.
- Inline validation - Validate on blur (not on keystroke). Show success states too, not just errors.
- Smart defaults - Pre-select the most common option. Auto-detect country, timezone, currency.
- Autofill support - Use correct
autocompleteattributes (email,given-name,tel, etc.) - Mobile tap targets - Minimum 44x44px for all interactive elements.
- Group related fields - Visual grouping reduces perceived complexity.
- Mark optional fields - Label optional fields, not required ones. Most fields should be required.
Submit Button
Formula: "[Action] + [What they get]"
- "Create My Account" not "Submit"
- "Get the Report" not "Download"
- "Reserve My Spot" not "Register"
Full-width buttons on mobile. High contrast against background. Disabled state while processing with loading indicator.
Popup & Modal Optimization
Trigger Effectiveness
| Trigger | Typical CVR | Annoyance Level |
|---|---|---|
| Click-triggered | 10%+ | None (user initiated) |
| Exit intent | 3-10% | Low (they were leaving anyway) |
| Scroll depth (50%+) | 2-5% | Medium |
| Time delay 30-60s | 2-4% | Medium |
| Time delay <5s | <1% | High (not recommended) |
| Immediate on load | <1% | Very high (never do this) |
Popup Rules
- Frequency cap - Never show the same popup more than once per session. Max once per 7 days for returning visitors.
- Google mobile penalty - Interstitials covering >50% of mobile screen on entry trigger ranking penalties. Use banners or bottom sheets instead.
- Polite decline copy - "No thanks, I don't want to save money" guilt-trip copy damages brand trust. Use neutral: "Maybe later" or "Dismiss".
- Visible close button - Top-right X, minimum 44x44px. Never hide or delay the close button.
- Escape key closes - Always. Non-negotiable for accessibility.
- Background click closes - Clicking outside the modal should dismiss it.
High-Converting Popup Types
- Content upgrade - "Get the PDF version of this article" on blog posts. Click-triggered. 10-25% CVR.
- Exit intent with incentive - "Wait - here's 15% off" when cursor moves to close. 3-10% CVR.
- Click-triggered demo - "See it in action" button opens video modal. 10%+ engagement.
Paywall & Upgrade CRO
When to Show vs NOT Show
| Show Paywall | Do NOT Show Paywall |
|---|---|
| User hits usage limit naturally | Before user experiences core value |
| User tries a premium feature | During critical workflow mid-task |
| Free trial is expiring (with notice) | On first session ever |
| User reaches aha moment | When user is frustrated or stuck |
| After demonstrating value repeatedly | On error pages or support flows |
Paywall Screen Components (Priority Order)
- Headline - Outcome-focused: "Unlock unlimited projects" not "Upgrade to Pro"
- Value demo - Show what they're missing with preview, blurred content, or usage stats
- Plan comparison - Side-by-side table. Highlight the recommended plan.
- Pricing - Clear monthly/annual with savings shown. Anchor to annual.
- Social proof - Testimonials from users who upgraded. Specific outcomes.
- CTA - "Start My Free Trial" or "Upgrade to [Plan Name]"
- Escape hatch - Always provide a way to continue with the free tier or dismiss
Anti-Patterns
- Hiding close/dismiss - Users will churn, not convert
- Confusing plan names - Use descriptive names (Starter, Team, Enterprise) not creative ones (Spark, Blaze, Inferno)
- Guilt-trip copy - "Continue with limited features" is fine. "No, I hate saving time" is not.
- Blocking critical flows - Never paywall bug reports, data export, or account settings
- Bait and switch - If a feature was free, give adequate notice before paywalling it
CRO Prioritization
ICE Scoring
Score each test idea on three dimensions (1-10 scale):
- Impact - How much will this move the target metric?
- Confidence - How sure are you this will work? (data-backed = high, gut = low)
- Ease - How quickly can you implement and measure this?
ICE Score = (Impact + Confidence + Ease) / 3
Prioritize by ICE score. Revisit scores monthly as you learn more.
Key Benchmarks
| Metric | Poor | Average | Good | Great |
|---|---|---|---|---|
| Homepage bounce rate | >65% | 45-65% | 25-45% | <25% |
| Landing page CVR (cold) | <2% | 2-5% | 5-15% | >15% |
| Landing page CVR (warm) | <10% | 10-20% | 20-40% | >40% |
| Signup completion | <30% | 30-50% | 50-80% | >80% |
| Onboarding completion | <20% | 20-40% | 40-70% | >70% |
| Free-to-paid (freemium) | <1% | 1-2% | 2-5% | >5% |
| Free-to-paid (trial) | <5% | 5-15% | 15-25% | >25% |
These are cross-industry medians. Your specific vertical may differ. Always benchmark against your own historical data first, industry data second.
Quick Wins by Page Type
- Homepage: Fix the headline and primary CTA first. Biggest ROI.
- Landing page: Message match with the traffic source. If the ad says X, the page must say X.
- Signup: Remove one field. Measure. Repeat.
- Onboarding: Find and eliminate the step with the highest drop-off.
- Pricing: Add annual toggle and highlight the most popular plan.
- Paywall: Show value before asking for money. Always.
email-and-outreach.md
Email & Outreach Reference
Email Sequence Architecture
Welcome Series (5-7 emails over 14 days)
| Timing | Purpose | Key Element | |
|---|---|---|---|
| 1 - Welcome + Value | Immediate | Set expectations, deliver lead magnet | Clear next step, what to expect |
| 2 - Quick Win | Day 1-2 | Deliver immediate result | Actionable tip they can use in 5 min |
| 3 - Story / Why | Day 3-4 | Build connection and trust | Origin story, mission, shared values |
| 4 - Social Proof | Day 5-6 | Reduce uncertainty | Case study, testimonial, data point |
| 5 - Objection Handler | Day 7-8 | Address top buying concern | FAQ format or myth-busting |
| 6 - Feature Spotlight | Day 9-11 | Show specific capability | Demo, walkthrough, use case |
| 7 - Conversion | Day 12-14 | Drive action | Time-limited offer, clear CTA |
Rules: Email 1 must arrive within 60 seconds of signup. Each email should stand alone - assume they skipped previous ones. Single CTA per email.
Onboarding Series (5 emails)
| Timing | Goal | |
|---|---|---|
| 1 - First Action | Day 0 | Get them to complete one meaningful action |
| 2 - Use Case | Day 2 | Show how people like them use the product |
| 3 - Power Feature | Day 5 | Introduce the feature that drives retention |
| 4 - Success Story | Day 10 | Show what "good" looks like with real results |
| 5 - Check-in | Day 14 | Ask how it's going, offer help, gauge satisfaction |
Key principle: Onboarding emails are behavioral, not calendar-based. If the user completes the action before the scheduled email, skip it or send the next one. Never congratulate someone for something they haven't done.
Lead Nurture Series (5-10 emails)
Structure: Educational content mixed with proof and soft CTAs.
- Ratio: 3 educational : 1 proof : 1 soft CTA
- Frequency: 1-2x per week (never daily for nurture)
- Content types: How-to guides, industry data, expert interviews, templates, checklists
- Soft CTAs: "See how [Company] did this" or "Try this approach free" - not "Buy now"
- Exit triggers: Move to sales sequence when lead scores above threshold or takes high-intent action
Re-engagement Series (3-4 emails)
Trigger: 30-60 days of inactivity (no opens, no clicks, no logins).
| Content | Tone | |
|---|---|---|
| 1 - Check-in | "We noticed you've been quiet" | Warm, no pressure |
| 2 - Value Reminder | Best content or feature update they missed | Helpful, FOMO-light |
| 3 - Incentive | Discount, extended trial, exclusive content | Generous, time-bound |
| 4 - Last Chance | "Should we stop emailing?" | Direct, respectful |
After last chance: If no engagement, move to suppression list. Keeping disengaged contacts hurts deliverability. Clean lists beat big lists.
Sequence Length Guidelines
| Type | Emails | Duration |
|---|---|---|
| Welcome | 3-7 | 7-14 days |
| Nurture | 5-10 | 4-8 weeks |
| Onboarding | 5-10 | 14-30 days |
| Re-engagement | 3-5 | 14-21 days |
Email Copy
Length by Type
| Email Type | Word Count | Why |
|---|---|---|
| Transactional | 50-125 words | Action-focused, no fluff |
| Educational | 150-300 words | Teach one thing well |
| Story-driven | 300-500 words | Needs narrative arc to land |
Rule of thumb: If you can cut a sentence without losing meaning, cut it.
Subject Line Patterns
| Pattern | Example | When to Use |
|---|---|---|
| Question | "Still using spreadsheets?" | Provoke curiosity |
| How-to | "How to cut churn by 30%" | Promise specific value |
| Number | "3 mistakes killing your CTR" | Scannable, specific |
| Direct | "Your trial expires Friday" | Urgency, transactional |
| Story tease | "She almost quit. Then..." | Narrative emails |
Constraints:
- Under 50 characters (many clients truncate)
- Under 30 characters for mobile-first audiences
- No ALL CAPS, no excessive punctuation (!!!), no spam trigger words
- Preview text is your second subject line - never waste it on "View in browser"
A/B Testing Subjects
- Split: 20% variant A / 20% variant B / 60% winning variant
- Minimum sample: 1,000 per variant for statistical significance
- Wait time: 2-4 hours before declaring winner
- Test one variable at a time: subject OR preview text OR send time - never all three
Segmentation
Segmentation Models
| Model | Segments | Best For |
|---|---|---|
| Engagement-based | Active (opened/clicked last 30d), Lapsing (31-60d), Inactive (60d+) | Deliverability, re-engagement |
| Lifecycle stage | Subscriber, Lead, MQL, SQL, Customer, Churned | Content relevance |
| RFM (Recency, Frequency, Monetary) | Champions, Loyal, At Risk, Lost | E-commerce, SaaS upsell |
| Behavioral | Feature used, content consumed, pages visited | Product-led nurture |
| Demographic | Role, company size, industry, geography | Personalization at scale |
Implementation Order
- Start with: Engagement + Lifecycle (highest impact, lowest complexity)
- Add next: Behavioral signals when you have event tracking
- Then: RFM when you have purchase/revenue data
- Last: Demographic when data quality supports it
Anti-pattern: Over-segmenting before you have volume. 50 segments with 20 people each means no statistical learning. Keep segments large enough to learn from (500+ contacts minimum).
Deliverability
Authentication (All Required)
| Protocol | Purpose | Record Type |
|---|---|---|
| SPF | Authorizes sending IPs | TXT on domain DNS |
| DKIM | Cryptographic signature on emails | TXT (public key) on DNS |
| DMARC | Policy for failed SPF/DKIM | TXT on _dmarc.yourdomain.com |
DMARC progression: Start with p=none (monitoring only) for 2-4 weeks. Move to p=quarantine for 2-4 weeks. Move to p=reject once clean. Total timeline: 60-90 days.
IP Warmup Schedule
| Week | Daily Volume | Notes |
|---|---|---|
| 1 | 200-500 | Send to most engaged contacts only |
| 2 | 1,000-2,000 | Expand to recent openers |
| 3 | 3,000-5,000 | Add broader engaged segments |
| 4 | 5,000-10,000 | Approaching full volume |
| 5+ | Full send | Monitor bounce/complaint rates |
Critical rule: Never more than 2x volume day-over-day. Spikes trigger ISP throttling.
Technical Constraints
- Gmail: Clips messages at 102KB HTML size. Keep emails lean.
- Apple MPP: Mail Privacy Protection (iOS 15+) pre-fetches images, inflating open rates. Opens are unreliable for Apple Mail users - use clicks as primary engagement signal.
- Outlook: Uses Microsoft Word rendering engine. Limited CSS support - no
background-imageon<div>, nomarginon<p>, limitedmax-width. - Dark mode: Test in dark mode. Use transparent PNGs, avoid white backgrounds baked into images.
HTML Email Standards
- Layout: Table-based (not
<div>flexbox/grid) - CSS: Inline styles only (many clients strip
<style>blocks) - Width: 600px max for desktop, fluid for mobile
- Font size: 16px minimum body text
- Tap targets: 44x44px minimum on mobile
- Images: Always include
alttext, assume images won't load by default - Links: Use full URLs, not URL shorteners (shorteners trigger spam filters)
Email Benchmarks
| Metric | B2C Benchmark | B2B Benchmark | Action Threshold |
|---|---|---|---|
| Open Rate | 20-30% | 25-35% | Investigate below 15% |
| Click-Through Rate (CTR) | 2-5% | 2-5% | Investigate below 1% |
| Click-to-Open Rate (CTOR) | 10-20% | 10-20% | Below 8% = content problem |
| Unsubscribe Rate | < 0.2% | < 0.2% | Above 0.5% = targeting issue |
| Spam Complaint Rate | < 0.1% | < 0.1% | Above 0.1% = deliverability risk |
| Bounce Rate | < 2% | < 2% | Above 3% = list hygiene issue |
| Average ROI | $36 per $1 spent | $36 per $1 spent | - |
| Mobile Opens | 60%+ | 50%+ | Design mobile-first always |
Cold Email
Core Principles
- Peer tone, not vendor tone. Write like a colleague sharing something relevant, not a salesperson pitching.
- Every sentence earns its place. If a sentence doesn't advance the email's single goal, delete it.
- "You/your" > "I/we." The email is about them and their problem, not about you and your product.
- Personalization test: Remove the personalized opening. Does the email still make sense? If yes, your personalization is cosmetic - it's not actually relevant to the recipient's situation.
Subject Lines
- 2-4 words, lowercase, no punctuation
- Should look like an internal email, not a marketing email
- Examples: "quick question", "shared resource", "re: your team's approach"
What to Avoid
- "I hope this finds you well" (instant delete trigger)
- "My name is X and I work at Y" (nobody cares yet)
- Industry jargon and buzzwords ("synergy", "leverage", "paradigm shift")
- HTML formatting, images, or tracking pixels in cold emails
- Fake Re: or Fwd: prefixes (deceptive and damages trust permanently)
- Multiple CTAs or asks in one email
Follow-up Cadence
| Timing | Rule | |
|---|---|---|
| 1 - Initial | Day 0 | Lead with their problem, not your solution |
| 2 - Follow-up | Day 3-4 | Add new value (data point, case study, insight) |
| 3 - Follow-up | Day 7-8 | Different angle, same problem |
| 4 - Follow-up | Day 14 | Social proof or trigger event reference |
| 5 - Breakup | Day 21-28 | "Not the right time? No worries." |
Rules: Each email stands alone (don't say "per my last email"). Each adds new value. Never "just checking in" or "bumping this up." Increasing gaps between emails shows respect for their time.
CTA Strategy
Interest-based CTAs beat meeting requests:
- "Worth exploring?" > "Can we schedule 15 minutes?"
- "Want me to send the case study?" > "Let's hop on a call"
- "Does this resonate?" > "Are you free Tuesday at 2pm?"
Lower commitment = higher response rate. Earn the meeting through the reply thread.
Audience Calibration
| Audience | Style | Length | CTA |
|---|---|---|---|
| C-suite (VP+) | Ultra-brief, peer-level, strategic | 3-5 sentences max | Soft interest check |
| Mid-level (Directors, Managers) | Specific value, outcome-focused | 5-8 sentences | Resource or case study offer |
| Technical (Engineers, Analysts) | Precise, no fluff, respect expertise | 4-6 sentences | Technical asset or demo |
Lifecycle Automation Triggers
| Trigger Event | Automation | Timing | Goal |
|---|---|---|---|
| Sign up | Welcome series | Immediate | Deliver value, set expectations |
| Trial start | Onboarding drip | Immediate | Drive first meaningful action |
| Activation achieved | Celebration + next steps | Within 1 hour | Reinforce behavior, advance to next milestone |
| Feature not used | Feature spotlight | Day 7 of inactivity | Surface overlooked value |
| Trial expiring | Urgency + value recap | 3 days before | Convert with deadline + proof |
| Payment failed | Dunning sequence | Immediate, then day 3, 7 | Recover revenue, update payment |
| Upgrade | Thank you + advanced features | Immediate | Reduce buyer's remorse, drive adoption |
| Churn risk signal | Save offer | When risk score triggers | Retain with personalized incentive |
Dunning detail: Payment failed emails recover 20-40% of failed charges. Send 3-5 attempts over 14 days. Include a direct link to update payment - no login required if possible. Tone: helpful, not threatening.
Churn risk signals: Usage drop > 50% week-over-week, support ticket escalation, cancellation page visit, key feature abandonment, negative NPS response.
growth-and-retention.md
Growth and Retention Reference
AARRR Pirate Metrics
The five stages every user passes through:
| Stage | Question | Key Metric |
|---|---|---|
| Acquisition | How do users find you? | Channel conversion rate |
| Activation | Do they have a great first experience? | Setup completion rate |
| Retention | Do they come back? | D7/D30/D90 retention |
| Revenue | Do they pay? | ARPU, conversion to paid |
| Referral | Do they tell others? | Viral coefficient (K) |
North Star Metric Examples
Pick one metric that captures the core value exchange:
- Slack - Messages sent per active team per week
- Airbnb - Nights booked
- Spotify - Time spent listening
- Dropbox - Files saved/synced
- HubSpot - Weekly active contacts managed
A north star must be measurable, reflect value delivery, and lead revenue (not lag it).
Growth Loops vs Funnels
Funnels leak at every step and require constant top-of-funnel investment. Loops compound - each cohort's output feeds the next cohort's input.
Loop Types
| Type | Mechanism | Example |
|---|---|---|
| Viral | Users invite users | Dropbox referral, Calendly links |
| Content | Usage generates indexable content | Pinterest pins, Stack Overflow answers |
| Sales-assisted | Product usage triggers sales outreach | Slack free team hits limits |
| Paid | Revenue funds acquisition spend | DTC brands reinvesting margin |
Viral Coefficient
K = average_invites_per_user * invite_conversion_rate- K > 1 - True viral growth (rare, unsustainable long-term)
- K = 0.5-1.0 - Strong word-of-mouth amplification
- K < 0.3 - Referral is a minor channel
Measure K over a 90-day window, not launch burst. Early adopters always over-index on sharing.
Activation Optimization
Finding the Aha Moment
Compare behavioral data between two groups:
- Users who churned within week 1
- Users who retained through week 4
Look for the action or threshold that separates them (e.g., "invited 3 teammates" or "created first dashboard").
Optimization Process
- Define the aha moment from data analysis
- Map every step from signup to aha
- Measure drop-off at each step
- Prioritize the largest absolute drop-off (not percentage)
- A/B test interventions on that step
- Repeat for the next largest drop
Retention Benchmarks by Category
| Product Type | Good D30 Retention | Great D30 Retention |
|---|---|---|
| Consumer social | 25% | 40%+ |
| B2B SaaS | 40% | 70%+ |
| E-commerce | 10% | 25%+ |
| Mobile games | 5% | 15%+ |
| Productivity tools | 20% | 45%+ |
Product-Led Growth (PLG)
PLG Motions
| Motion | How It Works | Best For |
|---|---|---|
| Freemium | Free tier forever, paid unlocks more | Wide TAM, low marginal cost |
| Free trial | Full product, time-limited | Complex products needing exploration |
| Usage-based | Pay for what you use | Variable consumption patterns |
Freemium Gotcha
The #1 PLG failure: free tier is too generous. Users never hit the upgrade trigger. Design the free tier to deliver value but create natural friction at the expansion moment.
PLG Metrics
- Activation rate - % of signups reaching aha moment (target: 40-60%)
- Time-to-value - Minutes/hours from signup to first value (target: <5 min for simple tools)
- PQL rate - % of free users qualifying as product-qualified leads (target: 15-30%)
- Expansion revenue - Revenue from existing customers upgrading (target: >30% of new ARR)
Churn Prevention
Churn Split
- Voluntary churn (50-70%) - User actively cancels
- Involuntary churn (30-50%) - Payment fails, card expires
Cancel Flow Design
Trigger (cancel click)
-> Survey (why are you leaving?)
-> Dynamic Offer (matched to reason)
-> Confirmation (are you sure?)
-> Post-Cancel (win-back sequence)Dynamic Save Offers
| Cancel Reason | Primary Offer | Fallback Offer |
|---|---|---|
| Too expensive | 20-30% discount for 2-3 months | Downgrade to lower tier |
| Not using it | Pause for 1-3 months | Free onboarding session |
| Missing feature | Roadmap + timeline commitment | Workaround documentation |
| Switching to competitor | Side-by-side comparison + discount | Feedback interview for credit |
| Technical issues | Escalated support within 24h | Account credit |
| Business closed | Skip offer (respect the situation) | N/A |
Churn Benchmarks
| Metric | Target |
|---|---|
| Monthly churn (B2C) | < 5% |
| Monthly churn (B2B) | < 2% |
| Cancel flow save rate | 25-35% |
| Offer acceptance rate | 15-25% |
| Pause reactivation rate | 60-80% |
| Dunning recovery rate | 50-60% |
Churn Risk Signals
| Signal | Severity | Lead Time |
|---|---|---|
| Login frequency drops 50%+ | High | 2-4 weeks |
| Core feature usage stops | High | 1-3 weeks |
| Billing/pricing page visits | Medium | Days |
| Data export initiated | Critical | Days |
| Support tickets spike then stop | Medium | 1-2 weeks |
Customer Health Score
Health = Login_Score * 0.30
+ Feature_Usage * 0.25
+ Support_Sentiment * 0.15
+ Billing_Health * 0.15
+ Engagement_Trend * 0.15Score each dimension 0-100. Overall < 40 = at risk, 40-70 = monitor, > 70 = healthy.
Dunning (Involuntary Churn Recovery)
Retry schedule for failed payments:
- 24 hours after failure
- 3 days after failure
- 5 days after failure
- 7 days after failure (final attempt)
Smart tip: retry on the same day-of-month the original charge succeeded. Success rates jump 15-20%.
Anti-Patterns
- Discounts too deep (50%+) - trains users to cancel for deals
- No cancel flow at all - users dispute charges instead
- Pause duration > 3 months - users forget they have an account
- Ignoring involuntary churn - it is the easiest churn to fix
Referral Programs
Referral Loop
Trigger (high-intent moment)
-> Share (frictionless mechanism)
-> Convert (friend activates)
-> Reward (both sides)
-> Loop (new user triggers their own referrals)High-Intent Trigger Moments
Best times to prompt a referral (in order of effectiveness):
- Immediately after the aha moment
- After hitting a milestone (e.g., 100th order, 1 year anniversary)
- After a positive support interaction
- After upgrading to a paid plan
Share Mechanism Ranking
- In-product sharing (highest conversion) - embedded invite flows
- Personalized link - unique URL with attribution
- Email invite - pre-written, editable template
- Social sharing - one-click to Twitter/LinkedIn
- Referral code (lowest conversion) - manual entry required
Referral Program Stats
- Referred customers have 16-25% higher LTV than non-referred
- Referred customers show 18-37% lower churn
- Existing customers who refer have 2-3x the referral rate of new ones
- Tie rewards to activation, not signup - prevents gaming
Reward Structure
Double-sided rewards outperform single-sided by 2-4x. Reward the referrer for their friend's activation, not mere registration.
Pricing Strategy
Three Axes of Pricing
- Packaging - What goes in each tier?
- Pricing metric - What unit do you charge on? (seats, usage, features)
- Price point - How much?
Value-Based Pricing Stack
Perceived Value (ceiling) -- what customers believe it's worth
Your Price -- where you set it
Alternatives (floor) -- what competitors charge
Cost (baseline) -- what it costs you to deliverAlways price between alternatives and perceived value. Never price from cost up.
Good-Better-Best Framework
| Tier | Purpose | Pricing |
|---|---|---|
| Good | Core features, limited usage | Entry point, low friction |
| Better | Full feature set, "Recommended" badge | Sweet spot, most customers land here |
| Best | Everything + premium support/SLAs | 2-3x the Better tier price |
Van Westendorp Price Sensitivity
Ask four questions to find the acceptable price range:
- At what price is this too cheap (quality concern)?
- At what price is this a bargain?
- At what price is this getting expensive (but still consider)?
- At what price is this too expensive (won't buy)?
Plot the four curves. The intersection zone is your optimal price range.
Pricing Page Psychology
- Anchoring - Show the highest tier first (left-to-right) or most prominent
- Decoy effect - Middle tier looks best when flanked properly
- Charm pricing - $49 signals value; $50 signals premium
- Annual discount - Offer 17-20% off for annual commitment (2 months free)
Signs You Should Raise Prices
- No price objections in sales calls ("no flinch")
- Customers say "this is so cheap for what we get"
- Free-to-paid conversion rate > 40%
- Monthly churn < 3%
Free Tool Strategy
Types of Free Tools
| Type | Example | Lead Capture |
|---|---|---|
| Calculators | ROI calculator, salary estimator | Email for results |
| Generators | Name generator, template builder | Email for export |
| Analyzers | Website grader, SEO audit | Email for full report |
| Testers | Speed test, accessibility checker | Email for recommendations |
| Libraries | Templates, swipe files | Email for download |
Free Tool Evaluation Scorecard
Rate 1-5 on each criterion. Score 25+ out of 40 = strong candidate:
- Search volume for the problem it solves
- Relevance to your paid product
- Shareability / word-of-mouth potential
- Difficulty for competitors to replicate
- Data capture opportunity
- SEO / backlink potential
- Speed to build MVP
- Ongoing maintenance cost (inverse - lower is better)
Ideation Framework
Start with pain points to find free tool ideas:
- What does your audience Google repeatedly?
- What manual processes are tedious for them?
- What info do they need before buying your product?
- What data do they wish they had access to?
Gating Options
| Strategy | Conversion | Lead Quality | SEO Value |
|---|---|---|---|
| Fully gated (email for access) | Lower | Higher | None |
| Partially gated (preview free, full for email) | Medium | Medium | Good |
| Ungated + optional email | Higher usage | Lower | Best |
| Ungated entirely (link building play) | N/A | N/A | Best |
Best default: partial gating. Show enough value to prove the tool works, gate the full output.
SEO for Free Tools
- Target "[thing] calculator", "[thing] generator", "[thing] checker" keywords
- Free tools attract backlinks naturally (10-50x more than blog posts)
- Each tool page should target a cluster of related keywords
- Add schema markup (SoftwareApplication type)
Build vs Buy
- Build custom when: unique data advantage, core to product, high defensibility
- No-code tools (Outgrow, Typeform, Tally, Bubble) when: validating quickly, simple logic, time-constrained
- Embed existing when: API available, lower effort, good enough quality
MVP Approach
Build only: core function + essential UX + basic lead capture. Nothing else. Ship, measure, then iterate based on actual usage data.
Growth Experiment Prioritization
ICE Framework
ICE Score = (Impact + Confidence + Ease) / 3- Impact (1-10): If this works, how big is the effect?
- Confidence (1-10): How sure are we it will work? (data > intuition)
- Ease (1-10): How quickly can we run this experiment?
Experiment Cadence
Run experiments in 2-week sprints:
- Week 1: Launch experiment, collect data
- Week 2: Analyze, document, decide (ship, iterate, or kill)
Experiment Documentation Template
Hypothesis: If we [change], then [metric] will [improve by X%]
because [reasoning].
Result: [metric] moved [+/- X%] with [confidence level].
Learning: [What we now know that we didn't before.]
Next: [Ship / Iterate / Kill]Never run experiments without documenting the hypothesis first. The learning is the asset, not just the result.
ideas-library.md
Marketing Ideas Library
139 proven marketing tactics. Browse by category, stage, budget, or use case.
Ideas by Category
Content & SEO (20 ideas)
- Blogging for SEO - publish keyword-targeted posts on a consistent cadence
- Pillar-cluster content - build topic authority with hub pages and supporting articles
- Programmatic SEO pages - auto-generate landing pages for long-tail queries at scale
- Guest posting - place articles on high-DA sites in your niche
- Podcast guesting - appear on relevant podcasts to reach warm audiences
- Original research/surveys - publish proprietary data that earns backlinks and citations
- Interactive content - quizzes, assessments, and configurators that drive engagement
- Comparison/alternatives pages - capture bottom-funnel "X vs Y" and "X alternatives" searches
- Template libraries - offer free templates that showcase your product's value
- Free courses - teach your domain and funnel learners into your product
- Resource roundups - curate the best tools, articles, or guides in your space
- Expert roundups - compile quotes from industry leaders (they share it with their audiences)
- Content syndication - republish content on Medium, LinkedIn, or partner sites
- Repurposing engine - turn one long-form piece into 10+ assets across formats
- Infographics - visualize data or processes for easy sharing and embedding
- Data journalism - analyze public datasets and publish insights as stories
- Glossary pages - define industry terms to capture informational search traffic
- FAQ hubs - answer common questions with structured, schema-marked content
- Tools directories - get listed in curated tool lists and directories
- Trending topic newsjacking - publish timely takes on breaking industry news
Social & Community (18 ideas)
- LinkedIn thought leadership - post consistently with a distinct point of view
- X/Twitter threads - break down complex topics into engaging thread formats
- Instagram carousels - share visual how-tos and mini-guides
- TikTok short-form - create quick educational or behind-the-scenes content
- YouTube tutorials - publish long-form walkthroughs and demos
- Reddit marketing - genuinely participate in relevant subreddits and share value
- Comment marketing on social - add thoughtful replies to high-visibility posts
- Discord/Slack community - build a branded community for your audience
- Facebook Groups - create or participate in niche groups with engaged members
- LinkedIn newsletter - leverage LinkedIn's built-in distribution for regular content
- Live streaming - host live Q&As, demos, or behind-the-scenes sessions
- Social listening for leads - monitor keywords to find people asking for your solution
- UGC campaigns - encourage customers to create and share content about your product
- Meme marketing - use humor and cultural references to boost shareability
- Employee advocacy - equip your team to share company content authentically
- Influencer partnerships - collaborate with relevant creators for sponsored content
- Brand ambassador program - formalize relationships with your biggest fans
- Social proof walls - aggregate and display positive mentions across platforms
Email & Outreach (15 ideas)
- Welcome sequences - onboard new subscribers with a multi-email introduction
- Newsletter - deliver consistent value to build a direct relationship with your audience
- Cold email - reach prospects directly with personalized, relevant outreach
- Referral email campaigns - ask happy customers to refer peers with a clear incentive
- Re-engagement campaigns - win back inactive subscribers with targeted offers
- Post-purchase sequences - deepen relationships after the sale with helpful follow-ups
- Cart abandonment emails - recover lost revenue with timely reminders
- Lead nurture drips - educate and warm leads over time through automated sequences
- Event invitation emails - drive registrations for webinars, launches, or meetups
- Survey/feedback emails - collect insights and signal that you value customer input
- Product update emails - keep users informed and excited about new features
- Milestone/anniversary emails - celebrate customer milestones to strengthen loyalty
- Seasonal campaigns - align promotions with holidays, quarters, or industry events
- Co-marketing emails - partner with complementary brands to cross-promote
- Email signature marketing - turn every employee email into a subtle promotion channel
Paid & Performance (12 ideas)
- Google Search ads - capture high-intent searches for your solution category
- Google Display ads - build awareness across the Google Display Network
- Meta (FB/IG) ads - target precise demographics and interests on Facebook and Instagram
- LinkedIn ads - reach B2B decision-makers by title, company, and industry
- TikTok ads - tap into younger demographics with native-feeling video ads
- YouTube ads - run pre-roll or discovery ads to reach video audiences
- Reddit ads - target niche communities with contextually relevant promotions
- Retargeting - re-engage site visitors who did not convert on their first visit
- Lookalike audiences - find new prospects who resemble your best customers
- Branded search defense - bid on your own brand terms to prevent competitor poaching
- Competitor keyword bidding - capture searches for competitor brand names
- Programmatic display - use automated buying to place ads across premium inventory
Growth & Viral (15 ideas)
- Referral programs - reward customers for bringing in new users
- Viral loops - design product mechanics where usage naturally drives sharing
- Powered-by marketing - embed your brand in customer-facing outputs
- Freemium - offer a free tier that demonstrates value and drives upgrades
- Free tools/calculators - build useful utilities that attract your target audience
- API/integration partnerships - connect with other products to access their user base
- Marketplace listings - list on Salesforce AppExchange, Shopify App Store, etc.
- Product Hunt launches - coordinate a launch for maximum visibility on launch day
- App store optimization - optimize your listing for discoverability in app stores
- Widget marketing - offer embeddable widgets that display your brand
- Badge/certification programs - create credentials that users proudly display
- Open source marketing - release tools or libraries to build developer trust
- Affiliate programs - pay commissions to partners who drive sales
- Waitlist referrals - let early signups jump the queue by referring friends
- Gamification - add points, streaks, or leaderboards to drive engagement and sharing
Brand & PR (12 ideas)
- Brand storytelling - craft a compelling origin story and company narrative
- Founder-led content - position founders as the public face with authentic content
- Conference speaking - present at industry events to build credibility
- Book marketing - write a book to establish deep authority in your domain
- Podcast creation - launch a branded podcast to build a loyal audience
- Award submissions - apply for industry awards to gain third-party validation
- Press releases - announce milestones to earn media coverage
- Media relationships - build ongoing connections with relevant journalists
- Analyst briefings - present to industry analysts for inclusion in reports
- Sponsorships - sponsor events, newsletters, or podcasts your audience follows
- Brand collaborations - partner with complementary brands for co-branded campaigns
- Cause marketing - align with a cause your audience cares about authentically
Conversion & Sales (12 ideas)
- Landing page optimization - continuously improve page copy, layout, and CTAs
- A/B testing program - systematically test headlines, offers, and page elements
- Exit intent offers - catch leaving visitors with a compelling last-chance offer
- Chatbots/live chat - engage visitors in real-time to answer questions and convert
- Demo videos - show your product in action to reduce friction
- ROI calculators - let prospects quantify the value of switching to your solution
- Interactive product tours - guide prospects through your product without signup
- Case study program - document customer success stories with measurable outcomes
- Testimonial collection - systematically gather and display social proof
- Pricing experiments - test pricing tiers, anchoring, and presentation
- Free trial optimization - remove friction and guide users to their "aha" moment
- Onboarding optimization - reduce time-to-value for new users
Retention & Expansion (10 ideas)
- Onboarding email sequences - guide new users through setup and first wins
- In-app messaging - deliver contextual tips and prompts inside your product
- Customer success content - publish advanced guides for existing customers
- NPS program - measure satisfaction and act on detractor feedback
- Loyalty program - reward continued usage with perks or discounts
- Expansion revenue plays - identify and nurture upsell and cross-sell opportunities
- Customer community - create a space for users to help each other and share tips
- Annual review emails - show users their yearly impact and usage highlights
- Feature adoption campaigns - promote underused features to existing users
- Churn save offers - intervene with targeted offers when users signal intent to leave
Events & Experiences (10 ideas)
- Webinars - host educational sessions that generate leads and demonstrate expertise
- Virtual summits - organize multi-speaker online events around a theme
- Workshops - run hands-on training sessions that provide immediate value
- Meetups - host local or virtual gatherings for your community
- Hackathons - sponsor or host hackathons to engage developers and creators
- Office hours - offer regular open sessions for Q&A and product feedback
- AMA sessions - run ask-me-anything events with founders or experts
- Customer advisory board - convene top customers for strategic input and co-creation
- User conferences - organize an annual event for your customer community
- Co-hosted events - partner with complementary brands to share audiences
Creative & Unconventional (15 ideas)
- Engineering as marketing - build free tools that solve adjacent problems
- Stunt marketing - execute bold, attention-grabbing campaigns
- Mystery/easter eggs - hide surprises in your product or content to delight users
- Handwritten notes - send physical, personal notes to key customers or prospects
- Swag/merch - create branded merchandise people actually want to wear or use
- Billboard/OOH - use out-of-home advertising for local or high-visibility campaigns
- Podcast ads - sponsor relevant podcasts to reach engaged, niche audiences
- Newsletter sponsorships - place ads in curated newsletters your audience reads
- Charity tie-ins - donate a percentage of sales or tie campaigns to charitable causes
- Challenges/contests - run time-bound competitions to drive participation and UGC
- Unboxing experiences - design memorable packaging that customers share organically
- Personalized video outreach - send custom video messages to high-value prospects
- Direct mail - send physical mail to stand out in a digital-first world
- Reverse engineering competitor traffic - analyze competitor channels and replicate what works
- Buying small newsletters/communities - acquire existing audiences instead of building from zero
Ideas by Stage
Pre-Launch
- Waitlist with referral incentives (#79)
- Landing page with email capture (#93)
- Early access pricing (#102)
- Product Hunt prep (#73)
- Beta community (#28)
- Founder social presence (#82)
- Content bank building (#1, #14)
Early Stage (0-100 customers)
- SEO content foundation (#1, #2)
- Founder-led sales (#82)
- Cold email (#41)
- Community participation (#26, #27)
- Product Hunt launch (#73)
- Free tool (#70)
- Initial case studies (#100)
- Partnership outreach (#71)
Growth (100-1000 customers)
- Paid acquisition scaling (#54-65)
- Referral program (#66)
- Content engine (#1, #2, #14)
- Webinar program (#115)
- Conference speaking (#83)
- PR push (#87, #88)
- Integration partnerships (#71)
- Case study library (#100)
Scale (1000+ customers)
- Brand campaigns (#81, #91)
- International expansion (#55, #56)
- Media acquisitions (#139)
- Analyst relations (#89)
- Sponsorship portfolio (#90)
- Customer community (#111)
- Enterprise sales enablement (#98, #99)
- Thought leadership platform (#21, #85)
Ideas by Budget
Free
- SEO content (#1, #2)
- Social media (#21-31)
- Community participation (#26, #27, #29)
- Cold email (#41)
- Referral program (#66)
- Powered-by marketing (#68)
- Comment marketing (#27)
- Reddit engagement (#26)
- Open source (#77)
- Guest posting (#4)
Low Budget ($100-1K/month)
- Targeted ads with small budget (#54, #56)
- Newsletter sponsorships (#132)
- Micro-influencers (#36)
- Free tool development (#70)
- Small event sponsorships (#90)
- Podcast guesting (#5)
Medium Budget ($1K-10K/month)
- Paid ads at scale (#54-65)
- Webinar program (#115)
- Conference attendance (#83)
- PR agency (#87, #88)
- Content production team (#1-20)
- Email platform (#39-53)
- Analytics tools
High Budget ($10K+/month)
- Brand campaigns (#81, #91)
- Major sponsorships (#90)
- Conference hosting (#123)
- Media acquisitions (#139)
- TV/radio/podcast ads (#131)
- Large influencer partnerships (#36)
- International expansion
Top Picks by Situation
Need Leads Fast
- Google Search Ads - capture existing intent immediately (#54)
- LinkedIn Ads - B2B precision targeting by title and company (#57)
- Free tool/calculator - engineering as marketing (#70, #125)
- Cold email - direct outreach to ideal prospects (#41)
- Webinar with partner - borrow an established audience (#115, #124)
Building Authority
- Conference speaking - earn credibility through stage presence (#83)
- Original research/annual report - publish data nobody else has (#6)
- Podcast - host or guest to reach engaged audiences (#5, #85)
- Book marketing - deep authority that compounds over years (#84)
- Expert roundups - associate your brand with industry leaders (#12)
Low Budget Startup
- SEO content - compound returns over time (#1, #2)
- Reddit/community marketing - engage where your audience already gathers (#26)
- Cold email outreach - zero ad spend, high personalization (#41)
- Comment marketing - piggyback on high-visibility conversations (#27)
- Free tool or template - attract users by solving a real problem (#9, #70)
Product-Led Growth
- Freemium with viral loop - usage drives awareness (#67, #69)
- Powered-by marketing - every customer becomes a billboard (#68)
- In-app referral program - reward sharing at the moment of delight (#66)
- Free tool as lead gen - build adjacent utilities (#70)
- Template/marketplace ecosystem - let users build on your platform (#9, #72)
Enterprise Sales
- Sales enablement content - battle cards, ROI calculators (#98)
- Case study program - document outcomes with named logos (#100)
- Analyst briefings - get into Gartner, Forrester, G2 reports (#89)
- Customer advisory board - co-create with strategic accounts (#122)
- Account-based marketing (ABM) - personalized campaigns for target accounts (#57, #61)
E-Commerce
- Instagram/TikTok content - visual platforms for product discovery (#23, #24)
- UGC campaigns - real customers showing real usage (#33)
- Email cart abandonment - recover lost revenue automatically (#45)
- Retargeting ads - bring window-shoppers back to buy (#61)
- Loyalty/rewards program - increase repeat purchase rate (#109)
How to Use This Library
- Filter by your stage and budget first
- Pick 2-3 tactics maximum to start (focus beats breadth)
- Give each 90 days before judging (marketing compounds)
- Document what works and double down
- Rotate low-performers out after fair test, add new experiments
launch-and-gtm.md
Launch and Go-to-Market Reference
Launch Tiers
Not every release deserves a full GTM push. Match effort to impact.
| Tier | Scope | GTM Effort | Examples |
|---|---|---|---|
| Tier 1 | New product or category entry | Full GTM: press, launch event, sales enablement, paid, content series | V1 product, new market entry, platform launch |
| Tier 2 | Major feature or expansion | Blog post, email campaign, sales enablement update, social push | New integration, pricing tier, major workflow |
| Tier 3 | Minor feature or improvement | Release notes, in-app announcement, changelog entry | UI refresh, performance boost, small feature |
| Tier 4 | Patch or maintenance | Changelog only, no external comms | Bug fix, security patch, dependency update |
Rule of thumb: If sales needs to change their pitch, it is Tier 2 or above.
Five-Phase Launch
Sequential phases that build momentum before the big day.
Phase 1: Internal Launch
- Recruit 5-10 internal power users or friendly teams
- Gather raw feedback on onboarding, bugs, and confusion points
- Fix the top 3 friction points before moving forward
- Document the "aha moment" - when do users first see value?
Phase 2: Alpha
- Build a landing page with waitlist capture
- Offer early access to 20-50 hand-picked users
- Run weekly feedback sessions (15 min max)
- Iterate on positioning based on how users describe the product
Phase 3: Beta
- Work through the waitlist systematically
- Post teasers on social - screenshots, short demos, behind-the-scenes
- Collect testimonials and usage data for launch day proof points
- Finalize pricing and packaging based on willingness-to-pay signals
Phase 4: Early Access
- Leak details strategically to build anticipation
- Run competitive research - how do alternatives position themselves?
- Throttle signups if needed to maintain quality of experience
- Prepare all launch assets (blog, emails, decks, one-pagers)
Phase 5: Full Launch
- Open self-serve signup
- Turn on billing
- Announce across all channels simultaneously
- Engage actively all day - respond to every comment, tweet, question
ORB Framework
Three channel types, each with different strengths. Use all three.
Owned Channels (Compound Returns)
- Email list - highest ROI channel, you control the audience
- Blog/content hub - SEO compounds over time
- Podcast/video series - builds authority and personal connection
- Community (Discord, Slack, forum) - creates network effects
Rented Channels (Speed)
- Social media (Twitter/X, LinkedIn, Instagram) - fast reach, algorithm-dependent
- Marketplaces (Product Hunt, app stores) - built-in audiences
- Paid ads (Google, Meta, LinkedIn) - predictable, scalable, expensive
Borrowed Channels (Credibility)
- Guest posts and podcast appearances - tap into existing audiences
- Influencer partnerships - instant credibility transfer
- Press coverage - third-party validation
- Co-marketing with complementary products - shared audience growth
Strategy: Build owned channels for long-term. Use rented for speed. Borrow for credibility spikes around launches.
GTM Strategy: Six Core Questions
Answer these before writing a single piece of launch content.
- Who buys? - Define ICP (industry, role, company size, budget authority). Name 3 real companies that fit.
- What problem? - State the pain in the buyer's words, not yours. What are they doing today instead?
- How do we position? - Category (existing or new), key differentiators, competitive frame. One sentence: "We are the only ___ that ___."
- Pricing and packaging? - Free tier? Trial? Tiers by usage, features, or seats? Anchor price?
- Which channels? - Where does the ICP already spend time? Rank top 3 channels by expected ROI.
- What does success look like? - Define metrics and targets for Day 7, Day 30, Day 90.
Launch Timeline: 4-Week Countdown
T-4 Weeks (Planning)
- Finalize positioning document and messaging hierarchy
- Draft all launch content (blog, emails, social, press release)
- Brief sales team on new positioning, objection handling, and demo flow
- Set up tracking - UTMs, analytics events, conversion funnels
T-2 Weeks (Warm-Up)
- Start teasing on social - behind-the-scenes, sneak peeks
- Send warm-up email to existing list ("something big coming")
- Submit Product Hunt listing (if applicable)
- Coordinate with partners for co-promotion timing
T-1 Week (Preparation)
- Press outreach with embargoed assets
- Seed content to influencers with early access
- Run full launch readiness check: site, billing, support, docs
- Pre-schedule all social posts, emails, and ads
Launch Day
- Publish blog post as anchor content
- Send email blast to full list
- Post across all social channels
- Engage actively all day - every comment gets a response
- Monitor for issues: site performance, signup flow, billing
T+1 Week (Follow-Up)
- Collect and act on early feedback
- Start building the first case study from launch cohort
- Adjust messaging based on what resonated vs. what fell flat
- Run retargeting campaigns for visitors who did not convert
Product Hunt Strategy
Before Launch Day
- Build relationships on PH 2-4 weeks before (upvote, comment, engage)
- Line up a well-known hunter or use your own account
- Prepare all assets: tagline (60 chars), description, images, video
Launch Day Execution
- Launch at 12:01 AM PT (PH resets daily at midnight PT)
- Best days: Tuesday, Wednesday, Thursday
- Engage with every comment within 30 minutes
- Share the PH link across all channels but do not explicitly ask for upvotes
- Offer a PH-exclusive deal (extended trial, discount, bonus feature)
After Launch Day
- Convert PH traffic to email subscribers
- Follow up with commenters who showed interest
- Feature "As seen on Product Hunt" badge on site
Beta Program Design
Structure
- Size: 15-50 participants (enough for signal, small enough to manage)
- Duration: 4-8 weeks
- Feedback cadence: Weekly async survey (5 questions max) + optional 15-min call
- Communication: Dedicated Slack channel or email thread
Participant Selection
- Mix of ICP segments (don't over-index on one type)
- Include 2-3 "difficult" users who will stress-test edge cases
- Require commitment: "We need 30 minutes/week of your time"
Graduation Gates
- Feature completeness > 80% of planned scope
- NPS > 30 among beta cohort
- Zero critical bugs open
- Onboarding flow tested and refined
Incentives
- Early pricing locked in for 12 months
- Lifetime deal for most engaged participants
- Co-marketing opportunity (featured case study)
- Direct access to founding team
Tiered Rollout
| Stage | Audience | Traffic | Purpose |
|---|---|---|---|
| Dark launch | Internal team only | 0% external | Validate core flows work |
| Closed beta | Hand-picked users | 1-5% | Gather qualitative feedback |
| Limited GA | Waitlist + referrals | 10-25% | Test at moderate scale |
| General Availability | Everyone | 100% | Full public launch |
Rollback criteria at each stage: Error rate > 2%, NPS drop > 10 points, critical bug with no workaround.
Launch Comms Templates
Internal Announcement (T-5 Days)
- Subject: "[Product] launching [date] - what you need to know"
- What we are launching and why it matters
- Target customer and key use cases
- Pricing and packaging summary
- How to demo it / where to send interested prospects
- FAQ for common customer questions
Launch Blog Post
- Hook with the problem (not the product)
- Introduce the shift in the market or technology
- Present the product as the natural response to that shift
- Show 2-3 concrete workflows with screenshots
- Include one proof point (metric, testimonial, case study)
- Clear CTA: try it free, book a demo, join waitlist
Customer Email
- Subject line: benefit-driven, under 50 characters
- One paragraph: what it is and why it matters to them specifically
- One screenshot or GIF showing the key workflow
- CTA button: "Try it now" or "See what's new"
- Keep under 150 words
Press Release (Tier 1 Only)
- Headline: company + what + why it matters
- First paragraph: who, what, when, why in 2-3 sentences
- Quote from CEO or product lead
- Key features (3-5 bullets)
- Customer quote or early traction data
- Boilerplate and contact info
Launch Scorecard
| Metric | Day 7 Target | Day 30 Target |
|---|---|---|
| Signups | 500 | 2,000 |
| Activation rate | 30% | 40% |
| Free-to-paid conversion | 3% | 5% |
| NPS | > 25 | > 35 |
| Support ticket rate | < 15% of signups | < 10% of signups |
| Press mentions | 3-5 articles | 10+ articles |
Adjust targets based on your market, price point, and channel mix. These are benchmarks for a B2B SaaS product with a self-serve motion.
Sales Enablement
Pitch Deck Structure (10-12 Slides)
- Problem - The pain your buyer feels daily (use their words)
- Cost of inaction - What happens if they do nothing? Quantify it
- Market shift - Why now? What changed that makes this solvable?
- Our approach - How we think about the problem differently
- Product - 3-4 key workflows shown, not feature lists
- Proof - Metrics, logos, or data that validate the approach
- Case study - One customer story with before/after
- Implementation - How they get started (timeline, effort, support)
- ROI model - Expected return with conservative assumptions
- Pricing - Tiers, what is included, anchor to value not cost
- Next steps - Clear ask: pilot, trial, or procurement process
Deck Variants by Buyer Type
Technical buyer (engineering lead, architect):
- Lead with architecture diagram and security posture
- Show API docs, integration patterns, data flow
- Address: "Will this break our existing stack?"
Economic buyer (VP, C-suite):
- Lead with ROI model and payback period
- Show total cost of ownership vs. alternatives
- Address: "What is the business impact?"
Champion (internal advocate):
- Lead with quick wins they can show their boss
- Provide internal selling toolkit (one-pager, ROI calc)
- Address: "How do I get buy-in?"
One-Pager Format
- Problem: One sentence stating the pain
- Solution: One sentence stating your approach
- Three differentiators: What makes you different (not better, different)
- One proof point: Customer quote, metric, or logo
- CTA: One clear next step
Must be scannable in 30 seconds. If it requires reading, it is too long.
Objection Handling Framework
For each common objection, document:
- Statement: What they say ("We already have a solution for this")
- Why they say it: The underlying concern (switching cost, risk, inertia)
- Response: Acknowledge, then reframe ("Totally fair - most of our customers used X before. The difference is...")
- Proof point: Specific evidence that addresses the concern
- Follow-up question: Move the conversation forward ("What would need to be true for you to consider switching?")
Battle Cards (Per Competitor)
| Section | Content |
|---|---|
| Positioning | How they describe themselves vs. how we describe them |
| Pricing | Their model, typical deal size, discount behavior |
| Strengths | What they genuinely do well (be honest) |
| Weaknesses | Where they fall short (with evidence) |
| Customer complaints | What their users say in reviews, forums, support |
| Win/loss insights | Why we win against them, why we lose |
| Killer questions | Questions that expose their weaknesses naturally |
Demo Best Practices
"Demo after discovery, not before." Know their pain points before showing the product.
- First 5 minutes: confirm what you learned in discovery
- Show only 2-3 workflows that map to their stated problems
- Let them drive if possible ("Want to try clicking through this?")
- End with: "Based on what you've seen, how does this compare to your current process?"
Proposal Anti-Patterns
| Anti-Pattern | Fix |
|---|---|
| Too long (20+ pages) | Aim for 5-7 pages. Appendix for details |
| Too generic | Customize the first page to their specific situation |
| Burying the price | Put pricing on page 2-3, not the last page |
| Feature dump | Organize by their problems, not your features |
| No timeline | Include implementation timeline with milestones |
GTM Motion Selection
Choose your motion based on product complexity and deal size.
Self-Serve
- When: Low price point (< $50/mo), simple onboarding, broad market
- Key metrics: Signup rate, activation rate, self-serve conversion
- Focus: Product experience, onboarding flow, in-app guidance
Sales-Led
- When: High ACV (> $25k/year), complex implementation, enterprise buyers
- Key metrics: Pipeline, win rate, deal size, sales cycle length
- Focus: Sales enablement, demo quality, proposal process
Hybrid (Self-Serve + Sales)
- When: SMB self-serves, enterprise needs sales touch
- Key metrics: Self-serve revenue %, sales-assisted conversion rate
- Focus: Clear handoff triggers from self-serve to sales
Product-Led Sales
- When: Users adopt bottom-up, sales expands accounts
- Key metrics: PQL rate, expansion revenue, seat growth
- Focus: Usage signals that trigger sales outreach, expansion playbook
Decision framework: Start with the simplest motion that works. Add sales only when you see deals stalling that a human could unstick.
marketing-psychology.md
Marketing Psychology: 40+ Mental Models for Marketers
A practical reference mapping psychological principles to marketing decisions. Each model includes the core insight, when to apply it, and a concrete example.
Foundational Thinking Models
These are meta-models - they shape HOW you think about marketing problems before applying specific psychology.
1. First Principles Thinking
Strip away assumptions and rebuild from ground truth. Don't do content marketing because competitors do - ask what your audience actually needs and work backward.
- Apply when: Entering a new market, challenging an existing strategy, or when "best practices" aren't delivering results.
- Example: Instead of assuming you need a blog because every SaaS has one, ask: Where does our audience actually seek information? Maybe it's YouTube or Slack communities.
2. Inversion
Instead of asking "how do we succeed?", ask "what guarantees failure?" then prevent each item.
- Apply when: Planning campaigns, designing onboarding, or auditing funnels.
- Failure list: Unclear value prop, too many steps, broken trust signals, no urgency, wrong audience targeting, slow page load.
3. Pareto Principle (80/20)
20% of your channels, content, or customers drive 80% of results. Find and double down on the vital few.
- Apply when: Allocating budget, prioritizing channels, or deciding which content to produce more of.
- Action: Pull last quarter's attribution data. Rank channels by revenue. Cut or reduce the bottom 50%.
4. Theory of Constraints
Every system has one bottleneck. Fixing anything else is wasted effort until the bottleneck is resolved.
- Apply when: Conversion rates plateau, growth stalls, or you're optimizing multiple things at once.
- Example: If your funnel leaks 70% at signup, optimizing email nurture sequences downstream is premature.
5. Barbell Strategy
Allocate 80% of budget to proven, reliable channels. Use 20% for high-risk experimental bets.
- Apply when: Setting quarterly marketing budgets or planning campaign portfolios.
- Example: 80% on Google Ads (known ROAS), 20% on TikTok creator partnerships (unproven but high-ceiling).
6. Local vs Global Optima
Optimizing within the wrong system yields diminishing returns. Step back and question the system itself.
- Apply when: You've A/B tested subject lines 15 times but open rates barely moved - maybe email isn't the right channel at all.
- Warning sign: Marginal improvements despite heavy optimization effort.
7. Jobs-to-be-Done (JTBD)
People don't buy products. They hire them to make progress in a specific situation.
- Apply when: Writing positioning, designing landing pages, or choosing messaging angles.
- Example: People don't buy a drill for the drill - they buy it for the hole. But they don't want the hole either - they want the shelf on the wall. Go deeper.
Buyer Psychology
These models explain how people actually make purchasing decisions.
8. Social Proof
People follow the actions of others, especially similar others. Specific proof beats vague claims.
- "2,847 engineering teams use us" beats "Thousands of customers trust us"
- Named logos with use-case context beat a generic logo wall
- Key: Match proof to the prospect's identity. Enterprise buyers want enterprise logos.
9. Loss Aversion
The pain of losing something is roughly 2x the pleasure of gaining it. Frame around what they'll lose.
- Apply when: Writing CTAs, urgency messaging, or competitive displacement campaigns.
- Example: "Stop losing $4,200/month to manual processes" outperforms "Save $4,200/month with automation."
10. Anchoring Effect
The first number people see sets the reference point for all subsequent judgments.
- Apply when: Pricing pages, discount framing, or ROI calculators.
- Example: Show the enterprise plan ($299) first. Now the pro plan ($99) feels reasonable. Show the $99 plan first and it feels expensive.
11. Scarcity
Limited availability increases perceived value - but only when genuine.
- Apply when: Launches, cohort-based programs, or capacity-constrained offers.
- Must be real: "Only 3 left" when you have 3,000 units will destroy trust permanently when discovered.
- Types: Time-limited (enrollment closes Friday), quantity-limited (50 seats), access-limited (invite only).
12. Endowment Effect
Once people feel ownership, they value something more. Trials and freemium create psychological ownership.
- Apply when: Designing trial experiences, freemium tiers, or onboarding flows.
- Example: Let users customize their dashboard during trial. Customized setups feel "theirs" and are harder to abandon.
13. IKEA Effect
People overvalue things they helped create. Participation increases perceived value.
- Apply when: Product configuration, interactive demos, or co-creation experiences.
- Example: A custom report builder that lets prospects input their own data produces higher engagement than a static case study.
14. Zero-Price Effect
The jump from $0 to $1 is psychologically massive - far larger than $1 to $2. Free isn't just cheap, it's a different category.
- Apply when: Pricing tier design, lead magnets, or freemium strategy.
- Example: A free tier with real value creates a massive user base. Converting 3% of free users often beats trying to sell 100% from day one.
15. Hyperbolic Discounting
People massively prefer immediate rewards over future ones, even when the future reward is objectively larger.
- Apply when: Writing benefit copy, designing onboarding, or structuring offers.
- Example: "See your first report in 5 minutes" beats "Comprehensive analytics platform that transforms your data strategy over time."
16. Peak-End Rule
People judge experiences by the most intense moment (peak) and the final moment (end), not the average.
- Apply when: Designing customer journeys, webinars, onboarding, or cancellation flows.
- Example: A webinar with one genuinely surprising insight and a strong closing CTA will be remembered better than a uniformly good but unremarkable session.
17. Paradox of Choice
More options lead to decision paralysis, lower satisfaction, and higher abandonment.
- Apply when: Pricing pages, product catalogs, or feature comparisons.
- Rule: Limit to 3-4 options maximum. Highlight one as "recommended."
- Data: Jam study - 24 varieties got 3% conversion, 6 varieties got 30%.
18. Status-Quo Bias
People prefer the current state. Switching has cognitive cost even when objectively beneficial.
- Apply when: Competitive displacement, migration campaigns, or upgrade prompts.
- Counter: Make switching effortless (migration tools, data import, concierge onboarding). Quantify the cost of staying.
19. Default Effect
Pre-selected options are chosen 70-90% of the time. People rarely change defaults.
- Apply when: Pricing page design, plan selection, feature toggles, or opt-in forms.
- Example: Pre-select the annual billing option. Pre-check the "recommended" plan. Pre-fill form fields where possible.
20. Pratfall Effect
Admitting a small weakness increases trust and likability - but only when overall competence is established.
- Apply when: Landing page copy, comparison pages, or sales conversations.
- Example: "We're not the cheapest option. We're the one that actually works." Basecamp's "We're not for everyone" messaging.
21. Bandwagon Effect
Momentum itself drives adoption. People want to join what's growing, not what's stagnant.
- Apply when: Launch campaigns, growth messaging, or community building.
- Example: "12,000 teams joined this quarter" signals momentum. Show growth rate, not just total numbers.
Persuasion Principles
Based on Cialdini's research plus modern extensions.
22. Reciprocity
Give genuine value first, and people feel compelled to give back. The gift must feel unconditional.
- Apply when: Lead generation, content strategy, or sales outreach.
- Example: A genuinely useful free tool (not a gated PDF) creates stronger reciprocity than a "free ebook" behind a form.
23. Commitment and Consistency
Small commitments lead to larger ones. People want to act consistently with past behavior.
- Apply when: Progressive profiling, onboarding sequences, or upgrade paths.
- Sequence: Free signup - complete profile - use one feature - invite a teammate - upgrade to paid.
24. Authority
Expert endorsements and credible signals reduce perceived risk. Authority must be relevant.
- Apply when: Building landing pages, writing case studies, or designing trust elements.
- Signals: Industry certifications, expert quotes, peer-reviewed results, media mentions, years of domain expertise.
25. Liking
People buy from people and brands they like. Personality, humor, and authenticity outperform corporate polish.
- Apply when: Brand voice, social media, email tone, or founder-led marketing.
- Example: Mailchimp's irreverent voice, Basecamp's opinionated blog, Duolingo's TikTok personality.
26. Unity
Shared identity creates deeper connection than shared interests. "We" is more powerful than "you."
- Apply when: Community building, brand positioning, or audience segmentation.
- Example: "Built by developers, for developers" creates unity. "A tool developers might find useful" does not.
27. Foot-in-the-Door
Start with a small, easy request. Escalate after commitment is established.
- Apply when: Conversion funnels, trial-to-paid flows, or upsell sequences.
- Sequence: Free trial - paid monthly - annual plan - enterprise add-ons.
28. Door-in-the-Face
Start with a large request (expected to be rejected). The actual ask feels reasonable by comparison.
- Apply when: Sales negotiations, pricing conversations, or partnership proposals.
- Example: Present the $50k enterprise package first. When they hesitate, offer the $12k growth plan - it feels like a deal.
Pricing Psychology
How people perceive and evaluate prices.
29. Rule of 100
For prices under $100, show percentage discounts (25% off). For prices over $100, show dollar amounts ($50 off). Choose whichever produces the larger-looking number.
30. Charm Pricing
$99 feels meaningfully cheaper than $100 due to left-digit anchoring. The brain encodes $99 as "ninety-something."
- Use for: Consumer products, self-serve SaaS, or value-positioned offers.
- Skip for: Premium or luxury positioning where round numbers signal quality.
31. Round Pricing
$100 feels premium. Round numbers signal quality and reduce cognitive effort.
- Use for: Enterprise pricing, premium tiers, or luxury positioning.
- Why: Round numbers are processed fluently, which signals confidence and simplicity.
32. Decoy Effect
Introduce a third option that makes your target option look like the best deal.
- Classic example: Small ($3), Large ($7), Medium ($6.50). Nobody picks Medium - it makes Large look like a steal.
- Apply when: Designing pricing tiers or product bundles.
33. Mental Accounting
People evaluate money differently depending on how it's categorized. Reframe to a more comfortable mental account.
- Apply when: Pricing communication, ROI framing, or subscription messaging.
- Example: "$3/day" (coffee money) feels smaller than "$90/month" (a bill) even though it's the same. "$1,080/year" (budget line item) feels different again.
34. Price-Quality Heuristic
When people can't evaluate quality directly, they use price as a proxy. Higher price signals higher quality.
- Apply when: Positioning in crowded markets or launching premium tiers.
- Warning: Only works when quality signals are ambiguous. Clear quality differences override price signals.
35. Pain of Paying
Each payment triggers a micro-pain response. Subscriptions spread and reduce this pain vs lump-sum payments.
- Apply when: Choosing payment models, designing checkout flows, or pricing annual plans.
- Reduce pain: Auto-renewal, bundled pricing, annual plans, free trials before first charge.
Behavioral Design
Frameworks for designing environments that guide behavior.
36. BJ Fogg Behavior Model
Behavior = Motivation x Ability x Prompt. All three must be present simultaneously.
- Low conversion? Diagnose which element is missing:
- Motivation: Benefits unclear, no urgency, irrelevant to their situation
- Ability: Too many steps, confusing interface, requires too much information
- Prompt: CTA invisible, badly timed, wrong channel
37. EAST Framework
Make desired actions Easy, Attractive, Social, and Timely.
- Easy: Reduce form fields, pre-fill data, one-click actions
- Attractive: Visual hierarchy, contrast, whitespace around CTAs
- Social: Show what peers are doing, add social proof near decision points
- Timely: Trigger messages when motivation is highest (after a feature use, at renewal time)
38. Nudge Theory
Small changes in the decision environment significantly alter behavior without restricting options.
- Examples: Default selections, strategic placement, simplified choices, timely reminders.
- Apply when: Designing signup flows, checkout pages, or email sequences.
- Key: Nudges preserve freedom of choice. They guide, not force.
39. Hick's Law
Decision time increases logarithmically with the number of options. Fewer options means faster decisions.
- Apply when: Navigation design, pricing pages, CTAs, or feature presentation.
- Rule: One primary CTA per page. Maximum 3-4 pricing tiers. Progressive disclosure for complex features.
40. Activation Energy
Every action has a minimum energy threshold to begin. Reduce the starting energy and more people act.
- Apply when: Onboarding, trial signups, or first-use experiences.
- Tactics: No credit card required, social login, pre-built templates, skip-to-value onboarding.
- Example: "Start in 30 seconds" beats "Create your account to begin your journey."
Quick Reference: Challenge to Model Mapping
| Marketing Challenge | Primary Models | Secondary Models |
|---|---|---|
| Low conversions | Hick's Law, BJ Fogg, Default Effect | Activation Energy, Zero-Price |
| Price objections | Anchoring, Mental Accounting, Rule of 100 | Loss Aversion, Decoy Effect |
| Building trust | Authority, Social Proof, Pratfall Effect | Reciprocity, Liking |
| Retention/churn | Endowment Effect, Status-Quo Bias, IKEA Effect | Commitment, Peak-End Rule |
| Decision paralysis | Paradox of Choice, Default Effect, Decoy | Nudge Theory, Hick's Law |
| Low engagement | Peak-End Rule, Reciprocity, Liking | Unity, Hyperbolic Discounting |
| Upselling | Foot-in-the-Door, Commitment, Anchoring | Door-in-the-Face, Bandwagon |
| Creating urgency | Loss Aversion, Scarcity, Hyperbolic Discounting | Bandwagon, FOMO |
| Brand building | Liking, Unity, Bandwagon, Authority | Pratfall Effect, Social Proof |
| Channel selection | Pareto, First Principles, Local vs Global | Theory of Constraints, Inversion |
| Pricing strategy | Anchoring, Decoy, Charm/Round Pricing | Price-Quality, Pain of Paying |
Ethical Application Guidelines
Psychology in marketing is a tool - the ethics depend entirely on how you wield it.
Principles:
Help decisions, don't manufacture them. Use psychology to remove friction for people who genuinely benefit from your product. Never push someone toward a bad decision.
Fake scarcity destroys trust permanently. "Only 2 left!" when you have unlimited inventory will be discovered. One viral screenshot of your lie undoes years of brand building.
Dark patterns violate FTC guidelines. Hidden fees, trick questions, forced continuity, and disguised ads are not just unethical - they're increasingly illegal. The FTC has taken enforcement action against companies using dark patterns.
Transparency builds long-term loyalty. Buffer publishes their pricing rationale. Patagonia tells you not to buy their jacket. Radical transparency is itself a psychological lever - and the most sustainable one.
The test: Would you be comfortable if your customer saw exactly how and why you designed this experience? If not, redesign it.
Red lines:
- Never fabricate social proof (fake reviews, inflated numbers)
- Never create artificial scarcity or fake urgency
- Never hide material terms or make cancellation difficult
- Never exploit vulnerable populations (elderly, children, financially distressed)
- Never use loss aversion to create anxiety rather than inform decisions
paid-and-performance.md
Paid Advertising & Performance Analytics
Platform Selection
| Platform | Best For | Targeting Strength | Cost Profile | Creative Format |
|---|---|---|---|---|
| Google Ads | High-intent search | Keyword intent, in-market | CPC varies by vertical | Text, Shopping, Video |
| Meta | Demand gen, visual | Interest, lookalike, pixel | CPM $5-15 avg | Image, Video, Carousel |
| B2B, enterprise | Job title, company, seniority | Higher CPMs ($30-80) | Sponsored content, InMail | |
| TikTok | Awareness, younger demo | Interest, creative-first | Lower CPMs, volatile | Video-native, UGC-style |
When to use which
- Google Ads - User is actively searching. Bottom-of-funnel. Best ROAS for known-intent products.
- Meta - User is not searching but fits your profile. Mid-to-top funnel. Visual products shine.
- LinkedIn - Decision-maker targeting matters more than cost. B2B with $10k+ ACV. Accept higher CPMs for precision.
- TikTok - Brand awareness, younger demographics (18-34). Creative quality matters more than targeting. Organic-feeling content wins.
Campaign Structure & Budget
Budget allocation
- 70% proven - Campaigns and audiences with demonstrated ROI
- 30% testing - New audiences, creatives, platforms, offers
- Never put more than 30% of total budget into unproven experiments
- Reserve 5-10% of the testing budget for truly wild experiments
Scaling rules
- Increase budget 20-30% at a time - never double overnight
- Wait 3-5 days between increases to let the algorithm stabilize
- If performance dips after scaling, hold for 48 hours before reverting
- Horizontal scaling (new ad sets) is safer than vertical scaling (increasing budget)
- Duplicate winning ad sets rather than endlessly raising spend on one
Bid strategy progression
| Stage | Strategy | When to move on |
|---|---|---|
| Launch | Manual CPC or cost caps | Gathering initial data |
| Learning | Target CPA with caps | 50+ conversions in 30 days |
| Scaling | Automated with ROAS targets | Stable CPA over 2+ weeks |
| Mature | Monitor and adjust targets | Weekly review cadence |
- Do not switch to automated bidding until you have at least 50 conversions in the conversion window
- Set target CPA 10-20% above actual CPA when switching to automated
- Always set maximum bid caps to prevent runaway spend
Ad Creative
Testing hierarchy (test in this order)
- Concept/angle - What story are you telling? What pain point?
- Hook/headline - First impression, scroll-stopping element
- Visual style - Photography vs illustration vs UGC vs motion
- Body copy - Supporting message, benefits, proof points
- CTA - Button text, urgency, offer framing
Test higher-order elements first. A better angle beats a better CTA every time.
Video ad structure (15-30s)
| Segment | Timing | Purpose |
|---|---|---|
| Hook | 0-3s | Stop the scroll - pattern interrupt |
| Problem | 3-8s | Agitate the pain point |
| Solution | 8-20s | Show the product solving it |
| CTA | 20-30s | Clear next step with urgency |
- 85% of users watch without sound - always add captions
- Front-load the value proposition in the first 3 seconds
- Show the product in use, not just the logo
- Square (1:1) works across more placements than 16:9
- Vertical (9:16) for Stories, Reels, TikTok
Batch creative generation
| Wave | What | Volume |
|---|---|---|
| Wave 1 | 3-5 distinct angles | 5 variations each |
| Wave 2 | Extend top 2 performing angles | 5-8 new variations |
| Wave 3 | Wild cards and experiments | 3-5 variations |
- Run Wave 1 for 7-10 days
- Promote winners from Wave 1 into Wave 2
- Wave 3 tests completely new concepts to avoid creative fatigue
- Refresh creative every 4-6 weeks to combat ad fatigue
Ad Angle Categories
Systematically generate angles before writing creative:
| Angle | Hook Pattern | Example |
|---|---|---|
| Pain point | "Tired of [problem]?" | "Tired of losing deals to slow follow-up?" |
| Outcome | "[Result] in [timeframe]" | "Close 30% more deals this quarter" |
| Social proof | "[Number] teams use [product] to..." | "10,000+ teams ship 3x faster" |
| Curiosity | "The [thing] most [people] miss" | "The metric most marketers ignore" |
| Comparison | "[Old way] vs [new way]" | "Spreadsheets vs. real-time dashboards" |
| Urgency | "[Deadline/scarcity] + [benefit]" | "Free until Friday - then $49/mo" |
| Identity | "Built for [persona]" | "Built for founders who hate busywork" |
| Contrarian | "[Common belief] is wrong" | "More features won't save your product" |
Test 3-5 angles in Wave 1. The winning angle matters more than the winning headline.
Creative Iteration Workflow
After initial performance data (7-10 days, 1,000+ impressions per creative):
- Identify winners - Top 2-3 by primary metric (CTR for awareness, CPA for conversion)
- Analyze losers - Why did they fail? Wrong angle, weak hook, unclear CTA, or wrong audience?
- Iterate winners - New hooks with same angle, different visuals, alternate CTAs
- Log learnings - Maintain an iteration log: creative ID, angle, hook, result, learning
- Refresh cycle - Replace bottom 20% of creatives every 2-3 weeks
Minimum sample size
- 1,000 impressions minimum before judging any creative
- 100 clicks minimum before judging CTR reliability
- 20-30 conversions minimum before judging conversion rate
- Statistical significance matters - use a calculator, do not eyeball it
Platform Character Limits
| Platform | Element | Character Limit | Notes |
|---|---|---|---|
| Google RSA | Headline | 30 chars x 15 slots | Min 3 required |
| Google RSA | Description | 90 chars x 4 slots | Min 2 required |
| Meta | Primary text | 125 visible (full: 2200) | First 125 chars matter |
| Meta | Headline | 40 chars | Truncates on mobile |
| Meta | Description | 30 chars | Often hidden on mobile |
| Intro text | 150 recommended (600 max) | First 150 before "see more" | |
| Headline | 70 chars | Keep under 50 for mobile | |
| TikTok | Ad description | 80 recommended (100 max) | Shorter performs better |
Write to the visible limit. Assume everything after the fold is invisible.
Retargeting
Audience windows
| Segment | Definition | Window | Frequency | Typical CPA |
|---|---|---|---|---|
| Hot | Cart abandon, trial start | 1-7 days | Higher freq OK (daily) | Lowest |
| Warm | Key pages, pricing, demo | 7-30 days | 3-5x per week | Medium |
| Cold | Any site visit | 30-90 days | 1-2x per week | Highest |
Retargeting rules
- Always exclude existing customers and recent converters
- Match creative to funnel stage - do not show the same ad to cart abandoners and blog readers
- Hot audience gets urgency and specific offers (discount, free trial extension)
- Warm audience gets social proof and case studies
- Cold audience gets brand reinforcement and education
- Set frequency caps per platform to avoid ad fatigue
- Burn pixels: remove users from retargeting once they convert
Analytics Tracking
Event naming conventions
- Format:
object_action- lowercase, underscores as separators - Be specific:
cta_hero_clickednotbutton_clicked - Include location context:
pricing_plan_selectednotplan_selected - Use past tense for completed actions:
form_submitted,video_played
Examples of good vs bad event names:
| Bad | Good | Why |
|---|---|---|
click |
cta_hero_clicked |
Specifies what and where |
pageview |
pricing_page_viewed |
Specifies which page matters |
submit |
lead_form_submitted |
Specifies the form type |
Button1 |
signup_button_clicked |
Descriptive, no arbitrary IDs |
UTM conventions
- All lowercase, no spaces
- Use hyphens for multi-word values:
utm_campaign=spring-sale-2024 - Consistent structure:
utm_source(platform),utm_medium(channel type),utm_campaign(campaign name),utm_content(creative variant),utm_term(keyword or audience) - Document all UTMs in a shared spreadsheet - UTM sprawl kills attribution
- Never put PII in UTM parameters
Core tracking principle
Track for decisions, not for data. Before adding any event, ask: "What decision will this data inform?" If there is no answer, do not track it.
GA4 essentials
- Enhanced measurement - Enable page views, scrolls, outbound clicks, site search, video engagement, file downloads
- Custom events - Key conversion actions specific to your product (signup, purchase, feature activation)
- Conversion events - Mark your 3-5 most important events as conversions
- Audiences - Build audiences for remarketing: engaged users, cart abandoners, feature users
- BigQuery export - Enable for raw data access if you need custom analysis beyond GA4 UI
Tracking implementation checklist
- Base analytics tag firing on all pages
- Conversion tracking pixel for each ad platform
- Server-side tracking for critical conversions (purchases, signups)
- UTM parameters on all paid links
- Cross-domain tracking if multiple domains
- Consent management for GDPR/CCPA compliance
- Enhanced conversions enabled (hashed first-party data)
Attribution Models
| Model | How it works | Best for | Limitation |
|---|---|---|---|
| First-touch | 100% credit to first interaction | Understanding discovery | Ignores nurture touchpoints |
| Last-touch | 100% credit to last interaction | Understanding closing | Ignores awareness channels |
| Linear | Equal credit to all touchpoints | Simple multi-touch | Over-credits low-value touches |
| Time-decay | More credit to recent touchpoints | Longer sales cycles | Under-credits awareness |
| Position-based | 40% first, 40% last, 20% middle | Balanced view | Arbitrary weighting |
| Data-driven | ML-based credit assignment | High-volume accounts | Needs significant data volume |
Attribution gotchas
- Platform attribution is inflated - every platform takes credit for the conversion. Facebook says it drove the sale. Google says it drove the sale. Both count it.
- Compare platform data to GA4 - GA4 is your neutral source of truth (with its own biases)
- Look at blended CAC - Total marketing spend / total new customers. This is the number that actually matters.
- Incrementality testing - The gold standard. Hold out a geographic or audience segment, measure the lift. Expensive but honest.
- View-through conversions - Count them separately. A 1-day view-through is more credible than 28-day.
- Data-driven attribution requires 300+ conversions per month to be reliable in most platforms.
Paid Benchmarks
| Metric | Google Search | Google Display | Meta (FB/IG) | General Target | |
|---|---|---|---|---|---|
| CTR | 3-5% | 0.5-1% | 1-2% | 0.5-1% | - |
| CPC | $1-5 (varies) | $0.50-2 | $0.50-3 | $5-12 | - |
| CPM | - | $2-10 | $5-15 | $30-80 | - |
| Conversion Rate | 3-5% | 0.5-1% | 1-3% | 1-3% | - |
| LTV:CAC ratio | - | - | - | - | 3:1 to 5:1 |
| Payback period | - | - | - | - | < 12 months |
| ROAS (e-commerce) | 4-8x | 2-4x | 3-6x | 2-4x | > 3x |
These are median benchmarks. Your vertical, offer, and funnel quality will cause significant variance. Always benchmark against your own historical data first.
Common Mistakes
- Starting without conversion tracking - Running ads without proper pixel/tag setup is burning money. Set up tracking before spending a dollar.
- Too many ad sets splitting budget - Each ad set needs enough budget to exit learning phase. 3-5 ad sets is better than 15.
- Not excluding existing customers - You are paying to re-acquire people who already bought. Always exclude customer lists.
- Judging creative under 1,000 impressions - Small sample sizes produce random results. Be patient.
- Scaling budget more than 30% - Large budget jumps reset the algorithm's learning. Scale gradually.
- Ignoring creative fatigue - Performance drops after 4-6 weeks. Refresh creative on a schedule, not just when metrics tank.
- Optimizing for vanity metrics - High CTR with low conversion rate means your ad promises something the landing page does not deliver.
- Same landing page for all campaigns - Match the landing page message to the ad. Search ads need different pages than social ads.
- No negative keywords (Google) - Without negatives, you pay for irrelevant searches. Review search terms weekly.
- Trusting platform attribution blindly - Cross-reference with GA4 and blended CAC. Every platform over-reports.
product-context.md
Product Marketing Context - Full Guide
A product marketing context document is the single source of truth that feeds every downstream deliverable - landing pages, ads, emails, positioning statements, and competitive battle cards. This guide covers how to build one, research customers, and define your ICP.
Building the Context Document
Path A: Auto-Draft
Scan available artifacts and pre-populate sections automatically.
| Source | Sections it feeds |
|---|---|
| README / docs | Product Overview, Differentiation |
| Landing pages | Value prop, Target Audience, Proof Points |
| package.json / manifest | Category, integrations, tech stack |
| Meta tags / OG data | Positioning, description, category |
| Marketing copy / ads | Customer Language, Objections |
| Changelog / release notes | Differentiation, Proof Points |
| Support tickets / FAQs | Pain Points, Objections |
| Competitor websites | Competitive Landscape |
After auto-draft, flag every section as [DRAFT] or [VERIFIED]. No section ships as verified without human review or customer data backing it.
Path B: Guided Build
Work through all 12 sections using discovery questions. Each section has a defined output format.
Section 1: Product Overview
Questions to answer:
- What does the product do in one sentence (no jargon)?
- What is the core value proposition?
- What category does it belong to? (use the customer's category, not yours)
- What is the primary use case?
- What are 2-3 secondary use cases?
Output format:
Product: [name]
One-liner: [plain language sentence]
Category: [market category]
Core value prop: [single sentence]
Primary use case: [description]
Secondary use cases: [list]Section 2: Target Audience
Questions to answer:
- Who is the primary buyer? (role/title, not demographics)
- What company profile? (size, industry, stage, tech stack)
- B2B, B2C, or B2B2C?
- Who influences the purchase vs. who signs the check?
- What is the typical buying process duration?
Output format:
Buyer role: [title/function]
Company profile: [size, industry, stage]
Model: [B2B / B2C / B2B2C]
Decision maker: [role]
Influencers: [roles]
Typical sales cycle: [duration]Section 3: Personas (2-3 max)
Template per persona:
| Field | Content |
|---|---|
| Role | Job title and function |
| Goals | Top 3 professional goals |
| Frustrations | Top 3 pain points with current approach |
| Evaluation criteria | How they judge solutions (speed, cost, features, support) |
| Trigger events | What makes them start looking for a solution |
| Preferred channels | Where they consume information and make decisions |
Anti-patterns to avoid:
- Do not name personas cutely ("Marketing Mary") - use role-based labels
- Do not average across segments - each persona should be distinct
- Do not invent personas without data - mark as
[HYPOTHESIS]until validated - Revisit personas quarterly - stale personas cause stale messaging
Section 4: Problems and Pain Points
Questions to answer:
- What are the top 3-5 problems your product solves?
- Use customer language, not internal jargon
- Prioritize problems mentioned unprompted over prompted responses
- What is the cost of inaction (staying with current approach)?
- Which problems are table-stakes vs. differentiating?
Prioritization matrix:
| Pain Point | Frequency | Intensity | Unprompted? | Cost of Inaction |
|---|---|---|---|---|
| [pain 1] | High/Med/Low | High/Med/Low | Yes/No | [describe] |
Section 5: Competitive Landscape
Three tiers of competition
| Tier | Definition | Example |
|---|---|---|
| Direct | Same solution, same problem | Competitor A vs. your product |
| Secondary | Different solution, same problem | Spreadsheets vs. your SaaS tool |
| Indirect | Conflicting approach to same goal | Outsourcing vs. your automation |
Per-competitor analysis
Competitor: [name]
Tier: [Direct / Secondary / Indirect]
Positioning: [their one-liner]
Pricing: [model and range]
Strengths: [2-3 bullet points]
Weaknesses: [2-3 bullet points]
Key differentiator from us: [one sentence]
Where they win deals: [scenario]
Where we win deals: [scenario]Update competitive analysis quarterly. Set calendar reminders.
Section 6: Differentiation
Focus on positioning, not features. Features are what you built. Positioning is why it matters.
Questions to answer:
- What can you do that competitors cannot or will not?
- What do customers say is different about you (in their words)?
- What is your unfair advantage (data, distribution, team, tech)?
- Complete: "Only [product] does [X] because [Y]"
Output: A positioning statement following the format:
For [target audience] who [situation/need],
[product] is the [category]
that [key benefit]
unlike [primary alternative]
because [reason to believe].Section 7: Objections and Anti-Personas
Common objection categories:
- Price ("too expensive")
- Timing ("not the right time")
- Authority ("need to check with...")
- Need ("we're fine with current approach")
- Trust ("how do I know this works?")
For each objection, document: the objection verbatim, the underlying concern, the response framework, and supporting proof points.
Anti-personas - people you should NOT sell to:
- Who consistently churns?
- Who requires disproportionate support?
- Who has use cases you do not support well?
Section 8: Switching Dynamics (JTBD Four Forces)
| Force | Direction | Discovery question |
|---|---|---|
| Push | Toward switching | "What frustrates you about your current approach?" |
| Pull | Toward switching | "What attracted you to [product]?" |
| Habit | Against switching | "What would you miss about your current tool?" |
| Anxiety | Against switching | "What concerns you about making a change?" |
Key principle: Push + Pull must exceed Habit + Anxiety for switching to occur.
For each force, collect 5+ verbatim customer quotes. Map the balance per persona - different roles have different force profiles.
Section 9: Customer Language
Rules:
- Exact customer words always beat polished marketing descriptions
- Collect phrases from: support tickets, sales calls, reviews, social posts, community forums
- Organize by theme, not by source
| Theme | Customer phrase (verbatim) | Source | Frequency |
|---|---|---|---|
| Speed | "I just need it to not take forever" | G2 review | 8x |
| Simplicity | "I don't want to read docs for an hour" | 5x |
Usage: Customer language feeds headlines, ad copy, email subject lines, and landing page copy directly. Do not paraphrase.
Section 10: Brand Voice
Four dimensions:
| Dimension | Spectrum | Our position |
|---|---|---|
| Formality | Casual --- Formal | [position] |
| Humor | Serious --- Playful | [position] |
| Enthusiasm | Reserved --- Enthusiastic | [position] |
| Technicality | Simple --- Technical | [position] |
We are / We are not pairs:
| We are | We are not |
|---|---|
| Direct | Blunt |
| Confident | Arrogant |
| Helpful | Patronizing |
| [add yours] | [add yours] |
Section 11: Proof Points
| Type | Content | Impact metric | Where to use |
|---|---|---|---|
| Metric | "Reduced deploy time by 40%" | Quantified outcome | Landing page, ads |
| Logo | [Company name] | Brand recognition | Homepage, decks |
| Case study | [Title] | Full narrative | Sales enablement |
| Testimonial | "[verbatim quote]" - Name, Title | Social proof | Emails, landing page |
| Award/Press | [Publication/award] | Third-party validation | Footer, about page |
Proof point quality ladder: Vanity metrics < Output metrics < Outcome metrics < Revenue/ROI metrics.
Section 12: Goals
90-day marketing goals:
1. [Goal] - Metric: [target] - Current: [baseline]
2. [Goal] - Metric: [target] - Current: [baseline]
3. [Goal] - Metric: [target] - Current: [baseline]
Constraints:
- Budget: [amount or range]
- Team: [size and roles]
- Dependencies: [list blockers]Voice of Customer Research
Extraction Framework (6 Dimensions)
For every customer data point, extract:
| Dimension | What to capture | Example |
|---|---|---|
| JTBD | The job the customer is hiring your product to do | "I need to ship features faster without breaking things" |
| Pain Points | Specific frustrations with current approach | "Our deploys take 45 minutes and fail half the time" |
| Trigger Events | What caused them to start looking | "We had a production outage that cost us a client" |
| Desired Outcomes | What success looks like to them | "Deploy in under 5 minutes with zero rollbacks" |
| Language/Vocabulary | Exact words and phrases they use | "CI/CD pipeline", not "continuous integration system" |
| Alternatives Considered | What else they evaluated or tried | "We looked at Jenkins and CircleCI before this" |
Confidence Labeling
| Level | Criteria |
|---|---|
| High | 3+ independent sources, mentioned unprompted |
| Medium | 2 sources, or prompted but consistent |
| Low | Single source, anecdotal |
Only use High confidence data for positioning statements and headlines. Medium for supporting copy. Low for internal hypotheses only.
Bias Awareness
| Source | Known bias | Mitigation |
|---|---|---|
| Online reviews | Over-represents power users and angry users | Weight by recency; cross-reference |
| Support tickets | Skews toward problems, misses happy paths | Pair with NPS/CSAT data |
| Reddit/forums | Technical and skeptical audience | Note demographic skew |
| Sales calls | Survivorship bias (only talks to prospects) | Include churned customer interviews |
| Surveys | Framing effects, social desirability | Use open-ended questions first |
| App store reviews | Extreme opinions (1-star and 5-star) | Focus on 2-4 star for nuance |
Minimum Viable Sample
5+ independent data points per segment before treating a finding as actionable. Below 5, label as [HYPOTHESIS].
Digital Watering Holes by ICP
| ICP | Primary sources | Secondary sources |
|---|---|---|
| B2B SaaS | Reddit (r/SaaS, r/startups), G2, HN, LinkedIn | Capterra, TrustRadius, industry Slack groups |
| SMB / Founders | Reddit, Indie Hackers, Product Hunt, Facebook groups | Twitter/X, niche forums, YouTube comments |
| Developer | DevOps subreddits, HN, Stack Overflow, Discord servers | Dev.to, GitHub discussions, tech podcasts |
| B2C | App store reviews, Reddit, YouTube, TikTok comments | Amazon reviews, Facebook groups, Twitter/X |
| Enterprise | LinkedIn, analyst reports (Gartner, Forrester), G2 Enterprise | Job postings (signals pain points), conference talks |
Asset-Specific Extraction Tips
| Asset Type | Look For | Watch Out For |
|---|---|---|
| Interview transcripts | "The moment they decided" - switching triggers | Leading questions that bias responses |
| Surveys | Segment before drawing conclusions | Open vs multiple-choice conflicts |
| Support tickets | Categorize by theme before analyzing | Over-indexes on problems, misses value |
| Win/loss interviews | Why they chose you (or didn't) | Post-hoc rationalization |
| NPS responses | Passives and detractors have highest signal | Promoters tell you what you want to hear |
| App store reviews | 2-4 star reviews for nuance | 1-star and 5-star are extreme outliers |
Research Deliverables
- Synthesis report - Top themes ranked by frequency x intensity, with representative quotes
- VOC quote bank - Organized by theme, tagged with persona and confidence level
- Persona documents - Updated with validated data
- JTBD map - Jobs, pains, gains per persona
- Competitive intel summary - What customers say about alternatives
- Research gap analysis - What we still don't know and how to find it
Use a 12-month recency window. Data older than 12 months should be revalidated.
Research Process
- Identify sources - Pick 3-5 watering holes matching your ICP
- Collect raw data - Gather 50+ data points (quotes, reviews, posts)
- Extract dimensions - Tag each data point with the 6 dimensions above
- Label confidence - Apply High/Medium/Low per finding
- Synthesize - Group findings by theme, identify patterns
- Update context doc - Feed findings into the relevant sections above
ICP Definition
Firmographic Criteria
| Criterion | Ideal | Acceptable | Disqualified |
|---|---|---|---|
| Industry | [target industries] | [adjacent industries] | [excluded] |
| Company size | [employee range] | [extended range] | [too small/large] |
| Geography | [primary markets] | [secondary markets] | [excluded regions] |
| Tech stack | [required technologies] | [compatible technologies] | [incompatible] |
| Growth stage | [ideal stage] | [acceptable stages] | [excluded stages] |
| Annual revenue | [target range] | [extended range] | [below minimum] |
Behavioral Criteria
| Criterion | Signal | How to detect |
|---|---|---|
| Pain trigger | Active problem that your product solves | Search queries, forum posts, support requests |
| Current solution | Using a workaround or competitor | Tech stack data, job postings, integrations |
| Buying signal | Budget allocated, timeline defined | Intent data, RFP activity, demo requests |
| Budget authority | Can approve purchase at your price point | Title, company size, procurement process |
| Champion potential | Internal advocate who will push adoption | Engagement level, questions asked, referrals |
Disqualification Criteria (Anti-ICP)
Document who you do NOT want as customers:
- Companies below [X] employees (support cost exceeds LTV)
- Industries with [specific constraint] (compliance, regulation)
- Teams without [prerequisite] (technical skill, process maturity)
- Buyers expecting [thing you do not do] (custom builds, white-label)
Optional: ICP Scoring Model
| Factor | Weight | 5 (ideal) | 3 (acceptable) | 1 (poor fit) |
|---|---|---|---|---|
| Company size | 25% | 50-500 employees | 10-49 or 501-2000 | < 10 or > 2000 |
| Pain intensity | 30% | Active, urgent problem | Recognized problem | No awareness |
| Budget fit | 20% | Budget allocated | Budget available | No budget |
| Tech readiness | 15% | Uses compatible stack | Willing to adopt | Incompatible |
| Champion access | 10% | Direct contact | Warm intro possible | No access |
Scoring: Weighted sum produces a 1-5 score. Prioritize leads scoring 4+. Nurture 3-4. Disqualify below 3.
Maintenance Schedule
| Section | Review frequency | Trigger for ad-hoc update |
|---|---|---|
| Product Overview | Quarterly | Major feature launch or pivot |
| Personas | Quarterly | New segment discovered |
| Competitive Landscape | Quarterly | Competitor raises funding, launches feature, changes pricing |
| Customer Language | Monthly | New batch of reviews or interviews |
| Proof Points | Monthly | New case study, metric, or logo |
| Goals | Quarterly | Goal achieved or strategy shift |
| ICP | Semi-annually | Significant churn pattern or new market entry |
search-visibility.md
Search Visibility Reference
Keyword Research
Tri-Surface Scoring (0-30)
Score every keyword across three surfaces before prioritizing:
| Surface | Score | Criteria |
|---|---|---|
| Organic | 0-10 | Volume, difficulty, SERP features present |
| AEO | 0-10 | Snippet opportunity, PAA presence, voice eligibility |
| GEO | 0-10 | AI Overview likelihood, citation potential, source authority |
Total = Organic + AEO + GEO. Prioritize keywords scoring 18+.
Search Intent Classification
| Intent | Signal Words | SERP Pattern |
|---|---|---|
| Informational | what, how, why, guide | Knowledge panels, PAA, wikis |
| Navigational | [brand], login, app | Brand sitelinks, homepage |
| Transactional | buy, pricing, discount, coupon | Shopping ads, product pages |
| Commercial Investigation | best, vs, review, compare | Listicles, comparison tables, review sites |
Modifiers by Buyer Stage
- Awareness: "what is", "how to", "why does", "examples of", "guide to"
- Consideration: "best", "vs", "comparison", "alternatives", "top 10"
- Decision: "pricing", "reviews", "demo", "free trial", "discount"
- Implementation: "templates", "tutorial", "setup", "integration", "API docs"
Cluster Building Process
- Gather keyword variants (seed + related + questions + long-tail)
- Group by SERP overlap: if 5+ of top 10 results are identical, keywords belong together
- Select primary keyword (highest volume in cluster)
- Name cluster after primary keyword
- Map one page per cluster - no cannibalization
Priority Formula
Priority = (monthly_volume * relevance_score) / keyword_difficultyWhere relevance_score = 1-10 based on product fit. Filter out priority < 5.
On-Page SEO
Title Tags
- 50-60 characters (Google truncates at ~600px)
- Primary keyword near the beginning
- No brand name in title (wastes characters unless brand is the query)
- Unique per page - never duplicate titles
Meta Descriptions
- 150-160 characters
- Include a compelling CTA ("Learn how to...", "Discover why...")
- Include primary keyword naturally (Google bolds matches)
- Not a ranking factor, but directly impacts CTR
Content Structure
- H1: One per page, contains primary keyword
- H2: Major sections, contain secondary keywords
- H3: Subsections, contain long-tail variants
- Internal links: 5-10 per 1,000 words
- Anchor text: Descriptive, keyword-relevant - never "click here"
- First 100 words: Include primary keyword naturally
Image Optimization
- Descriptive filenames:
blue-running-shoes.webpnotIMG_4521.webp - Alt text: Describe the image for screen readers, include keyword if natural
- Explicit
widthandheightattributes (prevents CLS) - Format: WebP (26% smaller than PNG) or AVIF (50% smaller)
- Lazy loading:
loading="lazy"on below-fold images - Responsive:
srcsetfor multiple resolutions
Technical SEO
Crawlability Essentials
- XML Sitemap: Submit to GSC, include only indexable URLs, update dynamically
- robots.txt: Block admin, staging, duplicate parameter URLs
- Canonicals: Self-referencing on every page, cross-domain when syndicating
- noindex: Use on thin pages, tag pages, internal search results, staging
Core Web Vitals Targets & Fixes
| Metric | Good | Fix Strategy |
|---|---|---|
| LCP < 2.5s | Preload hero image, inline critical CSS, CDN, reduce server response | |
| CLS < 0.1 | Set explicit dimensions, reserve ad slots, avoid dynamic content injection above fold | |
| INP < 200ms | Break long tasks, defer non-critical JS, use requestIdleCallback, reduce DOM size |
Site Architecture
- 3-click rule: Any page reachable in 3 clicks from homepage
- Navigation: 4-7 top-level items maximum
- URL design: Hyphens (not underscores), lowercase, short, descriptive
- Flat hierarchy:
/category/pagenot/category/subcategory/sub-subcategory/page
Common Technical Mistakes
- Dates in URLs (forces new URL for updates, loses equity)
- Over-nesting beyond 3 levels (dilutes crawl priority)
- Changing URLs without 301 redirects (immediate traffic loss)
- Leaving
noindexon staging then pushing to production - Orphan pages with zero internal links
- Mixed content (HTTP resources on HTTPS pages)
E-E-A-T & Topical Authority
E-E-A-T Breakdown
| Signal | What It Means | How to Demonstrate |
|---|---|---|
| Experience | First-hand involvement | Original screenshots, case studies, "I tested this" |
| Expertise | Deep subject knowledge | Detailed explanations, technical accuracy, credentials |
| Authoritativeness | Industry recognition | Backlinks, mentions, citations, speaking engagements |
| Trustworthiness | Reliability and honesty | HTTPS, clear policies, accurate claims, corrections |
E-E-A-T Audit Checklist
- Author byline with bio on every article
- Author credentials visible (certifications, experience)
- "Last reviewed" or "Updated" date on content
- Claims backed by citations to primary sources
- Comprehensive "About" page with team bios
- No AI-generated filler content (thin, generic, no unique insight)
- Contact information easily accessible
- Clear editorial policy or review process documented
Content Freshness Tiers
| Tier | Update Frequency | Content Types |
|---|---|---|
| High | Every 3-6 months | Pricing, tool comparisons, "best of" lists, statistics |
| Medium | Annually | How-to guides, strategy content, frameworks |
| Low | Every 18-24 months | Foundational concepts, historical content, glossaries |
Decay signal: Traffic drops 20%+ over a rolling 90-day window. Trigger a refresh.
SEO Audit Priority Order
- Crawlability - Can search engines find and access pages?
- Technical - CWV, mobile-friendliness, HTTPS, structured data errors
- On-Page - Titles, headings, content quality, internal links
- Content Quality - E-E-A-T, freshness, depth, uniqueness
- Authority - Backlink profile, brand mentions, domain trust
Issues by Site Type
| Site Type | Common Issues |
|---|---|
| SaaS | Missing comparison/alternative pages, thin feature pages, no programmatic SEO |
| E-commerce | Thin category descriptions, faceted navigation creating duplicate URLs, missing product schema |
| Blog/Publisher | Outdated content, keyword cannibalization, no topical clusters, thin author pages |
AEO (Answer Engine Optimization)
Featured Snippet Types
| Type | Format | Optimization |
|---|---|---|
| Paragraph | 40-60 words | Direct answer immediately after the question heading |
| Ordered list | 5-8 items | Step-by-step with H2/H3 + numbered list |
| Unordered list | 5-8 items | "Types of", "Examples of" + bullet list |
| Table | 3-5 columns | Comparison data in HTML <table> elements |
PAA (People Also Ask) Mining Workflow
- Search target keyword, expand all PAA boxes
- Click each PAA to generate more questions (cascade effect)
- Collect 20-40 questions per topic
- Group by theme
- Answer each in a dedicated H2 section (40-60 words per answer)
- Link between related answers
Voice Search Optimization
- Write answers in FAQ format (question as heading, answer as paragraph)
- Keep answers under 30 words for voice readback
- Use conversational, spoken-style language
- Target "near me" and question-based queries
AEO Rules
- Pages not ranking in top 10 rarely win featured snippets
- PAA boxes can be won from page 2 results
- Snippet ownership is volatile - monitor weekly
- Tables win snippets for comparison queries 3x more often than paragraphs
GEO (Generative Engine Optimization)
AI Overview Impact
- AI Overviews appear in ~45% of Google searches
- Clicks reduced by up to 58% when AI Overview is present
- Informational queries most affected; transactional least affected
Princeton Research: Content Signals That Improve AI Visibility
| Signal | Impact | Implementation |
|---|---|---|
| Cite sources | +40% | Link to studies, data, official docs |
| Statistics | +37% | Include specific numbers, percentages, dates |
| Quotations | +30% | Quote experts, researchers, practitioners |
| Authoritative tone | +25% | Write with confidence, avoid hedging |
| Clarity | +20% | Short sentences, clear structure, no jargon |
| Technical terms | +18% | Use domain-specific vocabulary correctly |
| Keyword stuffing | -10% | Actively penalized - write naturally |
Best combination: Fluency + Statistics outperforms any single signal.
Content Types Cited by AI
| Type | Citation Share |
|---|---|
| Comparisons | ~33% |
| Comprehensive guides | ~15% |
| Original research | ~12% |
| Listicles | ~10% |
AI Visibility Audit Framework
- Query audit - Test 20-50 target queries across ChatGPT, Perplexity, Google AI Overviews, and Gemini. Record: Are you cited? Which page? Competitor cited instead?
- Citation analysis - Brands are 6.5x more likely cited via third-party sources than their own domain. Check: Wikipedia, Reddit, review sites, industry publications.
- Content extractability check - For each priority page: self-contained paragraphs? Stats with sources? Comparison tables? FAQ schema? 40-60 word answer blocks?
- Bot access verification - Confirm robots.txt allows:
GPTBot,ChatGPT-User,PerplexityBot,ClaudeBot,anthropic-ai,Google-Extended,Bingbot - Gating audit - Any authoritative content behind login/paywall? AI cannot access it. Move key content to open pages.
Three Pillars of AI SEO
- Structure - Make content extractable: self-contained paragraphs, semantic headings as questions, data tables, FAQ schema
- Authority - Make content citable: statistics with sources, expert quotes, original research, clear definitions
- Presence - Be where AI looks: Wikipedia mentions, Reddit discussions, YouTube, review sites, industry directories
GEO Best Practices
- Write key passages of 40-60 words optimized for extraction
- Third-party citations outperform self-citations (Wikipedia = 7.8% of ChatGPT citations)
- Allow AI bots in robots.txt:
GPTBot,PerplexityBot,ClaudeBot,Google-Extended,Bingbot - Gating content behind logins kills AI visibility completely
- Structure content as self-contained, extractable paragraphs
- Include data tables - AI models love structured data
- Implement
llms.txtat site root for AI-readable documentation maps
Programmatic SEO
12 Playbooks
| Playbook | Example | Pattern |
|---|---|---|
| Templates | "[Tool] invoice template" | Template gallery + download |
| Curation | "Best [category] tools" | Curated list + mini-reviews |
| Conversions | "[X] to [Y] converter" | Input/output tool page |
| Comparisons | "[Tool A] vs [Tool B]" | Side-by-side feature table |
| Examples | "[Type] examples" | Gallery with explanations |
| Locations | "[Service] in [City]" | Localized landing pages |
| Personas | "[Tool] for [Role]" | Role-specific use cases |
| Integrations | "[Tool A] + [Tool B] integration" | Setup guide + benefits |
| Glossary | "What is [Term]" | Definition + context + related |
| Translations | "[Phrase] in [Language]" | Translation + usage examples |
| Directory | "[Category] companies" | Filterable directory listing |
| Profiles | "[Entity] profile" | Structured entity pages |
Data Defensibility Ranking
- Proprietary - Data you generate that nobody else has
- Product-derived - Data created through product usage
- User-generated - Reviews, ratings, contributions
- Licensed - Exclusive data partnerships
- Public - Available to anyone (lowest defensibility)
Programmatic SEO Rules
- Use subfolders, not subdomains (
/tools/xnotx.tools.com) - Every page must have unique value - not just swapped variables
- Quality over quantity - 500 excellent pages beat 50,000 thin pages
- Internal link every programmatic page to its cluster hub
Schema Markup (JSON-LD)
Essential Schema Types
| Type | Required Properties | Rich Result |
|---|---|---|
| Organization | name, url, logo, sameAs | Knowledge panel |
| Article | headline, author, datePublished, image | Article carousel |
| Product | name, offers (price, currency, availability) | Product snippet |
| FAQPage | mainEntity[].name, mainEntity[].acceptedAnswer | FAQ accordion |
| HowTo | name, step[].text, step[].name | How-to steps |
| BreadcrumbList | itemListElement[].name, .item, .position | Breadcrumb trail |
Implementation Notes
- Combine multiple schemas using
@grapharray in a single<script type="application/ld+json"> - Always validate with Google Rich Results Test
- Gotcha:
web_fetchandcurlcannot detect JS-injected JSON-LD - check page source directly - Nest
authorwithinArticle, referenceOrganizationvia@id - Keep
dateModifiedcurrent when content is updated
Link Building
Strategy Priority Order
- Digital PR - Newsworthy data studies, original research, expert commentary
- Resource page outreach - Get listed on curated resource pages in your niche
- Broken link building - Find broken links on relevant sites, offer your content as replacement
- Guest posts - Contribute to authoritative publications in your space
- Unlinked mentions - Find brand mentions without links, request attribution
Link Quality Checklist
- Domain Rating (DR) > 40
- Topically relevant to your niche
- Editorial placement (not paid, not sidebar widget)
- Page has real organic traffic
- Dofollow (nofollow links have limited value)
- Not on a page with 100+ outbound links
GSC Quick Wins for Link Building Targets
- Position 10-20: Pages close to page 1 - a few links could push them over
- CTR < 2% + high impressions: Visible but not clicked - improve title/meta + build links
- Clicks = 0 + impressions > 100: Indexed but invisible - needs authority boost
Internal Link Audit
- Fix orphan pages (0 internal links pointing to them)
- Add contextual links from high-authority pages to priority targets
- Use descriptive anchor text matching the target page's keyword
- Ensure every new page gets at least 3 internal links within first week
Site Architecture
URL Patterns by Page Type
| Page Type | Pattern | Example |
|---|---|---|
| Feature | /features/[name] |
/features/analytics |
| Pricing | /pricing |
/pricing |
| Blog | /blog/[slug] |
/blog/growth-strategy |
| Case study | /customers/[name] |
/customers/acme-corp |
| Docs | /docs/[section]/[page] |
/docs/api/authentication |
| Comparison | /compare/[competitor] |
/compare/competitor-name |
| Integration | /integrations/[name] |
/integrations/slack |
| Landing page | /lp/[campaign] |
/lp/free-trial |
Navigation Design
| Type | Purpose | Rules |
|---|---|---|
| Header nav | Primary navigation | 4-7 items max, CTA rightmost, logo links home |
| Dropdown | Secondary pages | 2 levels max, grouped logically |
| Footer | Discovery, legal, sitemap | 3-4 columns, organized by category |
| Breadcrumbs | Location context | On every page 2+ levels deep |
| Sidebar | Section navigation | Docs and blog categories only |
Site Type Templates
| Type | Typical Depth | Key Sections |
|---|---|---|
| SaaS | 2-3 levels | Features, Pricing, Customers, Blog, Docs, Integrations |
| E-commerce | 3-4 levels | Categories, Products, Collections, Blog |
| Content/Blog | 2 levels | Categories, Posts, About, Newsletter |
| Documentation | 3-4 levels | Getting Started, Guides, API Reference, Changelog |
social-and-community.md
Social Media & Community Reference
Platform Strategy Matrix
| Platform | Audience | Best Formats | Frequency | Engagement Benchmark |
|---|---|---|---|---|
| B2B, decision-makers, thought leadership | Text posts, carousels, newsletters, polls | 3-5x/week | 2-5% engagement rate | |
| X/Twitter | Tech, media, real-time commentary, brand voice | Threads, short takes, quote tweets, polls | 1-3x/day | 0.5-1% engagement rate |
| Visual-first, product discovery, lifestyle | Reels, carousels, Stories, collab posts | 3-5x/week | 1-3% engagement rate | |
| TikTok | TOFU, younger demos, creative-first | Short video (15-60s), duets, stitches | 3-7x/week | 3-9% engagement rate |
| YouTube | Long-form, SEO-driven, evergreen education | Tutorials, interviews, shorts, live streams | 1-2x/week | 2-5% CTR on impressions |
| Technical, anti-marketing, community trust | Comments, AMAs, genuine help, deep dives | 2-3x/week | Karma ratio, comment quality |
Key insight: Reddit punishes overt promotion. Lead with genuine expertise. Never link-drop without context.
Content Pillars
Distribute content across five pillars to maintain audience trust and avoid becoming a billboard:
| Pillar | Share | Examples |
|---|---|---|
| Industry insights | 30% | Trends, data breakdowns, market analysis, contrarian takes |
| Behind-the-scenes | 25% | Team culture, build process, failures, shipping stories |
| Educational | 25% | How-tos, frameworks, tutorials, explainers |
| Personal/founder | 15% | Lessons learned, career reflections, hot takes with context |
| Promotional | 5% | Product launches, feature announcements, case studies |
The 80/20 rule: 80% value-giving content, 20% asking (and most of that 20% should still deliver value).
Platform-Specific Templates
LinkedIn Post
[Hook line - bold claim, question, or surprising stat]
[Short paragraph - context or story, 2-3 sentences max]
[Short paragraph - the insight or framework]
[Short paragraph - what you learned or what this means]
[Question to drive comments]
#Hashtag1 #Hashtag2 #Hashtag3Rules:
- 3-5 hashtags max (not 30)
- Place external links in the FIRST COMMENT, not the post body (LinkedIn suppresses reach on posts with outbound links)
- Use line breaks aggressively - walls of text get scrolled past
- First line must hook within 210 characters (before "see more" truncation)
X/Twitter Thread
Tweet 1: [Hook - the boldest claim or most surprising insight] (1/N)
Tweet 2-N: [One insight per tweet, each should stand alone]
Final tweet: [CTA - follow, bookmark, reply with their take]
Retweet tweet 1 with a summary or alternate hook.Rules:
- Each tweet must work independently if someone screenshots it
- No hashtags in threads (they look spammy on X)
- Tag relevant people only when genuinely appropriate
- Quote-tweet your own thread 2-4 hours later for second wave of reach
Instagram Caption
[First 125 characters - the hook, visible before truncation]
[Body - story, insight, or value. Use line breaks and emojis sparingly for readability]
[CTA - save this, share with someone who needs it, drop a comment]
.
.
.
#hashtag1 #hashtag2 #hashtag3 #hashtag4 #hashtag5Rules:
- 3-5 targeted hashtags (mix of niche and mid-volume, avoid mega-hashtags)
- Separate hashtags from body with dot breaks
- Alt text on every image
- Reels outperform static posts 3-5x on reach
TikTok
- Hook in the first 3 seconds or lose the viewer
- Text overlay on screen for silent scrollers
- Use trending sounds (even at low volume) for algorithm boost
- 15-60 seconds optimal length
- Vertical 9:16 only
- End with a question or open loop to drive comments
- Post at high-activity times (lunch, evening, weekends)
Hook Formulas
| Type | Formula | Example |
|---|---|---|
| Curiosity | "Most people don't know that [surprising fact]..." | "Most people don't know that 70% of LinkedIn posts get zero engagement." |
| Story | "Last week I [relatable situation]..." | "Last week I lost a $50K deal because of one sentence in our pitch deck." |
| Value | "Here's the exact [framework/template] I use to [result]" | "Here's the exact 5-step framework I use to write LinkedIn posts that get 10K+ views." |
| Contrarian | "Stop [common advice]. Here's why..." | "Stop posting motivational quotes. Here's why they're killing your reach." |
| Number | "[N] [things] that [outcome]" | "7 pricing page mistakes that are costing you conversions." |
| Question | "Why does [observation] when [expected opposite]?" | "Why does your best content get the least engagement?" |
Test hooks by asking: Would I stop scrolling for this? If not, rewrite.
Weekly Content Calendar Template
| Day | Theme | Content Type | Platform Priority |
|---|---|---|---|
| Monday | Industry insight | Data, trends, analysis | LinkedIn, X |
| Tuesday | How-to / educational | Tutorial, framework, tips | LinkedIn, YouTube, Instagram |
| Wednesday | Behind-the-scenes | Team, process, culture | Instagram, TikTok, LinkedIn |
| Thursday | Social proof | Case study, testimonial, results | LinkedIn, Instagram |
| Friday | Engagement / fun | Poll, hot take, question, meme | X, Instagram, TikTok |
Platform Cadences
- LinkedIn: 3-5 posts/week. Tuesday-Thursday peak. Avoid weekends.
- X/Twitter: 1-3x daily including replies and quote tweets. Evenings and weekends perform well.
- Instagram: 3-5 feed posts/week + daily Stories. Reels 2-3x/week minimum.
- TikTok: 3-7x/week. Consistency matters more than quality initially.
- YouTube: 1-2 long-form/week + 3-5 Shorts. Consistency is critical for algorithm favor.
- Reddit: 2-3 genuine contributions/week. Quality over quantity always.
Daily Engagement Routine (30 Minutes)
| Time | Activity | Details |
|---|---|---|
| 5 min | Respond to comments | Reply to every comment on your posts from last 24h |
| 15 min | Comment on 5-10 target accounts | Leave thoughtful comments (not "Great post!") on accounts in your niche |
| 5 min | Share with insight | Reshare one piece of content with your own perspective added |
| 5 min | DM 2-3 people | Genuine relationship building - congratulate, ask questions, offer help |
Do this BEFORE posting new content. Engagement begets engagement. The algorithm rewards accounts that participate, not just broadcast.
Community Building
Owned vs. Rented Audiences
| Type | Examples | Pros | Cons |
|---|---|---|---|
| Owned | Email list, Slack/Discord, forum | Full control, direct access, portable | Slower to build |
| Rented | Social followers, subreddit presence | Faster growth, built-in distribution | Algorithm dependent, no control |
Strategy: Build on rented platforms, convert to owned. Every social post should have a path to your owned channel.
Value Ladder (Community Member Journey)
Lurker --> Commenter --> Contributor --> Moderator --> Advocate
| | | | |
Read React Create Lead Recruit
only & reply content discussions new membersTactics by stage:
- Lurker to Commenter: Ask direct questions, run polls, create low-barrier prompts
- Commenter to Contributor: Spotlight members, create templates they can fill in
- Contributor to Moderator: Invite to leadership, give special access
- Moderator to Advocate: Co-create content, share stage, revenue/recognition
Launch Strategy
- Start with 20-50 founding members (hand-picked, personally invited)
- Set norms early with a welcome post and community guidelines
- Seed 5-10 quality discussions before opening to more members
- Do not scale until engagement per member is healthy
Social Proof Generation
UGC (User-Generated Content) Campaigns
- Create a branded hashtag and promote it consistently
- Run challenges or prompts that are easy to participate in
- Repost UGC with credit (always ask permission first)
- Feature user content in Stories, carousels, and newsletters
Testimonial Collection
Ask at peak moments: immediately after a win, positive support interaction, or milestone.
Templates:
- "Hey [name], loved seeing [specific result]. Would you mind sharing a quick sentence about your experience?"
- "We're putting together a few customer stories - your [specific achievement] would be perfect. 2-3 sentences is all we need."
Never ask for generic "testimonials." Ask about specific outcomes, feelings, or moments.
Branded Hashtags
- Keep it short and unique (check that it's not already in use)
- Use it consistently in every post
- Encourage customers to use it by featuring posts that do
- Track it weekly for UGC opportunities
Reverse-Engineering Viral Content
- Find 10-20 creators in your niche who consistently get high engagement
- Collect 500+ of their top posts (tools: Taplio for LinkedIn, Tweet Hunter for X, manual for others)
- Analyze patterns: hook types, post length, format, topic clusters, posting times
- Codify into a playbook: "Their top posts are [format] about [topic] posted on [day] with [hook type]"
- Layer your voice: Adapt the patterns to your brand and perspective
- Convert attention to results: Always connect content back to your business goals
What to track in analysis:
- Hook style (question, stat, story, contrarian)
- Post length (short vs. long)
- Format (text, carousel, video, image)
- Topic category
- Call to action type
- Engagement type (comments vs. likes vs. shares)
Troubleshooting Declining Reach
| Symptom | Likely Cause | Fix |
|---|---|---|
| Sudden reach drop | External links in post body | Move links to comments |
| Gradual decline | Algorithm deprioritizing your format | Test video/Reels, increase frequency |
| Low comments | One-way broadcasting | End every post with a question, engage more in others' posts |
| Low shares/saves | Content isn't reference-worthy | Create more frameworks, templates, checklists |
| Possible shadow-ban | Violated platform guidelines or got mass-reported | Check platform status tools, reduce posting for 48h, review guidelines |
General fixes:
- Increase posting frequency (counterintuitive but works)
- Post natively - no scheduling tools for a week to test
- Engage heavily in comments for 30 min before and after posting
- Test a completely different format or topic
Crisis Communication (7 Steps)
- Pause all scheduled content immediately (including ads)
- Assess the situation within 30 minutes - what happened, what's the scope, who's affected
- Acknowledge publicly - "We're aware of [issue] and are investigating" (don't go silent)
- Respond with facts - share what you know, what you don't know, and what you're doing about it
- Move detailed conversations off-platform - direct to email, support, or a dedicated page
- Post a resolution update once resolved - what happened, what you did, what you changed
- Conduct a post-mortem internally - document the timeline, response, and improvements
Critical rules:
- Never delete comments unless they contain threats or slurs
- Never argue in public threads
- Pause ALL ads during a crisis (automated ads running during a PR crisis is a disaster)
- Designate one spokesperson for consistency
- Screenshot everything in case posts are deleted by others
Metrics That Matter
Engagement Rate Benchmarks by Platform
| Platform | Good | Great | Exceptional |
|---|---|---|---|
| 1-3% | 3-6% | 6%+ | |
| 2-5% | 5-8% | 8%+ | |
| X/Twitter | 0.5-1% | 1-3% | 3%+ |
| TikTok | 3-6% | 6-12% | 12%+ |
| YouTube | 2-5% CTR | 5-8% CTR | 8%+ CTR |
Metrics Hierarchy
- Revenue-adjacent: CTR to site, demo requests, sign-ups, attributed pipeline
- Growth: Follower growth rate (not total), email list growth from social
- Engagement quality: Save rate, share rate, comment quality, DMs received
- Vanity (track but don't optimize for): Total followers, total likes, impressions
Key ratios:
- Share-to-like ratio above 1:10 means content is reference-worthy
- Save-to-like ratio above 1:20 means content is bookmark-worthy
- Comment-to-like ratio above 1:15 means content drives conversation
Monthly Report (4 Questions)
Structure every monthly social report around these four questions:
1. What happened to our reach?
- Total impressions and reach by platform (vs. prior month and 3-month trend)
- Top 3 posts by reach - what pattern do they share?
2. What drove engagement?
- Engagement rate by platform and content pillar
- Which content pillar outperformed? Which underperformed?
- Top 3 posts by engagement - format, topic, hook type
3. What drove action?
- Click-through rate to website/landing pages
- Conversion events attributed to social (sign-ups, demos, purchases)
- Email list growth from social channels
- DMs and inbound inquiries
4. What are we changing next month?
- One thing to stop (underperforming format, topic, or platform)
- One thing to double down on (what's working)
- One experiment to run (new format, new platform, new cadence)
Keep the report to one page. If it takes more than 5 minutes to read, it won't get read.
testing-and-measurement.md
Testing and Measurement
A/B Test Design
Hypothesis Template
"Because [observation/data], we believe [change] will cause [expected outcome] for [audience]. We'll know when [metric] changes by [amount]."
Every test starts with a hypothesis. No hypothesis, no test. "Let's try a new headline" is not a hypothesis. "Because our hero bounce rate is 68% (above 50% benchmark), we believe a benefit-focused headline will reduce bounce rate by 15% for first-time visitors" is.
Sample Size Quick Reference
| Baseline Rate | 10% Lift | 20% Lift | 50% Lift |
|---|---|---|---|
| 1% | 150,000/var | 39,000/var | 6,000/var |
| 5% | 27,000/var | 7,000/var | 1,200/var |
| 10% | 12,000/var | 3,000/var | 550/var |
These assume 95% confidence, 80% power, two-tailed test. For one-tailed tests, reduce by ~20%. For 90% confidence, reduce by ~30%.
Traffic estimation: Total sample / daily traffic = days to run. If the test runs longer than 4 weeks, consider a bigger change (larger expected lift) or test on a higher-traffic page.
Metrics Selection
- Primary metric - Single metric that determines win/loss. One. Not two, not three. One.
- Secondary metrics - Support interpretation of the primary. Help you understand why the primary moved (or didn't).
- Guardrail metrics - Things that shouldn't get worse. Revenue per visitor when testing for signups. Page load time when testing new layouts. Unsubscribe rate when testing email frequency.
The Peeking Problem
Looking at results before reaching sample size inflates false positive rate from 5% to as high as 30%. Every peek is a chance to stop early on noise.
Rules:
- Pre-commit to sample size before launching
- Do not check results until sample size is reached
- Statistical significance requires 95% confidence minimum
- Run tests for full business cycles (minimum 1-2 weeks) to capture weekday/weekend variation
- If you must peek, use sequential testing methods (group sequential or always-valid p-values)
Test Prioritization
ICE scoring: (Impact + Confidence + Ease) / 3
- Impact: How much will this move the metric? (1-10)
- Confidence: How sure are you it will work? (1-10)
- Ease: How easy to implement? (1-10)
PIE framework: Potential, Importance, Ease
- Potential: How much room for improvement on this page?
- Importance: How valuable is the traffic to this page?
- Ease: How complex is the test to run?
General priority order: Test highest-traffic, highest-value pages first. A 5% lift on a page with 100K visitors beats a 20% lift on a page with 5K visitors.
Common Test Types
| Category | What to Test | Example |
|---|---|---|
| Copy | Headlines, CTAs, value props, social proof text | "Start Free Trial" vs "Get Started Free" |
| Layout | Hero section, form placement, CTA position | Above-fold CTA vs below-fold after explanation |
| Flow | Multi-step vs single page, field order, progress bars | 3-step signup vs single form |
| Pricing | Tier structure, anchoring, annual/monthly default | Annual pre-selected vs monthly pre-selected |
| Social proof | Placement, format, specificity | Logo bar vs case study quotes vs metrics |
Test Documentation
For every test, record:
- Hypothesis - Full hypothesis statement
- Variants - Description of control and each variant
- Sample size target - Per variant
- Metrics - Primary, secondary, guardrail
- Start/end dates - Actual, not just planned
- Result - Winner, lift amount, statistical significance
- Confidence level - p-value or confidence interval
- Learning - What did we learn beyond the result?
- Next action - Ship it, iterate, or kill it
Marketing Analytics
Event Naming Convention
Use Object-Action format. Lowercase. Underscores as separators.
Good examples:
cta_hero_clickedform_signup_submittedpricing_annual_toggledvideo_demo_playedmodal_upgrade_dismissed
Bad examples:
button_clicked(which button?)Click(uppercase, vague)formSubmit(camelCase, no object specificity)user-signed-up(hyphens, inconsistent format)
Be specific enough that the event name alone tells you what happened and where.
UTM Convention
| Parameter | Purpose | Examples |
|---|---|---|
utm_source |
Where traffic comes from | google, linkedin, newsletter, podcast |
utm_medium |
Marketing medium | cpc, social, email, referral, organic |
utm_campaign |
Specific campaign | spring-launch-2024, webinar-ai-series |
utm_content |
Differentiate similar links | cta_top, cta_bottom, sidebar_banner |
utm_term |
Paid search keywords | marketing+automation, crm+software |
UTM rules:
- Always lowercase
- Use hyphens for multi-word values (not underscores or spaces)
- Maintain a shared UTM registry so teams use consistent values
- Never put UTMs on internal links (it breaks session attribution)
- Use URL shorteners or redirects for clean sharing
GA4 Setup Checklist
- Enhanced measurement enabled (scroll, outbound clicks, site search, video, file downloads)
- Custom events defined and documented
- Conversion events marked (form submissions, signups, purchases)
- Audiences built for remarketing segments
- Google Ads linked (if running paid)
- Data retention set to 14 months (default is 2 months)
- Cross-domain tracking configured (if applicable)
- Internal traffic filtered
- Referral exclusions set (payment providers, auth redirects)
- Custom dimensions/metrics registered
Core Principle
Track for decisions, not data. Every event should answer: "What decision will this data inform?" If you can't answer that question, don't track it. More data is not better data. Unused data is technical debt.
Attribution Models
| Model | Credits | Best For | Weakness |
|---|---|---|---|
| First-touch | 100% to first interaction | Understanding discovery channels | Ignores nurture |
| Last-touch | 100% to last interaction | Understanding closing channels | Ignores awareness |
| Linear | Equal across all touchpoints | Even credit distribution | Dilutes signal |
| Time-decay | More weight to recent touches | Sales cycles with nurture | Undervalues discovery |
| Position-based | 40% first / 20% middle / 40% last | Balanced view of journey | Arbitrary weights |
| Data-driven | Algorithmic based on patterns | High-volume, mature programs | Needs significant data |
Attribution Gotchas
- Platform self-reporting bias: Every ad platform over-reports conversions. Facebook, Google, and LinkedIn all take credit for the same conversion. Compare platform data against GA4 for ground truth.
- Blended CAC over platform CPA: Total marketing spend / total new customers is more honest than any single platform's reported CPA.
- B2B attribution is hard: Long sales cycles (3-12 months), multiple stakeholders, committee decisions, and offline touchpoints make precise attribution nearly impossible.
- Dark social is real: DMs, Slack messages, word-of-mouth, podcast mentions - these drive real pipeline but are unmeasurable. Add "How did you hear about us?" as a freeform field on signup/demo forms. It's imperfect but captures what analytics can't.
- Attribution is directional, not precise: Use it to inform budget allocation, not to justify every dollar. If you're arguing over 5% attribution differences, you're missing the point.
Marketing KPI Dashboards
Acquisition Metrics
| Metric | What It Measures | Benchmark Range |
|---|---|---|
| Traffic by source/medium | Channel mix health | Varies by stage |
| Cost per click (CPC) | Paid efficiency | $0.50-$5 B2B, $0.20-$2 B2C |
| Cost per lead (CPL) | Lead gen efficiency | $20-$200 B2B, $5-$50 B2C |
| Customer acquisition cost (CAC) | Full cost to acquire | Varies widely |
| LTV:CAC ratio | Unit economics health | 3:1 to 5:1 is healthy |
Engagement Metrics
| Metric | What It Measures | Benchmark Range |
|---|---|---|
| Email open rate | Subject line effectiveness | 20-30% |
| Email CTR | Content relevance | 2-5% |
| Email CTOR (click-to-open) | Content quality for openers | 10-15% |
| Social engagement rate | Content resonance | 1-3% |
| Time on page | Content depth | 2-4 minutes |
| Content downloads | Gated content appeal | 5-15% of landing page visitors |
Conversion Metrics
| Metric | What It Measures | Benchmark Range |
|---|---|---|
| MQL to SQL rate | Lead quality | 30-50% |
| SQL to Opportunity | Sales qualification | 50-70% |
| Win rate | Sales effectiveness | 20-30% |
| Free-to-paid | Product-led conversion | 2-5% freemium, 15-25% trial |
| Average deal size / ACV | Revenue per customer | Varies by segment |
Retention Metrics
| Metric | What It Measures | Benchmark Range |
|---|---|---|
| Monthly churn rate | Customer loss velocity | <5% B2C, <2% B2B |
| Net revenue retention | Expansion vs contraction | >100% means expansion > churn |
| NPS | Customer advocacy | >40 good, >60 excellent |
RevOps Fundamentals
Lead Lifecycle
Subscriber > Lead > MQL > SQL > Opportunity > Customer > EvangelistMQL requires BOTH fit AND engagement. A perfect-fit company that never engages with your content is not an MQL - it's a target account. A student downloading every ebook you publish is not an MQL - it's a content consumer. MQL = right profile + meaningful buying signals.
Speed-to-Lead
- Contact within 5 minutes = 21x more likely to qualify
- After 30 minutes = 10x drop in qualification likelihood
- After 24 hours = effectively cold outreach
Speed-to-lead is one of the highest-leverage improvements in B2B marketing. Automate lead routing. Alert reps in real-time. Remove manual steps between form fill and first contact.
MQL-to-SQL Handoff SLA
- MQL alert fires immediately on qualification
- Rep contacts lead within 4 business hours
- Rep qualifies or rejects within 48 hours
- Rejected leads go back to nurture with a reason code
- Reason codes feed back into scoring model refinement
Track SLA compliance weekly. If reps consistently miss the 4-hour window, the problem is either too many MQLs (quality issue) or too few reps (capacity issue).
Pipeline Coverage
Target 3-4x quota in active pipeline. Below 3x means you're likely to miss. Above 5x means deals are stale or poorly qualified. Pipeline coverage is a leading indicator - if it drops, you have weeks to react before revenue misses.
Lead Scoring Mistakes
- Weighting downloads too heavily - Research behavior does not equal buying intent. A competitor downloading your whitepaper scores the same as a prospect.
- No negative scoring - Competitors, students, job seekers, and existing customers should lose points, not just gain them.
- All page visits scored equally - A pricing page visit is a buying signal. A careers page visit is not. Weight pages by intent.
- Set and forget - Recalibrate scoring quarterly. Compare MQL-to-close rates across score bands. If high-scoring leads don't convert, the model is wrong.
Lead Routing Methods
| Method | When to Use |
|---|---|
| Round-robin | Equal distribution, small team, similar territories |
| Territory-based | Geographic or industry segmentation |
| Account-based | Named accounts assigned to specific reps |
| Skill-based | Complex products requiring specialist knowledge |
Rules: Route to most specific match first. Always have a fallback owner. Set capacity limits per rep. Log all routing decisions for audit.
Pipeline Stage Management
| Stage | Definition | Required Fields | Exit Criteria |
|---|---|---|---|
| Qualified | Meets MQL criteria, rep accepted | Contact info, company, source | Discovery call scheduled |
| Discovery | Understanding needs and fit | Pain points, timeline, budget range | Demo/evaluation agreed |
| Demo/Evaluation | Prospect evaluating product | Use case documented, stakeholders | Proposal requested |
| Proposal | Pricing and terms shared | Proposal sent date, decision maker | Verbal agreement or objection |
| Negotiation | Terms being finalized | Redlines, legal review status | Signed contract |
| Closed Won | Deal signed | Contract, payment terms, start date | Handoff to CS |
| Closed Lost | Deal lost | Loss reason, competitor if any | Post-mortem logged |
Stage hygiene rules: Required fields must be filled before stage advance. Stale deal alerts at 2x average time-in-stage. Flag stage skips for manager review. Enforce close date discipline (no "end of quarter" defaults).
Lead Scoring Model
Build scoring from two dimensions:
Explicit (Fit) scoring - Does this lead match our ICP?
- Job title/seniority (+10-25 pts)
- Company size in range (+10-20 pts)
- Industry match (+10-15 pts)
- Technology stack fit (+5-10 pts)
Implicit (Engagement) scoring - Are they showing buying signals?
- Pricing page visit (+15 pts)
- Demo request (+25 pts)
- Case study download (+10 pts)
- Blog visit (+2 pts per visit, cap at 20)
- Email open (+1 pt, cap at 10)
Negative scoring:
- Competitor domain (-50 pts)
- Student email (-30 pts)
- Unsubscribed (-20 pts)
- No activity 30 days (-10 pts)
MQL threshold: typically 50-75 points with both fit AND engagement minimums met.
CRM Automation Essentials
| Trigger | Automation | Purpose |
|---|---|---|
| Form submission | Create/update contact, assign owner, notify rep | Speed-to-lead |
| MQL threshold hit | Alert sales, create task, start SLA timer | Handoff |
| Demo scheduled | Send confirmation, prep doc to rep, reminder sequence | Meeting prep |
| No-show | Trigger reschedule email, notify rep, flag in CRM | Recovery |
| Deal closed won | Handoff to CS, trigger onboarding, update reporting | Customer success |
| Deal closed lost | Trigger loss survey, add to nurture, log reason | Learning |
Deal Desk Triggers
Route to deal desk when:
- ACV exceeds $25K
- Non-standard payment terms requested
- Multi-year commitments
- Volume or enterprise discounts
- Custom legal or security requirements
- Channel/partner deals with revenue sharing
Frequently Asked Questions
What is absolute-marketing?
Unified marketing skill for every channel and stage. Use when writing copy, optimizing conversions, planning content strategy, running SEO audits, building email sequences, launching products, setting up paid ads, designing pricing, running A/B tests, crafting brand positioning, or any marketing task. Replaces individual skills for copywriting, SEO, content marketing, email, social media, growth hacking, brand strategy, and CRO.
How do I install absolute-marketing?
Run npx skills add AbsolutelySkilled/AbsolutelySkilled --skill absolute-marketing in your terminal. The skill will be immediately available in your AI coding agent.
What AI agents support absolute-marketing?
absolute-marketing works with claude-code, gemini-cli, openai-codex, mcp. Install it once and use it across any supported AI coding agent.
Is absolute-marketing free?
Yes, absolute-marketing is completely free and open source under the MIT license. Install it with a single command and start using it immediately.
What is the difference between absolute-marketing and similar tools?
absolute-marketing is an AI agent skill that teaches your coding agent specialized marketing knowledge. Unlike standalone tools, it integrates directly into claude-code, gemini-cli, openai-codex and other AI agents.
Can I use absolute-marketing with Cursor or Windsurf?
absolute-marketing works with any AI coding agent that supports the skills protocol, including Claude Code, Cursor, Windsurf, GitHub Copilot, Gemini CLI, and 40+ more.