Stat Snapshot Pages: Complete Writing Guidelines
strategy/stat-snapshot-writing-guidelines.md · strategy · 2 versions
Stat Snapshot Pages: Complete Writing Guidelines
Note: For the overall workflow and quick reference, see CLAUDE.md (workspace instructions) first. This document provides detailed writing guidelines for stat snapshot pages.
---
⛔ MANDATORY: QC Checklist
BEFORE publishing ANY stat snapshot post, you MUST complete the QC Checklist section at the end of this document.
No exceptions. No shortcuts. Every post must pass ALL verification checks before publishing.
Key requirements that MUST be verified:
- ✅ Word count ≥ 3,000 words (run
wc -won draft) - ✅ All 11 sections present with minimum word counts
- ✅ 4+ images (1 hero + 3 body) uploaded and embedded
- ✅ 8+ internal links included
- ✅ 5+ source citations with working links
- ✅ AI content scrubbed (zero emdashes, zero flagged words)
- ✅ Statistics entries created and published
If any check fails, FIX IT before publishing. Do not publish non-compliant content.
---
Overview
Stat snapshot pages are data-driven "quick reference" pages that answer specific questions people search for. They're designed for featured snippets, authority building, and driving organic traffic.
Key differentiators from our current pages:
- Comprehensive long-form content (3,000-4,000 words HARD MINIMUM)
- Better HTML-to-content ratio for SEO
- 3 highlighted stats at the top (statistic boxes)
- 8-12 contextual internal links
- In-depth analysis, context, and expert insight
- Deep research with multiple authoritative sources
- All data sources linked for verification
- Draft review and revision step before publishing
- AI content scrubbing (no emdashes, no AI telltale phrases)
- Prose-first writing (not bullet-point dumps) — see the Balanced Prose & Lists section in
strategy/content-playbooks.md
---
⚠️ Balanced Prose & Lists
Use the format that best serves the reader for each type of information.
Stat snapshot pages should read like expert analysis that's also easy to scan. Readers want to understand the data AND be able to quickly find key numbers. This requires a balance: prose to explain and connect ideas, lists to make data scannable and comparable.
The Core Principle
Let the content dictate the format. Read what you've written and ask: "Would this be clearer as a list or as prose?"
- 3+ parallel items → Usually a list (platform comparisons, demographic breakdowns, feature lists)
- Sequential steps → Ordered list
- Complex explanations → Prose with context
- Quick reference data → Bullet list
When to Use Lists
| Content Type | Use List? | Why |
|---|---|---|
| Platform-by-platform comparisons | ✅ Yes | Readers scan for their platform |
| Demographic breakdowns (age, region) | ✅ Yes | Data is easier to compare |
| Action steps or "how to" | ✅ Yes | Sequential items need visibility |
| Benefits or features (3+) | ✅ Yes | Parallel items scan better |
| Complex analysis or context | ❌ No | Needs narrative flow |
| Expert quotes or commentary | ❌ No | Prose maintains voice |
| Single or two items | ❌ No | Not worth a list |
Minimum Requirement
Every post needs at least 3 lists to break up dense prose and improve readability. Target 4-6 lists per post.
⛔ Mandatory List Placement Guide
To ensure every post meets the 3-list minimum, use this section-by-section checklist. Not every section needs a list, but these are the HIGH-OPPORTUNITY sections where lists almost always improve readability:
| Section | List Likely? | What to List |
|---|---|---|
| Opening paragraph | ❌ Rarely | Keep as prose |
| What the data shows | ⚠️ Sometimes | Platform comparisons (4+ platforms) |
| Breaking down the numbers | ✅ Usually | Demographics, segments, or platform breakdowns |
| Why it matters | ⚠️ Sometimes | Industry applications (if 3+ examples) |
| How to take advantage | ✅ Usually | Action steps or strategy checklist |
| The bigger picture | ⚠️ Sometimes | Future predictions (if 3+ items) |
| What experts are saying | ❌ Rarely | Keep as prose with quotes |
| Common questions answered | ❌ Rarely | Keep FAQ answers as prose |
| Supporting data | ✅ Always | Quick-reference stats with sources |
| CTA | ❌ Never | Keep as prose |
The 3 most common list locations:
- "Breaking down the numbers" — demographic or segment breakdowns
- "How to take advantage" — actionable steps or strategy tips
- "Supporting data" — always a bullet list of sourced stats
If you're missing lists, check these sections first. Dense prose in "Breaking down the numbers" or "How to take advantage" is usually the problem.
Examples
❌ Bad (data buried in prose):
## Breaking down the numbers
Adults 65 and older watch 6.5 hours daily, while adults 50-64 watch 5.4 hours, adults 35-49 watch about 4 hours, adults 18-34 watch 3.5 hours, and teens watch 2.5 hours daily. The pattern shows older Americans watch more TV.
✅ Good (scannable data with context):
## Breaking down the numbers
The 3.7-hour average conceals enormous variation across age groups:
- **Adults 65+:** 6.5 hours daily (nearly double the average)
- **Adults 50-64:** 5.4 hours daily
- **Adults 35-49:** 4.0 hours daily
- **Adults 18-34:** 3.5 hours daily
- **Teens 12-17:** 2.5 hours daily
The pattern is clear: older Americans watch significantly more television. For advertisers, this means TV campaigns naturally reach older demographics more efficiently.
❌ Bad (how-to with no structure):
Start with geographic targeting around your service area, typically 15-25 miles. Time campaigns for evening hours when households gather. Budget $200-500 for two weeks to achieve frequency. Use AI creative tools. Measure brand metrics not clicks.
✅ Good (actionable list with context):
Understanding viewing patterns is useful. Here's how to act on it:
- **Geographic targeting:** 15-25 mile radius around your location
- **Timing:** Evening hours (6-10 PM) when households are together
- **Budget:** $200-500 for two weeks achieves real frequency
- **Creative:** AI platforms generate broadcast-quality ads from your website
- **Measurement:** Track brand search volume and traffic, not just clicks
Start with enough budget to reach your audience multiple times. Frequency builds recognition.
---
Reference: Existing Pages
Study these two live pages as a baseline:
We'll keep their structure but expand significantly.
---
Title & Date Marking
Initial Publish Format
[Question]? (Q[X] 2025)
Examples:
- "What is YouTube's share of TV viewing? (Q2 2025)"
- "How much does a local TV ad cost? (Q3 2025)"
Quarterly Refresh Format
[Question]? (Q[X] 2025 Update)
Examples:
- "What is YouTube's share of TV viewing? (Q3 2025 Update)"
SEO Metadata
| Field | Requirement |
|---|---|
| Title | 50-65 characters (including quarter marker) |
| Meta description | 150-155 characters, include key stat |
| URL slug | No dates, 3-5 words, lowercase hyphenated |
---
Contentful Structure
Content Type: resource
Stat snapshot pages use the resource content type with:
| Field | Value |
|---|---|
title | Full title with quarter marker |
slug | Evergreen URL (no dates) |
shortDescription | Brief summary for listings |
headerImage | Hero image (data visualization) |
resourceDate | Publish date |
resourceType | "Insights" |
bodyContent | RichText with embedded components |
seoDescription | Meta description |
---
The Statistics Boxes (Key Feature)
Every stat snapshot page starts with 3 highlighted statistics in visual boxes at the top. This is implemented using two content types:
Content Type: statistic
Individual stat box with two fields:
| Field | Description | Example |
|---|---|---|
number | The headline number (Symbol) | "47.3%", "$25", "10.6%" |
statisticText | Description below the number (Symbol) | "Share of U.S. TV viewing time" |
Content Type: statisticGroup
Groups 3 statistics together:
| Field | Description |
|---|---|
title | Internal name for the group (e.g., "YouTube Stats Q2 2025") |
statistics | Array of 3 links to statistic entries |
How to Create Statistics in Contentful
Step 1: Create 3 individual statistic entries
Statistic 1:
number: "10.6%"
statisticText: "YouTube's share of total U.S. TV viewing"
Statistic 2:
number: "#1"
statisticText: "Largest streaming platform by viewing share"
Statistic 3:
number: "+1.2pts"
statisticText: "Year-over-year growth"
Step 2: Create 1 statisticGroup entry
statisticGroup:
title: "YouTube TV Viewing Stats Q2 2025"
statistics: [link to stat 1, link to stat 2, link to stat 3]
Step 3: Embed the statisticGroup at the TOP of bodyContent
In the RichText editor, insert the statisticGroup as an embedded entry block as the FIRST element, before any text content.
Statistics Box Best Practices
| Do | Don't |
|---|---|
| Use exactly 3 stats | Use 2 or 4+ stats |
Keep statisticText under 50 chars | Write long descriptions |
| Lead with the most impactful number | Bury the key insight |
| Include YoY change when available | Only show current numbers |
| Use consistent formatting (%, $, #) | Mix formats randomly |
Good statistic combinations:
- Primary metric (the headline number)
- Ranking or comparison (how it compares)
- Trend indicator (YoY change, growth rate)
---
Article Structure Template
Word Count Target: 3,000-4,000 words
HARD MINIMUM: 3,000 words. Target: 3,000-4,000 words. Comprehensive long-form content is essential for SEO competitiveness and establishing authority. If your draft is under 3,000 words, it's too thin and needs more depth, research, and analysis.
Why we need more words:
- Higher content-to-HTML ratio improves SEO
- More content = more opportunities for internal links
- Comprehensive articles rank better and build authority
- Readers searching for data want depth, not summaries
Required Elements
Every stat snapshot page must include:
- Hero image (data visualization in headerImage field)
- 3-4 body images (embedded via placeholders in bodyContent)
- Statistics boxes (3 stats in embedded statisticGroup)
- 3,000-4,000 words of body content across 11+ sections
- 8-12 internal links (more than the previous 6-10 minimum)
- 5+ external source citations with working links
- 3+ bullet lists in distinct sections (see "Balanced Prose & Lists" above)
---
⚠️ CRITICAL: Word Count Verification (MANDATORY)
DO NOT SKIP THIS STEP. DO NOT PUBLISH WITHOUT VERIFICATION.
Pre-Draft Checkpoint
Before writing ANY stat snapshot content:
- ✅ Verify slug is available:
npm run check-slug -- "slug-here"(MANDATORY) - ✅ Confirm you will write ALL 11 sections
- ✅ Plan for 3,000-4,000 words total
- ✅ Identify 5+ authoritative sources for research
- ✅ Prepare 8-12 internal link targets from sitemap
- ✅ Plan 3+ lists: Identify data for "Breaking down the numbers" list and action steps for "How to take advantage" list
During-Draft Word Count Targets
Track word count as you write. Each section has a MINIMUM:
| Section | Min Words | Cumulative Min |
|---|---|---|
| Opening paragraph | 150 | 150 |
| What the data shows | 500 | 650 |
| Breaking down the numbers | 400 | 1,050 |
| Why it matters for your business | 400 | 1,450 |
| How to take advantage | 400 | 1,850 |
| The bigger picture | 350 | 2,200 |
| What experts are saying | 250 | 2,450 |
| Common questions answered | 400 | 2,850 |
| Supporting data | 200 | 3,050 |
| CTA section | 100 | 3,150 |
If your cumulative count is below the target at any point, STOP and add more content.
Post-Draft Verification (REQUIRED BEFORE CONTENTFUL)
Run this command to count words in your draft:
wc -w drafts/stat-snapshots/YYYY-MM-DD-slug.md
⚠️ CRITICAL: wc -w counts markdown formatting and URLs as words. The published content will have approximately 100-200 fewer "readable" words than the markdown file.
Results interpretation (MINIMUM 3,200 in markdown to ensure 3,000+ published):
- ❌ Under 3,200 words: DO NOT PROCEED. Add more content.
- ⚠️ 3,200-3,300 words: Borderline, consider expanding to be safe
- ✅ 3,300-4,000 words: Good length (ensures 3,100+ published)
- ✅ 4,000+ words: Excellent depth
To verify actual published word count after updating Contentful: Use the word count verification script to count text nodes in the entry.
Verify list placement (REQUIRED):
awk '/^## /{section=$0} /^- /{print section}' drafts/stat-snapshots/YYYY-MM-DD-slug.md | sort | uniq -c
Results interpretation:
- ❌ Lists only in "Supporting data": Add lists to "Breaking down the numbers" AND "How to take advantage"
- ⚠️ Lists in 2 sections: Add at least one more list section
- ✅ Lists in 3+ sections: Meets minimum requirement
What to Do If Under 3,000 Words
If your draft is too short, expand these sections (in order of priority):
- "What the data shows" - Add more data points, comparisons, year-over-year analysis
- "Breaking down the numbers" - Add demographic breakdowns, geographic analysis, device comparisons
- "Common questions answered" - Add more FAQ items (aim for 6-8, not just 5)
- "Why it matters" - Add industry-specific examples, case references
- "The bigger picture" - Add historical context, future projections, market trends
Final Pre-Publish Checklist
DO NOT PUBLISH until ALL boxes are checked:
- [ ] Word count verified at 3,000+ words
- [ ] All 11 sections present and substantive
- [ ] 3+ lists in distinct sections (Breaking down, How to take advantage, Supporting data)
- [ ] 8-12 internal links included
- [ ] 5+ external source citations with working links
- [ ] Hero image uploaded and linked
- [ ] 3-4 body images embedded
- [ ] Statistics boxes created (3 stats)
- [ ] AI content scrubbed (no emdashes, no AI phrases)
- [ ] Draft reviewed and revised at least once
Section Flow (with Image Placements)
0. Hero Image (uploaded to headerImage field) — REQUIRED
1. Statistics Boxes (embedded statisticGroup)
2. Opening paragraph (direct answer + hook) — 150-200 words
3. ## What the data shows — 500-700 words
📷 IMAGE 1: Data visualization (platform comparison, trend chart, etc.)
4. ## Breaking down the numbers — 400-600 words
📷 IMAGE 2: Demographic or segment breakdown
5. ## Why it matters for your business — 400-500 words
📷 IMAGE 3: Business opportunity or industry application
6. ## How to take advantage of this trend — 400-500 words
7. ## The bigger picture — 350-450 words
📷 IMAGE 4 (optional): Historical trend or future projection
8. ## What experts are saying — 250-350 words
9. ## Common questions answered — 400-500 words (FAQ format, 5-6 questions)
10. ## Supporting data — 200-300 words
11. ## Get started with TV advertising (CTA) — 100-150 words
Minimum: 4 images total (1 hero + 3 body)
Minimum Section Count
Every stat snapshot page must include all 11 sections with the word counts above to achieve the 3,000 word minimum. If any section feels thin, add more research and context.
Section Depth Check
Before publishing, verify each section:
- "What the data shows" has 5-8 specific data points with sources
- "Breaking down the numbers" has 3+ subsections (by age, geography, platform, etc.)
- "Common questions answered" has 5-6 FAQ items, not just 3-4
- "Supporting data" has 7-10 linked bullet points, not just 4-5
---
Section-by-Section Writing Guide
1. Statistics Boxes
Position: First element in bodyContent (embedded entry block)
Always include 3 stats:
- Primary headline stat
- Comparative/ranking stat
- Trend/change stat
2. Opening Paragraph (100-150 words)
Purpose: Immediately answer the question, then hook for more.
Formula:
[Direct answer with specific stat and linked source]. [2-3 sentences of context/significance]. [Hook to keep reading].
Example:
YouTube accounts for 10.6% of total U.S. TV viewing time, making it the single largest streaming platform by viewing share, according to Nielsen's Gauge data (April 2025). That means YouTube now commands more TV attention than Netflix, Hulu, or any other streaming service. This dominance has reshaped the advertising landscape, creating unprecedented opportunities for businesses of all sizes to reach audiences on the biggest screen in the house. Here's what that means for small businesses and how to take advantage of this shift.
Include:
- The exact stat with percentage/number
- Linked source attribution
- Date reference (Month Year)
- Significance statement (2-3 sentences)
- Hook for continued reading
3. What the Data Shows (400-600 words)
Purpose: Comprehensive breakdown of the headline stat with context, comparisons, and analysis.
Format: Primarily prose with strategic data callouts. This section should READ like analysis, not scan like a spec sheet.
Writing approach:
- Open with a thesis paragraph that frames what the data reveals
- Weave specific numbers INTO sentences rather than bullet-pointing them
- Use comparison and context to make numbers meaningful
- Save bullet lists ONLY for 4+ truly parallel data points that would be awkward as prose
- Close with analysis explaining what's driving the trends
Example structure:
## What the data shows
YouTube's dominance in TV viewing reflects a fundamental shift in how Americans consume content on the big screen. The platform now captures 10.6% of all U.S. TV viewing time, making it the single largest streaming destination, ahead of Netflix (8.4%) and even traditional cable networks.
What makes this number particularly striking is the trajectory. YouTube's TV viewing share has grown 1.2 percentage points year-over-year, while most traditional networks continue their steady decline. The platform isn't just maintaining its position; it's actively taking share from both legacy TV and competing streamers.
The viewing patterns tell their own story. YouTube viewership peaks during prime time hours (7-10 PM), directly competing with scripted television for household attention. This isn't background viewing or quick clips; it's deliberate, lean-back entertainment consumption on the biggest screen in the house.
This growth is driven primarily by YouTube's expansion beyond mobile. Smart TV apps and streaming devices have transformed what was once a "second screen" platform into a primary TV destination. For advertisers, that shift matters enormously: TV viewing commands different attention than phone scrolling, and YouTube is increasingly capturing that premium attention.
When to use a data list: Only when presenting 4+ parallel statistics that would genuinely be clearer as a list (e.g., platform-by-platform breakdown, year-by-year comparison table).
Internal link opportunity: Link to relevant guide or explainer article.
4. Breaking Down the Numbers (300-500 words)
Purpose: Deep dive into specific data segments, demographics, or comparisons.
NEW SECTION — This expands the analysis beyond the headline stat.
Writing approach: Use prose to EXPLAIN patterns, not just list them. A demographic breakdown should tell a story about who's watching and why, not just present numbers in bullet form. Reserve tables and lists for genuinely complex comparisons where prose would be confusing.
What to include:
- Demographic analysis with context (not just bullets of age ranges)
- Geographic or time-based patterns explained in prose
- Platform comparisons (tables acceptable here for 4+ platforms)
- Business implications woven throughout
Example:
## Breaking down the numbers
Understanding the full picture requires looking beyond the headline 10.6% figure. YouTube's dominance varies significantly across different demographics, time slots, and content types, and those variations matter for how you target your advertising.
### By age group
The generational divide in YouTube TV viewing is stark. Among viewers 18-34, YouTube captures roughly 15% of all TV viewing time, making it the dominant streaming destination for this cohort. That share drops to around 11% for viewers 35-49, and falls further to about 7% for those 50-64. Among seniors 65 and older, YouTube represents only about 4% of TV time.
This pattern isn't surprising when you consider viewing habits. Younger audiences grew up with YouTube and naturally gravitate toward it on every screen. But the business implication is clear: if your target customers skew under 50, YouTube is increasingly where they spend their evening entertainment hours.
### By time of day
YouTube's viewing patterns diverge from traditional TV in revealing ways. During daytime hours (6am-4pm), YouTube viewing indexes higher than its overall share would suggest, driven partly by work-from-home flexibility and the platform's utility for background content.
The real story, though, is prime time. From 8-11pm, YouTube competes directly with scripted television for household attention, particularly among cord-cutting households. And after 11pm, YouTube dominates as the default destination for on-demand entertainment when traditional programming winds down.
### Compared to other platforms
For context, here's how the top streaming services compare in total TV viewing share:
| Platform | Share of TV Viewing | YoY Change |
|----------|--------------------| -----------|
| YouTube | 10.6% | +0.8% |
| Netflix | 7.9% | +0.2% |
| Amazon Prime | 3.1% | -0.1% |
| Hulu | 2.6% | Flat |
| Disney+ | 1.9% | +0.3% |
What makes YouTube's lead particularly significant for advertisers is the ad model. YouTube is ad-supported by default, while a large portion of Netflix and Disney+ viewers pay for ad-free tiers. YouTube's 10.6% share represents almost entirely addressable advertising inventory.
Internal link opportunity: Link to platform-specific advertising guides.
5. Why It Matters for Your Business (300-400 words)
Purpose: Connect the data to SMB opportunity. This is the Adwave angle.
Writing approach: This section should feel like advice from a trusted consultant, not a sales pitch. Use prose to explain implications and build understanding. Only use lists for genuinely parallel examples (like industry applications) where the reader benefits from quick scanning.
What to include:
- Clear explanation of what this data means for SMBs
- 2-3 industry-specific applications (can be brief bullet or prose)
- Context on how this compares to traditional options
- Natural Adwave mention showing accessibility
Example:
## Why it matters for your business
If your customers are watching YouTube on their TV, your ads can reach them there too. And you don't need a Super Bowl budget to make it happen.
YouTube's TV viewing surge means small businesses now have access to audiences on the biggest screen in the house. Unlike mobile YouTube ads, which are skippable and often watched with divided attention, TV-delivered YouTube ads command something different: full-screen, lean-back attention. Viewers are engaged, often watching with household members, and in a receptive mindset for brand messages.
The applications vary by business type. Local service businesses like plumbers, dentists, and attorneys can target homeowners within a specific radius during evening hours, when people are thinking about home projects and services they need. Restaurants and retailers can reach hungry viewers during dinner decision-making hours or promote weekend specials to households in their delivery zone. E-commerce brands can use TV to build brand awareness with relaxed, receptive audiences, then retarget those viewers with performance ads elsewhere.
What makes this moment different from even five years ago is accessibility. Traditional TV advertising required $50,000 or more for production costs alone, plus five-figure media buys for any meaningful reach. That world is effectively over.
With platforms like Adwave, you can run [TV advertising](https://adwave.com/resources/tv-advertising-for-small-business) campaigns across YouTube and 100+ other premium channels starting at just $50. No production budget required because AI generates your commercial from your website. No agency needed. Your ad can be live in minutes, reaching the same audiences that major brands target.
For local businesses especially, this creates a genuine opportunity to build brand awareness in your community using the same screens where national brands advertise. The playing field hasn't just been leveled; it's been opened entirely.
Required internal links:
- Link to relevant Adwave guide
- Link to 2+ industry pages
6. How to Take Advantage of This Trend (300-400 words)
Purpose: Actionable guidance for readers who want to act on this information.
NEW SECTION — Provides practical next steps.
Writing approach: This section is about helping readers take action, not dumping a checklist on them. Use prose to explain the why behind recommendations, with numbered steps ONLY for truly sequential processes where order matters.
What to include:
- Strategic approach (not just tactics)
- Budget and timeline guidance in context
- Targeting recommendations with reasoning
- Clear path forward
Example:
## How to take advantage of this trend
Understanding that YouTube dominates TV viewing is useful. Knowing how to act on that information is what actually grows your business.
The smartest approach for most small businesses is to start with a test campaign. Don't overthink it or try to optimize everything from day one. Set aside $100-$200, run for two weeks, and treat it as a learning exercise. You're gathering data about what resonates with your audience, not trying to hit a home run immediately. For local businesses, start with geographic targeting around your service area, typically a 15-25 mile radius. Use AI-generated video to keep production costs at zero.
Once your test is running, focus your targeting on the patterns the data reveals. YouTube's TV viewers aren't randomly distributed. Evening hours from 7-10 PM capture the most engaged viewers, when households are settled in for entertainment. Geographic precision matters more than broad reach for most local businesses. And certain content categories on YouTube will align better with your specific audience, something you'll learn from your initial campaign data.
Measuring success for TV advertising requires different thinking than performance marketing. You're not looking for immediate clicks and conversions. Instead, watch for brand search lift (are more people Googling your business name?), overall website traffic increases during and after your campaign, QR code scans if your ad includes one, and simple customer surveys asking new customers how they heard about you.
When you find something that works, scale deliberately. Increase budget on winning creative rather than spreading thin across variations. Expand your geographic targeting. Test additional streaming platforms beyond YouTube. Layer in retargeting to capture viewers who've shown interest.
The key is starting. Many small businesses never advertise on TV because they assume it's not for them. The viewing data says otherwise, and the barriers that used to justify that assumption simply don't exist anymore.
Internal link opportunity: Link to getting started guide, pricing, how it works.
7. The Bigger Picture (250-350 words)
Purpose: Place this stat in broader context (market trends, industry shifts, future implications).
What to include:
- How this stat fits into larger trends
- What's driving the change
- Future implications and predictions
- Competitive landscape context
Example:
## The bigger picture
YouTube's TV growth is part of a larger streaming revolution that's fundamentally reshaping the television industry. Streaming overall now accounts for over 40% of all TV viewing in the U.S., up from 28% just three years ago. Cable and broadcast continue their steady decline as viewers shift to on-demand content.
### The ad-supported shift
What makes this moment particularly significant for advertisers is where the growth is happening. While subscription services like Netflix and Disney+ have dominated streaming headlines, free and ad-supported platforms are driving much of the actual growth. YouTube, along with FAST (Free Ad-Supported Streaming TV) services like Tubi and Pluto TV, are creating more advertising inventory at accessible price points.
### What's next
Industry analysts project streaming will capture 50%+ of all TV viewing by late 2026. Within that:
- YouTube is expected to maintain or grow its lead
- Ad-supported tiers on premium services will continue expanding
- Local advertising options will become more sophisticated
### The democratization continues
For small businesses, this trend is unambiguously positive. Every percentage point that shifts from linear TV to streaming represents inventory that's more targetable, more measurable, and more accessible to smaller budgets. The days when [TV advertising](https://adwave.com/resources/how-to-advertise-on-tv) required six-figure budgets are definitively over.
Internal link opportunity: Link to streaming stats, CTV overview, or predictions article.
8. What Experts Are Saying (200-300 words)
Purpose: Add authority through industry perspectives and analysis.
NEW SECTION — Incorporates third-party credibility.
What to include:
- Quotes or paraphrased insights from industry analysts
- Research firm perspectives
- Platform or network commentary
- Academic or trade publication insights
Example:
## What experts are saying
Industry analysts have noted YouTube's TV growth as one of the most significant shifts in media consumption.
Nielsen's latest Gauge report highlighted that "YouTube's expansion from mobile-first platform to living room staple represents a fundamental change in how Americans think about television." The research firm noted that YouTube's growth has come primarily at the expense of cable networks, not other streaming services.
Advertising industry observers point to the opportunity this creates:
> "The rise of ad-supported streaming, led by YouTube, is the biggest shift in TV advertising since cable fragmented the broadcast monopoly," notes a recent IAB analysis. "Except this time, the beneficiaries aren't just big brands—they're any business with a message and a modest budget."
Trade publications have emphasized the accessibility angle. Marketing Week reported that "the combination of programmatic buying, AI-generated creative, and low minimum spends has effectively removed every traditional barrier to TV advertising for small businesses."
What's notable is the consensus: this isn't a temporary blip. The structural shift toward streaming, and specifically ad-supported streaming, represents a permanent change in the television landscape.
Note: Use verifiable quotes when possible; paraphrase and attribute when direct quotes aren't available.
9. Common Questions Answered (300-400 words)
Purpose: Address related searches and frequently asked questions in FAQ format.
NEW SECTION — Captures long-tail search traffic and improves featured snippet potential.
Writing approach: Each FAQ answer should be a complete, helpful response in prose form. Avoid turning every answer into a bullet list. Use 2-4 sentences of explanation, and only use lists when the question genuinely calls for enumerating multiple parallel items.
Format: Use H3 headers for each question, followed by direct prose answers.
Example:
## Common questions answered
### How is TV viewing share measured?
Nielsen's Gauge methodology measures TV viewing across all sources, including broadcast, cable, streaming, and other delivery methods. The data comes from a panel of representative U.S. households combined with set-top box data and smart TV automatic content recognition (ACR) technology. Nielsen tracks what's being watched on the TV screen regardless of how the content is delivered, and releases the data monthly with approximately a one-month lag.
### Does YouTube TV viewing include YouTube TV (the live TV service)?
No, Nielsen's Gauge reports separate YouTube (the main streaming platform and app) from YouTube TV (the live TV subscription service). The 10.6% viewing share figure refers specifically to the main YouTube platform. YouTube TV, which competes with services like Hulu Live and Sling TV, is counted separately in the virtual MVPD category.
### What counts as "TV viewing" in these stats?
TV viewing in Nielsen's methodology refers to content watched on a television screen, regardless of delivery method. This includes traditional broadcast and cable, streaming apps running on smart TVs, content cast or mirrored from mobile devices to the TV screen, and viewing through gaming consoles and streaming devices like Roku, Fire TV, and Apple TV. Mobile phone and computer viewing are tracked separately and aren't included in these TV-specific statistics.
### Is YouTube's dominance expected to continue?
All major industry forecasts project continued growth for YouTube's TV viewing share through at least 2027. Several factors support this trajectory: smart TV penetration continues to grow, YouTube is investing heavily in living room experiences, both YouTube Premium and ad-supported viewing are expanding, and YouTube Shorts is increasingly being consumed on TV screens. No credible analysis suggests YouTube's TV share will decline in the near term.
### How does this compare globally?
YouTube's TV dominance is most pronounced in the United States. In other major markets like the UK, Germany, and Australia, YouTube holds significant but smaller shares, typically 6-8% of total TV viewing compared to the U.S. figure of over 10%. The U.S. leads primarily due to higher smart TV penetration rates and earlier, more widespread cord-cutting adoption.
Internal link opportunity: Link to glossary terms, explainer articles.
10. Supporting Data (150-250 words)
Purpose: Provide additional stats that add depth, all with linked sources.
Format: Bullet points with linked sources and dates.
⚠️ Note on lists: This is one of the FEW sections where a bullet list is appropriate. The Supporting Data section is designed as a quick-reference resource, where readers scan for specific stats. The bullets here serve a genuine purpose (7+ parallel data points with identical structure). This is NOT a model for other sections.
Example:
## Supporting data
Additional context on YouTube and streaming TV viewing:
- **Total streaming share:** Streaming represents 40.3% of U.S. TV time ([Nielsen Gauge](https://www.nielsen.com/data-center/the-gauge/), April 2025)
- **YouTube growth:** YouTube TV viewing up 120%+ since 2021 ([Nielsen](https://www.nielsen.com/news-center/))
- **Smart TV penetration:** 85% of U.S. households have at least one smart TV ([Parks Associates](https://www.parksassociates.com/), 2025)
- **Ad-supported dominance:** 73% of all TV viewing is ad-supported ([Nielsen](https://www.nielsen.com/news-center/2025/nielsen-launches-the-ad-supported-gauge/), Q1 2025)
- **CTV ad spend:** U.S. CTV advertising projected to reach $30+ billion in 2025 ([eMarketer](https://www.emarketer.com/))
- **Cord-cutting pace:** 6 million U.S. households cut the cord in 2024 ([Leichtman Research](https://www.leichtmanresearch.com/), 2025)
- **Average streaming time:** U.S. adults stream an average of 3+ hours per day ([Nielsen](https://www.nielsen.com/))
All sources linked above. Data current as of [Month] 2025.
11. CTA Section (80-120 words)
Purpose: Natural transition to Adwave.
Format:
## Get started with TV advertising
Ready to reach [audience descriptor] on the biggest screen in the house? Adwave makes [TV advertising](https://adwave.com/resources/how-to-advertise-on-tv) accessible for small businesses, with campaigns starting at just $50.
[See how it works](https://adwave.com/how-it-works) | [View pricing](https://adwave.com/pricing)
Audience descriptors by topic:
- Platform share: "YouTube viewers", "streaming audiences"
- Cord cutting: "cord cutters", "streaming-first households"
- Industry size: "CTV audiences", "streaming viewers"
- Demographics: "millennial viewers", "Gen Z audiences"
---
Internal Linking Requirements
Minimum: 8-12 Internal Links Per Article
With longer content (3,000-4,000 words), every stat snapshot must include at least 8 contextual internal links from the Adwave sitemap. Aim for 10-12 when natural opportunities exist. More content = more linking opportunities.
Link Placement Strategy
| Section | Link Target | Purpose |
|---|---|---|
| Opening/What data shows | Related guide article | Deepen understanding |
| Why it matters | Industry page or TV guide | Connect to vertical |
| Bigger picture | Another stat page or overview | Build topic cluster |
| CTA | /how-it-works, /pricing | Convert |
| Throughout | Relevant resources | Natural mentions |
High-Value Link Targets
Guides (link from relevant stats):
/resources/tv-advertising-for-small-business/resources/how-to-advertise-on-tv/resources/what-is-connected-tv-advertising/resources/ctv-advertising-statistics-2025/resources/roku-advertising-small-business/resources/hulu-advertising-small-business/resources/local-tv-advertising-costs
Industry Pages (link from relevant verticals):
/industries/food-beverage/industries/real-estate/industries/healthcare/industries/home-services
Product Pages (CTA section):
/how-it-works/pricing/features
Link Formatting
In RichText bodyContent:
- Use
hyperlinknode type for external URLs - Use
entry-hyperlinknode type for internal Contentful entries
Anchor text rules:
- Descriptive, not "click here"
- Natural integration into sentences
- Keyword-relevant when possible
---
File Structure for Drafts
/drafts/stat-snapshots/
├── 2025-04-18-youtube-tv-viewing-share.md
├── 2025-04-21-netflix-tv-viewing-share.md
└── images/
└── 2025-04-18-youtube-tv-viewing-share/
└── hero.png
---
Markdown Draft Template
## Article Brief
**Publish Date:** YYYY-MM-DD
**URL Slug:** `[slug]`
**Category:** Insights
**Funnel Stage:** TOFU
**Strategy:** Beyond
**Target Word Count:** 2,500-4,000 (hard minimum 2,500)
---
## SEO Metadata
**Title:** [Question]? (Q[X] 2025)
**Meta Description:** [Direct answer with key stat]. [Source]. Updated [Month] 2025.
**Primary Keyword:** [main search query]
**Secondary Keywords:** [3-5 related terms]
---
## Statistics Boxes
Create as separate Contentful entries, then embed as statisticGroup.
**Stat 1:**
- Number: [X%]
- Text: [Brief description]
**Stat 2:**
- Number: [#X or X%]
- Text: [Brief description]
**Stat 3:**
- Number: [+X% or X]
- Text: [Brief description]
---
## Article Content
# [Title as Question]? (Q[X] 2025)
[Opening paragraph: 150-200 words. Direct answer with linked stat and source. 3-4 sentences of context/significance. Hook to continue reading.]
---
## What the data shows
[500-700 words — PROSE-FIRST, weave data into flowing paragraphs]
[Opening paragraph: Thesis statement framing what the data reveals, with 1-2 key numbers woven in]
[Body paragraph 1: Expand on the primary data point with context and comparison. Include specific numbers IN sentences, not as bullets.]
[Body paragraph 2: Secondary data points with analysis. Explain what's driving the numbers, not just what they are.]
[Body paragraph 3: Historical context or year-over-year analysis. How has this changed? Why does the trajectory matter?]
[Closing paragraph: Synthesis — what does this all mean together?]
**NOTE:** Only use a data list if you have 5+ parallel statistics that would be genuinely awkward as prose. Even then, lead with prose context first.
<!-- IMAGE: data-visualization -->
**Placement:** After "What the data shows" section
**Type:** Chart
**Description:** [Data visualization showing the key stat - bar chart, pie chart, etc.]
**Filename:** data-visualization.png
<!-- /IMAGE -->
[Internal link to related guide]
---
## Breaking down the numbers
[400-600 words]
[Introduction to deeper analysis]
### By [segment 1] (e.g., age group, geography, time)
[Breakdown with specific data points]
### By [segment 2]
[Breakdown with specific data points]
### Compared to [relevant comparison]
[Comparison table or analysis]
<!-- IMAGE: breakdown-chart -->
**Placement:** After "Breaking down the numbers" section
**Type:** Chart
**Description:** [Breakdown visualization - demographic groups, segments, etc.]
**Filename:** breakdown-chart.png
<!-- /IMAGE -->
[Internal link to relevant guide]
---
## Why it matters for your business
[400-500 words — PROSE-FIRST, explain implications conversationally]
[Opening paragraph: Hook connecting this data to the reader's business opportunity]
[Body paragraph 1: Explain the core implication — what does this stat mean for someone trying to grow a business?]
[Body paragraph 2: Industry applications — you can briefly mention 2-3 industry types, but explain HOW they can use this, not just list them. Example: "Local service businesses like plumbers and dentists can target homeowners within their service radius during evening hours when people are thinking about home projects."]
[Body paragraph 3: The accessibility angle — explain how barriers have collapsed. Weave in Adwave naturally ($50 minimum, AI-generated ads, 100+ channels) as part of the larger story, not as a feature dump.]
[Closing paragraph: Tie it together — why this moment is different]
**NOTE:** Do NOT bullet-point industry examples. Weave them into prose.
<!-- IMAGE: business-opportunity -->
**Placement:** After "Why it matters" section
**Type:** Concept
**Description:** [Visual showing business opportunity or industry application]
**Filename:** business-opportunity.png
<!-- /IMAGE -->
[Internal links to industry pages]
---
## How to take advantage of this trend
[400-500 words — PROSE-FIRST, write as advice, not as checklists]
[Opening paragraph: Set up the strategic approach — understanding data is step one, acting on it is what grows your business]
[Body paragraph 1: Test campaign guidance — explain the approach (budget range, duration, targeting philosophy) in flowing prose. Don't bullet-point "Budget: $100-200, Duration: 2 weeks" etc.]
[Body paragraph 2: Targeting strategy — explain the thinking behind good targeting, not just a list of targeting options. Help readers understand WHY to target certain ways.]
[Body paragraph 3: Measurement approach — explain how TV advertising measurement differs from performance marketing. What should they watch for? How long before they see results?]
[Body paragraph 4: Scaling strategy — once they have data, how should they think about growing? Again, explain the reasoning.]
[Closing: The key is starting — encourage action]
[Internal links to getting started guide, pricing]
**NOTE:** Numbered steps are acceptable IF they're truly sequential, but each step should be a full explanation, not a one-liner.
---
## The bigger picture
[350-450 words]
[How this stat fits into larger industry trends]
### [Trend heading] (e.g., The ad-supported shift)
[Trend analysis]
### What's next
[Future implications and predictions]
<!-- IMAGE: trend-chart (OPTIONAL 4th image) -->
**Placement:** After "The bigger picture" section
**Type:** Chart
**Description:** [Historical trend line or future projection visualization]
**Filename:** trend-chart.png
<!-- /IMAGE -->
### The democratization continues
[How this benefits small businesses]
[Internal link to related overview or stat page]
---
## What experts are saying
[250-350 words]
[Industry analyst perspectives]
[Quotes or paraphrased insights from authoritative sources]
[Trade publication or research firm commentary]
[Implications drawn from expert analysis]
---
## Common questions answered
[400-500 words, 5-6 FAQ items — PROSE ANSWERS, not bullet lists]
### [Question 1]?
[2-4 sentences of prose answering the question completely. Do NOT bullet-point the answer. Write it as you would explain it to a colleague.]
### [Question 2]?
[2-4 sentences of prose. If the answer involves multiple items (e.g., "what counts as TV viewing"), write them as a sentence with commas, not as bullets.]
### [Question 3]?
[Direct prose answer]
### [Question 4]?
[Direct prose answer]
### [Question 5]?
[Direct prose answer]
**NOTE:** Each FAQ answer should be a complete, helpful response in prose form. The only exception is if a question genuinely asks for a list of 4+ items (rare).
---
## Supporting data
[200-300 words, 7-10 linked bullet points]
Additional context on [topic]:
- **[Stat label 1]:** [Number/fact] ([Source Name](source-url), [Date])
- **[Stat label 2]:** [Number/fact] ([Source Name](source-url), [Date])
- **[Stat label 3]:** [Number/fact] ([Source Name](source-url), [Date])
- **[Stat label 4]:** [Number/fact] ([Source Name](source-url), [Date])
- **[Stat label 5]:** [Number/fact] ([Source Name](source-url), [Date])
- **[Stat label 6]:** [Number/fact] ([Source Name](source-url), [Date])
- **[Stat label 7]:** [Number/fact] ([Source Name](source-url), [Date])
All sources linked above. Data current as of [Month] 2025.
---
## Get started with TV advertising
[100-150 words]
Ready to reach [audience descriptor]? Adwave makes [TV advertising](https://adwave.com/resources/how-to-advertise-on-tv) accessible for small businesses, with campaigns starting at just $50. No production budget required. No agency needed.
[See how it works](https://adwave.com/how-it-works) | [View pricing](https://adwave.com/pricing)
---
## Internal Links Used (Minimum 8-12)
1. [Anchor text](URL) - in [section]
2. [Anchor text](URL) - in [section]
3. [Anchor text](URL) - in [section]
4. [Anchor text](URL) - in [section]
5. [Anchor text](URL) - in [section]
6. [Anchor text](URL) - in [section]
7. [Anchor text](URL) - in [section]
8. [Anchor text](URL) - in [section]
9. [Anchor text](URL) - in [section]
10. [Anchor text](URL) - in [section]
11. [Anchor text](URL) - in [section] (if applicable)
12. [Anchor text](URL) - in [section] (if applicable)
---
## AI Scrubbing Checklist
Before publishing, verify:
- [ ] **Zero emdashes (—):** Use Cmd+F to search, replace ALL with commas/parentheses/periods
- [ ] **No AI telltale words:** Search for: delve, landscape, leverage, robust, seamless, utilize, myriad, realm, embark, paradigm, tapestry
- [ ] **No hedging phrases:** Remove "it's important to note," "it's worth mentioning," "it should be noted"
- [ ] **Sentence variety:** Not all sentences start with "This" or "It"
- [ ] **Natural flow:** Read aloud, sounds human-written
- [ ] **No generic conclusions:** No "In conclusion" or "To summarize"
---
## Images (Minimum 4 Total)
| Image | Filename | Type | Placement | Description |
|-------|----------|------|-----------|-------------|
| Hero | hero.png | Bar chart | headerImage field | [Main stat visualization] |
| Body 1 | data-visualization.png | Chart | After "What the data shows" | [Key data comparison] |
| Body 2 | breakdown-chart.png | Chart | After "Breaking down the numbers" | [Segment/demographic breakdown] |
| Body 3 | business-opportunity.png | Concept | After "Why it matters" | [Business application visual] |
| Body 4 (opt) | trend-chart.png | Line graph | After "The bigger picture" | [Historical trend or projection] |
**Image generation prompts:**
- Hero: [Describe the main visualization]
- Body 1: [Describe data comparison visual]
- Body 2: [Describe breakdown visual]
- Body 3: [Describe business opportunity visual]
---
## Sources
| Stat | Source | URL | Data Date |
|------|--------|-----|-----------|
| [Primary stat] | [Source] | [Full URL] | [Month Year] |
| [Stat 2] | [Source] | [Full URL] | [Month Year] |
| [Stat 3] | [Source] | [Full URL] | [Month Year] |
| [Stat 4] | [Source] | [Full URL] | [Month Year] |
| [Stat 5] | [Source] | [Full URL] | [Month Year] |
| [Stat 6] | [Source] | [Full URL] | [Month Year] |
| [Stat 7] | [Source] | [Full URL] | [Month Year] |
| [Stat 8] | [Source] | [Full URL] | [Month Year] |
**Primary source update schedule:** [e.g., Monthly for Nielsen Gauge]
---
Image Requirements (MANDATORY)
Every stat snapshot page MUST have:
- 1 hero image (uploaded to headerImage field)
- 3-4 body images (embedded in bodyContent via placeholders)
Total minimum: 4 images per post. Do not proceed to publishing without all images.
---
Hero Image
Style: Editorial Clean (Data Visualization)
Each stat snapshot needs ONE hero image showing the key stat visually.
Hero image types by topic:
| Topic | Recommended Visual |
|---|---|
| Platform share | Bar chart comparing platforms |
| Industry size | Line graph showing growth |
| Consumer behavior | Donut chart with breakdown |
| Device penetration | Icon-based comparison |
| Ad costs | Comparison bars |
| Demographics | Grouped bar chart by age |
| Predictions | Line graph with projection |
---
Body Images (3-4 Required)
Body images break up text, visualize data, and improve engagement. Place them strategically throughout the article.
Recommended placements:
- After "What the data shows" → Data visualization or comparison chart
- After "Breaking down the numbers" → Demographic breakdown or segment chart
- After "Why it matters for your business" → Industry application or opportunity visual
- After "The bigger picture" → Trend line or future projection (optional 4th image)
Body image types:
| Section | Image Type | Example |
|---|---|---|
| What the data shows | Bar/pie chart | Platform comparison |
| Breaking down the numbers | Grouped bars | Demographics breakdown |
| Why it matters | Concept illustration | Business opportunity |
| The bigger picture | Line graph | Historical trend |
---
Image Placeholder Format (REQUIRED)
⚠️ CRITICAL: Standard markdown images !alt DO NOT WORK in Contentful.
You MUST use the placeholder format below. The markdown-to-richtext script ignores standard markdown image syntax.
Required format for ALL body images:
<!-- IMAGE: unique-id -->
**Placement:** [Where in article]
**Type:** [Chart | Diagram | Concept]
**Description:** [Alt text for accessibility]
**Filename:** exact-filename.png
<!-- /IMAGE -->
Example:
<!-- IMAGE: platform-comparison -->
**Placement:** After "What the data shows" section
**Type:** Chart
**Description:** Bar chart comparing streaming platform TV viewing shares
**Filename:** platform-comparison.png
<!-- /IMAGE -->
The Filename: line MUST match exactly what's in asset-ids.json.
---
Image Specifications
- Dimensions: 1344x768px (16:9)
- Colors: Navy (#222239), Teal (#57b4ad), Lime (#d7df27), Cream background
- Style: Flat, no shadows, no gradients, large data callouts
- Text: Minimal, verified for accuracy
Image Generation Workflow
- Generate hero image using nano-banana MCP
- Generate 3-4 body images using nano-banana MCP
- Review ALL text in each image at 100% zoom
- Copy to article folder:
mkdir -p drafts/stat-snapshots/images/[slug]/
cp "/Users/naffis/generated_imgs/generated-XXX.png" "drafts/stat-snapshots/images/[slug]/hero.png"
cp "/Users/naffis/generated_imgs/generated-XXX.png" "drafts/stat-snapshots/images/[slug]/platform-comparison.png"
# etc.
- Upload all images:
npm run upload-images -- "drafts/stat-snapshots/images/[slug]/" "Article Title"
- Add placeholders to draft with exact filenames from asset-ids.json
---
Research Workflow
Research Depth Requirements
Every stat snapshot requires DEEP research, not surface-level data collection.
⚠️ CRITICAL: Only include data you can SOURCE. If you cannot find a verifiable source for a statistic, do NOT include it.
Before writing, you must:
- Search multiple sources for each key stat (minimum 3 searches)
- Read full articles, not just headlines or snippets
- Find supporting data beyond the headline stat — WITH SOURCES
- Understand the methodology behind key numbers
- Identify trends and context (YoY changes, historical data) — WITH SOURCES
- Look for expert commentary (analyst quotes, industry perspectives) — VERIFY QUOTES ARE REAL
- Record source URLs for every data point you plan to use
Research Checklist
- [ ] Primary source identified and verified (Nielsen, eMarketer, etc.) — MUST HAVE URL
- [ ] 3+ supporting sources found with corroborating or contextual data — ALL WITH URLs
- [ ] Historical data gathered (at least 2-3 years of trends) — ONLY IF SOURCED
- [ ] Demographic breakdowns found (by age, geography, platform) — ONLY IF SOURCED
- [ ] Industry commentary collected (analyst quotes, expert perspectives) — MUST BE VERIFIABLE
- [ ] Competitive/comparison data gathered — ONLY IF SOURCED
- [ ] Methodology understood (how is this data measured?)
- [ ] Limitations noted (what doesn't this data show?)
- [ ] ⚠️ SOURCE URL RECORDED for every single data point you plan to include
Step 1: Find Primary Source
| Category | Primary Source |
|---|---|
| TV viewing share | Nielsen Gauge |
| Industry size/spend | eMarketer, IAB |
| Cord cutting | Leichtman Research |
| Device penetration | Parks Associates |
| Platform subscribers | Company earnings |
| Ad costs | IAB, industry reports |
Step 2: Verify Recency
- Data must be from within last 6 months
- Note "as of [Month Year]" prominently
- Plan updates when new data releases
Step 3: Cross-Reference
- Verify key stats in 2+ sources when possible
- Use most authoritative as primary
- Note discrepancies if significant
Step 4: Expand Beyond the Headline
Don't stop at the primary stat. For every headline number, also find:
- Historical context: What was this number 1, 2, 3 years ago?
- Demographic breakdown: How does this vary by age, income, geography?
- Platform/segment breakdown: How does this break down by category?
- Expert analysis: What do industry analysts say about this trend?
- Business implications: What does this mean for advertisers?
- Future projections: What are forecasts for next 1-3 years?
Step 5: Fill Content Gaps
If any section of your draft feels thin, go back and research more. Common gaps:
- "Breaking down the numbers" lacks demographic or segment data
- "What experts are saying" has no actual quotes or analyst perspectives
- "The bigger picture" doesn't include future projections
- "Common questions answered" only has 3-4 FAQs instead of 5-6
---
⛔ CRITICAL: No Unsourced Data
NEVER include statistics, percentages, or specific data points without a verifiable source link.
The Golden Rule
If you cannot provide a source link, do not present it as a fact.
This is non-negotiable. Spreading unverified data:
- Damages Adwave's credibility
- Risks publishing false information
- Hurts SEO when readers/fact-checkers find errors
- Can lead to embarrassing corrections
What REQUIRES a Source (No Exceptions)
- Market sizes (e.g., "$33 billion")
- Percentages and shares (e.g., "38% of TV ad spend")
- Year-over-year changes (e.g., "up 16%")
- Platform-specific numbers (e.g., "Netflix has 94M users")
- Category or demographic breakdowns
- Historical data and projections
- Expert quotes
- Research findings
What Can Be Stated Without a Source
- Common knowledge (e.g., "TV advertising is expensive for small businesses")
- Adwave product facts (e.g., "$50 minimum, 100+ channels")
- General explanations and definitions
- Recommendations and strategic advice
If You Cannot Find a Source
- Do not invent numbers — No "approximately," "around," or "estimated" without basis
- Describe qualitatively instead of quantitatively (e.g., "varies significantly by category" instead of made-up percentages)
- Remove the claim entirely if you cannot source it
Pre-Publish Audit
Before publishing, manually check:
- [ ] Every percentage has a source link
- [ ] Every dollar amount has a source link
- [ ] Every claim about market trends has a source link
- [ ] Every breakdown (by category, geography, etc.) has a source link
- [ ] The Supporting Data section has a source for EVERY bullet
---
Source Citation Requirements
Every stat must be verifiable. Readers (and Google) trust content that shows its work. All data points must link to their original sources so anyone can verify the information.
Citation Format in Body Content
When citing stats in the body, use this format with a linked source:
YouTube captured 10.6% of all U.S. TV viewing time in April 2025, according to [Nielsen's Gauge](https://www.nielsen.com/data-center/the-gauge/).
Rendered as:
YouTube captured 10.6% of all U.S. TV viewing time in April 2025, according to Nielsen's Gauge.
Citation Format in Supporting Data Section
Each bullet in the "Supporting data" section must include:
- The specific stat with number
- The source name (linked to source URL)
- The date of the data
Format:
- **Total streaming share:** Streaming represents 40.3% of U.S. TV time ([Nielsen Gauge](https://www.nielsen.com/data-center/the-gauge/), April 2025)
Full example:
## Supporting data
Additional context on YouTube and streaming TV viewing:
- **Total streaming share:** Streaming represents 40.3% of U.S. TV time ([Nielsen Gauge](https://www.nielsen.com/data-center/the-gauge/), April 2025)
- **YouTube growth:** YouTube TV viewing up 120%+ since 2021 ([Nielsen](https://www.nielsen.com/news-center/2025/streaming-reaches-historic-tv-milestone/))
- **Smart TV penetration:** 85% of U.S. households have at least one smart TV ([Parks Associates](https://www.parksassociates.com/), 2025)
- **Ad-supported dominance:** 73% of all TV viewing is ad-supported ([Nielsen Ad-Supported Gauge](https://www.nielsen.com/news-center/2025/nielsen-launches-the-ad-supported-gauge/), Q1 2025)
- **CTV ad spend:** U.S. CTV advertising projected to reach $30+ billion in 2025 ([eMarketer](https://www.emarketer.com/), 2025)
Primary Source URLs by Category
Always link to the most authoritative, direct source:
| Category | Source | URL |
|---|---|---|
| TV viewing share | Nielsen Gauge | https://www.nielsen.com/data-center/the-gauge/ |
| Nielsen press releases | Nielsen News Center | https://www.nielsen.com/news-center/ |
| CTV/streaming spend | eMarketer | https://www.emarketer.com/ |
| Ad industry reports | IAB | https://www.iab.com/insights/ |
| Cord cutting stats | Leichtman Research | https://www.leichtmanresearch.com/ |
| Device penetration | Parks Associates | https://www.parksassociates.com/ |
| Platform earnings | Investor relations | Company-specific IR pages |
Citation Rules
- Link to the specific report/page when possible, not just the homepage
- ✅ https://www.nielsen.com/news-center/2025/streaming-reaches-historic-tv-milestone/ - ❌ https://www.nielsen.com/
- For paywalled sources (eMarketer), link to the press release or public summary if available
- For company earnings data, link to the investor relations page or SEC filing
- Always include the date of the data, not just the source name
- ✅ "(Nielsen Gauge, April 2025)" - ❌ "(Nielsen)"
- Opening paragraph must cite the primary source with a link
- "Supporting data" section must have every stat linked
Draft Metadata: Sources Section
Every draft must include a complete sources section at the bottom:
---
## Sources
| Stat | Source | URL | Data Date |
|------|--------|-----|-----------|
| YouTube 10.6% share | Nielsen Gauge | https://www.nielsen.com/data-center/the-gauge/ | April 2025 |
| Streaming 40.3% of TV | Nielsen Gauge | https://www.nielsen.com/data-center/the-gauge/ | April 2025 |
| 120% growth since 2021 | Nielsen News | https://www.nielsen.com/news-center/2025/streaming-reaches-historic-tv-milestone/ | June 2025 |
| 85% smart TV penetration | Parks Associates | https://www.parksassociates.com/ | 2025 |
| 73% ad-supported | Nielsen | https://www.nielsen.com/news-center/2025/nielsen-launches-the-ad-supported-gauge/ | Q1 2025 |
| $30B CTV ad spend | eMarketer | https://www.emarketer.com/ | 2025 |
This table ensures:
- Every stat is traceable
- URLs are preserved for Contentful entry creation
- Refreshes can verify/update each source
---
Quarterly Refresh Workflow
CRITICAL: Refreshes Create NEW Posts
DO NOT replace or update existing stat posts. Each quarterly refresh creates a brand new post. This preserves:
- Historical record of past data
- SEO value of existing URLs
- Ability to track data changes over time
Refresh Schedule
- Q3 Refresh (July): Create new posts for Q2 topics with Q3 data
- Q4 Refresh (October): Create new posts for Q2 + Q3 topics with Q4 data
- Q1 Refresh (January): Major annual refresh - new posts for all high-traffic topics
New Post Requirements
Each refresh post is a completely new article with:
- New title: Include DATA quarter in title (e.g., "What is YouTube's share of TV viewing? (Q4 2025)" for December 2025 data)
- New slug: Add DATA quarter suffix (e.g.,
youtube-tv-viewing-share-q4-2025) - New Contentful entry: Fresh entry ID, not an update to existing
- New statistics: Create new statistic entries in Contentful
- Updated content: All sections rewritten with latest data
- Historical context: Reference previous quarters for trend analysis
IMPORTANT: The quarter in the slug and title indicates when the DATA is from, not when the post is published. December 2025 data = Q4 2025. January 2026 data = Q1 2026.
What Makes a Refresh Post Different
| Element | Original Post | Refresh Post |
|---|---|---|
| Slug | youtube-tv-viewing-share | youtube-tv-viewing-share-q4-2025 |
| Title | What is YouTube's share of TV viewing? (Q2 2025) | What is YouTube's share of TV viewing? (Q4 2025) |
| Entry ID | Original ID (keep live) | New entry ID |
| Statistics | Original numbers | New statistic entries |
| Content | Original analysis | Updated with new data + YoY trends |
Contentful Publishing Process for Refreshes
- Check slug availability:
npm run check-slug -- "topic-slug-q4-2025" - Create new statistic entries (3 required) with updated numbers
- Create new statisticGroup entry linking the 3 statistics
- Write new article following all stat snapshot guidelines
- Create new Contentful entry with new slug and fresh resourceDate
- DO NOT unpublish or modify the original post
---
Draft Review & Revision Workflow
Every draft must go through a review and revision cycle before publishing.
Step 1: Initial Draft
Write the complete draft following all section guidelines:
- All 11 sections present
- 2,000-3,500 word count achieved
- Sources researched and cited
- Internal links identified
Step 2: Review Checklist
After completing the draft, review against these criteria:
Content Quality
- [ ] Word count: 3,000-4,000 words (check exact count, 3,000 minimum)
- [ ] All sections present: All 11 sections included with adequate depth
- [ ] Section balance: No section too thin (under 150 words) or bloated (over 700 words)
- [ ] Flow: Sections transition naturally, no abrupt topic jumps
- [ ] Voice: Conversational, not academic; confident, not salesy
- [ ] Depth: Each section goes beyond surface-level, with specific data and analysis
AI Scrubbing (CRITICAL)
- [ ] No emdashes (—): Search and replace ALL emdashes with commas, parentheses, or periods
- [ ] No AI telltale words: No "delve," "landscape," "leverage," "robust," "seamless," "utilize," "myriad," "realm," "embark," "paradigm," "tapestry"
- [ ] No hedging phrases: No "it's important to note," "it's worth mentioning," "it should be noted"
- [ ] Sentence variety: Not all sentences start with "This" or "It"
- [ ] Natural conclusion: No "In conclusion" or "To summarize"
- [ ] Read aloud test: Content sounds natural when spoken
Data Accuracy
- [ ] Primary stat verified: Headline stat double-checked against source
- [ ] All stats current: No data older than 6 months
- [ ] Sources authoritative: All sources are recognized industry authorities
- [ ] Numbers consistent: Same stat isn't cited with different numbers in different sections
- [ ] Math correct: Any calculations or percentages are accurate
Source Citations
- [ ] Every stat linked: Every data point has a linked source
- [ ] Links work: All source URLs verified as working
- [ ] Dates included: Every citation includes data date
- [ ] Primary source in opening: First paragraph includes linked source
SEO & Structure
- [ ] H2 headings: All main sections use H2
- [ ] H3 for subsections: Subsections use H3 (not H2)
- [ ] Internal links: 6-10 contextual internal links present
- [ ] Meta description: Under 155 chars, includes key stat
- [ ] Title: Includes quarter marker, under 65 chars
Adwave Integration
- [ ] Natural mentions: Adwave mentioned naturally, not forced
- [ ] Value proposition clear: $50 minimum, AI-generated ads, 100+ channels mentioned
- [ ] CTA present: Clear call-to-action with links to /how-it-works and /pricing
- [ ] Industry links: Relevant industry pages linked where appropriate
Images (REQUIRED)
- [ ] Hero image planned: Data visualization type identified for hero
- [ ] Body image placeholders: 3-4
<!-- IMAGE: -->placeholders in draft - [ ] Placement strategic: Images placed after key sections to break up text
- [ ] Descriptions clear: Each placeholder has clear description for generation
Step 3: Revision Pass
After review, make a revision pass addressing:
- Content gaps: Add depth to any thin sections (go back and research more if needed)
- Source issues: Fix or add citations as needed
- Link opportunities: Add internal links where natural (aim for 8-12)
- AI scrubbing: Remove ALL emdashes and AI telltale language
- Voice cleanup: Ensure conversational tone throughout
- Data verification: Re-verify any stats that weren't sourced correctly
- Word count check: If under 3,000, expand thin sections
Step 4: Final Review
Before publishing, confirm:
- [ ] All checklist items from Step 2 are now passing
- [ ] Word count is within 2,000-3,500 range
- [ ] Draft reads naturally when read aloud
- [ ] All links are correct (internal and external)
- [ ] Sources table at bottom is complete
Step 5: Proceed to Publishing
Only after passing all review criteria, proceed to Contentful publishing workflow.
---
Quality Checklist
Quick reference checklist (use after Draft Review & Revision is complete):
Content Structure
- [ ] Statistics boxes: 3 stats created and embedded at top
- [ ] Title: Includes quarter marker (Q2 2025)
- [ ] Opening: Directly answers question with linked source
- [ ] Word count: 3,000-4,000 words (hard minimum 3,000)
- [ ] All sections: 11 sections present with adequate depth
AI Scrubbing (CRITICAL)
- [ ] No emdashes: Zero (—) characters in the entire document
- [ ] No AI words: No delve, landscape, leverage, robust, seamless, utilize, myriad, realm, embark, paradigm, tapestry
- [ ] No hedging: No "it's important to note," "it's worth mentioning"
- [ ] Natural voice: Reads like a human expert wrote it
Images (REQUIRED - Minimum 4 Total)
- [ ] Hero image: Data visualization uploaded to headerImage field
- [ ] Body images: 3-4 images embedded in bodyContent via placeholders
- [ ] Image placeholders: All use
<!-- IMAGE: -->format with correct filenames - [ ] Text reviewed: All text in images verified at 100% zoom for accuracy
- [ ] Asset IDs: All images uploaded and asset-ids.json generated
⛔ Source Citations (CRITICAL — NO EXCEPTIONS)
- [ ] ⚠️ NO UNSOURCED DATA: Every statistic, percentage, and specific number has a source link
- [ ] Opening paragraph: Primary source linked (e.g., "according to Nielsen's Gauge")
- [ ] All stats linked: Every stat in body and "Supporting data" has source link
- [ ] Source URLs verified: All links are working and go to correct pages
- [ ] Data dates included: Every citation includes date (Month Year or Quarter Year)
- [ ] Sources table complete: Draft includes full sources table at bottom
- [ ] No invented data: If you couldn't find a source, the data is NOT included
Links
- [ ] Internal links: 8-12 contextual Adwave links included (minimum 8)
- [ ] CTA: Links to /how-it-works and /pricing
- [ ] External sources: All source links working (minimum 5 external sources)
SEO & Metadata
- [ ] Data recency: All data within 6 months
- [ ] Adwave mention: Natural mentions in "Why it matters" and "How to take advantage" sections
- [ ] Slug: No date (evergreen URL)
- [ ] Meta description: Under 155 chars, includes key stat
---
Contentful Publishing Workflow
Step 0: Generate ALL Images (REQUIRED)
Before creating any Contentful entries, generate all images:
0a. Generate Hero Image
- Follow "Editorial Clean" style (data visualization)
- Generate 1344x768px showing key stat
- Verify all text at 100% zoom
- Save to
/drafts/stat-snapshots/images/[slug]/hero.png
0b. Generate Body Images (3-4)
- Generate each image based on placeholders in draft
- Use same Editorial Clean style and brand colors
- Verify all text at 100% zoom
- Save with exact filenames matching placeholders:
- platform-comparison.png - demographics-breakdown.png - trend-chart.png - etc.
0c. Upload All Images
npm run upload-images -- "drafts/stat-snapshots/images/[slug]/" "Article Title"
This generates asset-ids.json with all asset IDs needed for embedding.
0d. Body Image Embedding Note
⚠️ IMPORTANT: Stat snapshot pages contain markdown tables, which prevent the automated markdown-to-richtext script from running. For these pages:
Option A: Manual Embedding in Contentful
- Create/update the resource entry with text-only bodyContent first
- After publishing, open the entry in Contentful web app
- Position cursor where image should appear
- Insert → Embedded Asset → Select the uploaded image
- Republish
Option B: Direct RichText Manipulation
- Get the existing entry's bodyContent
- Insert
embedded-asset-blocknodes at the correct positions:
{
"nodeType": "embedded-asset-block",
"data": {
"target": {
"sys": {
"id": "ASSET_ID_HERE",
"type": "Link",
"linkType": "Asset"
}
}
},
"content": []
}
- Update the entry with modified bodyContent
Option C: For Non-Table Pages Only If the markdown has no tables, use the standard workflow:
npm run markdown-to-richtext -- "drafts/file.md" "drafts/images/slug/asset-ids.json"
Do not proceed to Step 1 without all images uploaded.
Step 1: Create Statistics (3 entries)
- Go to Content → Add Entry → Statistic
- Fill in
numberandstatisticText - Save (don't publish yet)
- Repeat for all 3 stats
Step 2: Create Statistic Group (1 entry)
- Go to Content → Add Entry → Statistic group
- Fill in
title(internal reference name) - Add links to your 3 statistic entries
- Save (don't publish yet)
Step 3: Create Resource Entry
- Go to Content → Add Entry → Resource
- Fill in all fields:
- title: Full title with quarter - slug: Evergreen URL - shortDescription: Brief summary - headerImage: Upload hero image - resourceDate: Publish date - resourceType: "Insights" - bodyContent: See below - seoDescription: Meta description
Step 4: Build bodyContent
- Click into bodyContent RichText field
- FIRST: Insert → Embed Entry → Select your statisticGroup
- THEN: Add text content below the embedded statisticGroup
- Use H2 headings for each section
- Add internal links using Insert → Link → Link to Entry (for Contentful pages) or Insert → Link → URL (for external)
- Format lists with bullet points
Step 5: Publish All Entries
Publish in this order:
- All 3
statisticentries - The
statisticGroupentry - The
resourceentry
---
AI Content Scrubbing (MANDATORY)
Every draft must be scrubbed for AI telltale signs before publishing. This is non-negotiable.
Emdash Removal (CRITICAL)
NEVER use emdashes (—) in any content. They are a dead giveaway of AI-generated text.
Replace emdashes with:
- Commas
- Parentheses
- Colons
- Periods (split into separate sentences)
Examples:
❌ BAD (emdash):
Streaming platforms—like Hulu and Roku—have changed everything about TV advertising.
✅ GOOD (commas):
Streaming platforms, like Hulu and Roku, have changed everything about TV advertising.
✅ GOOD (parentheses):
Streaming platforms (like Hulu and Roku) have changed everything about TV advertising.
❌ BAD (emdash):
The shift is significant—and it's accelerating.
✅ GOOD (period):
The shift is significant. And it's accelerating.
Words and Phrases to Remove/Replace
| AI Telltale | Replace With |
|---|---|
| Delve | explore, dig into, look at |
| Landscape | market, space, industry, world |
| Leverage | use, take advantage of, apply |
| Robust | strong, solid, comprehensive |
| Seamless/seamlessly | smooth, easy, without friction |
| Tapestry | (don't use at all) |
| Utilize | use |
| Myriad | many, lots of, plenty of |
| Realm | area, space, field |
| Embark | start, begin, get going |
| Paradigm | model, approach, way |
| Comprehensive (overused) | (be specific about what's included) |
| Significant | (use specific numbers instead) |
| It's important to note that | (just state the thing) |
| It's worth mentioning that | (just mention it) |
| In conclusion | (just conclude naturally) |
| To summarize | (just summarize) |
| Game-changer | (describe the actual impact) |
| Navigate (non-literal) | handle, work through, figure out |
| Pivotal | important, key, crucial |
| Paramount | critical, essential, most important |
| Plethora | many, lots of |
| Nuanced | (be specific about what's complex) |
| Resonate | connect, appeal to |
| Synergy | (don't use) |
Sentence Patterns to Fix
Too many sentences starting with "This" or "It":
❌ This represents a major shift. This is driven by cord-cutting. It's creating new opportunities.
✅ The numbers represent a major shift, driven by cord-cutting and creating new opportunities for advertisers.
Overly parallel structure (every sentence same rhythm):
❌ YouTube leads with 10.6%. Netflix follows with 7.9%. Hulu trails with 2.6%.
✅ YouTube leads the pack at 10.6%, with Netflix a distant second at 7.9%. Hulu rounds out the top three at 2.6%.
Excessive hedging:
❌ It's worth noting that YouTube's share has grown. It's important to consider that this represents a shift.
✅ YouTube's share has grown significantly, representing a fundamental shift in how Americans watch TV.
Generic conclusions:
❌ In conclusion, these trends show that streaming is growing and businesses should consider advertising.
✅ The data is clear: streaming has become the default way Americans watch TV, and small businesses finally have a seat at the table.
Punctuation Red Flags
| Red Flag | Fix |
|---|---|
| Emdashes (—) | Replace with commas, parentheses, periods, or colons |
| Excessive semicolons | Break into separate sentences |
| Overuse of colons before lists | Vary sentence structure |
| Multiple exclamation points | Remove or reduce to one (sparingly) |
Content Authenticity Check
After scrubbing, ask yourself:
- [ ] Would a real marketing expert say this exactly this way?
- [ ] Are there specific, concrete details or just generic statements?
- [ ] Does it sound like it was written for THIS audience or any audience?
- [ ] Read it aloud: Does it sound natural or stilted?
- [ ] Is there any phrase that makes you cringe as "obviously AI"?
AI Scrubbing Workflow
- Write the draft (AI-assisted is fine)
- Search for emdashes (Cmd+F for "—") and replace ALL of them
- Search for AI telltale words (delve, landscape, leverage, etc.)
- Read aloud and fix anything that sounds unnatural
- Check sentence variety (vary length and structure)
- Remove hedging phrases ("it's important to note", "it's worth mentioning")
- Final read as if you're a skeptical reader
---
Voice & Tone Reminders
Even data-focused content should feel accessible:
- Conversational: "Here's the thing..." not "It should be noted..."
- Concrete: Specific numbers, not "significant growth"
- Optimistic: Frame as opportunity for SMBs
- Concise: Every word earns its place
- No emdashes: Use commas, parentheses, or periods instead
Good:
YouTube commands over 10% of all TV viewing. That's a massive audience you can now reach without a massive budget.
Bad:
It is important to note that YouTube has achieved a significant market share in the television viewing landscape.
Bad (emdash):
YouTube—the world's largest streaming platform—has achieved significant market share.
Good (no emdash):
YouTube, now the world's largest streaming platform, commands over 10% of all TV viewing.
---
Merged from strategy/stat-snapshot-qc-checklist.md during the Library consolidation (2026-07-05). The source document is archived; this is now the canonical home for its content.
Stat Snapshot QC Checklist
⛔ MANDATORY: No stat snapshot post may be published until ALL items below are verified and checked off.
This checklist must be completed for EVERY stat snapshot post BEFORE publishing to Contentful. Do not skip any items. If a post fails any check, fix it before proceeding.
---
Pre-Writing Verification
Complete these BEFORE drafting:
- [ ] Slug availability confirmed via
npm run check-slug -- "slug-here" - [ ] Primary source identified with working URL
- [ ] 3+ supporting sources gathered with URLs
- [ ] Sitemap fetched via firecrawl_map for internal links
---
Word Count Verification (HARD REQUIREMENT)
⛔ MINIMUM: 3,000 words. Target: 3,000-4,000 words.
Run this command and record the result:
wc -w drafts/stat-snapshots/YYYY-MM-DD-slug.md
Word count: _______ words
| Result | Action |
|---|---|
| ❌ Under 3,000 | STOP. Do not publish. Expand content. |
| ⚠️ 3,000-3,200 | Borderline. Consider expanding to be safe. |
| ✅ 3,200+ | Proceed to next checks. |
---
Required Sections (All 11 Must Be Present)
Verify each section exists AND meets minimum word count:
| # | Section | Min Words | Present? | Word Count |
|---|---|---|---|---|
| 1 | Opening paragraph | 150 | [ ] | _____ |
| 2 | What the data shows | 500 | [ ] | _____ |
| 3 | Breaking down the numbers | 400 | [ ] | _____ |
| 4 | Why it matters for your business | 400 | [ ] | _____ |
| 5 | How to take advantage | 400 | [ ] | _____ |
| 6 | The bigger picture | 350 | [ ] | _____ |
| 7 | What experts are saying | 250 | [ ] | _____ |
| 8 | Common questions answered | 400 | [ ] | _____ |
| 9 | Supporting data | 200 | [ ] | _____ |
| 10 | CTA section | 100 | [ ] | _____ |
| 11 | Statistics boxes (3 stats) | N/A | [ ] | N/A |
If ANY section is missing or under minimum, STOP and add content.
---
Image Requirements (HARD REQUIREMENT)
⛔ MINIMUM: 4 images (1 hero + 3 body)
| Image | Type | Filename | Uploaded? | Asset ID |
|---|---|---|---|---|
| Hero | Scrapbook | hero.png | [ ] | _________ |
| Body 1 | Chart | _________.png | [ ] | _________ |
| Body 2 | Chart | _________.png | [ ] | _________ |
| Body 3 | Concept | _________.png | [ ] | _________ |
| Body 4 (opt) | Chart | _________.png | [ ] | _________ |
Image QC:
- [ ] All images generated at 1344x768px (16:9)
- [ ] All text in images reviewed at 100% zoom for typos
- [ ] Brand colors used: Navy (#222239), Teal (#57b4ad), Lime (#d7df27)
- [ ] All images uploaded via
npm run upload-images - [ ]
asset-ids.jsongenerated
---
Source Citation Requirements (HARD REQUIREMENT)
⛔ Every statistic MUST have a source link. No exceptions.
| Check | Status |
|---|---|
| [ ] Opening paragraph includes linked source | |
| [ ] Every percentage has a source link | |
| [ ] Every dollar amount has a source link | |
| [ ] Every market trend claim has a source link | |
| [ ] Supporting data section: ALL bullets have sources | |
| [ ] Sources table completed at bottom of draft |
Source count: _____ (Minimum: 5 unique sources)
---
Internal Link Requirements (HARD REQUIREMENT)
⛔ MINIMUM: 8 internal links. Target: 10-12.
List all internal links:
| # | Anchor Text | URL | Section |
|---|---|---|---|
| 1 | |||
| 2 | |||
| 3 | |||
| 4 | |||
| 5 | |||
| 6 | |||
| 7 | |||
| 8 | |||
| 9 | |||
| 10 | |||
| 11 | |||
| 12 |
Total internal links: _____ (Minimum: 8)
---
AI Content Scrubbing (REQUIRED)
Run these searches and confirm ZERO matches:
| Search Term | Found? | Action |
|---|---|---|
— (emdash) | [ ] None | Replace with comma, parentheses, or period |
delve | [ ] None | Replace with "explore," "dig into," "look at" |
landscape | [ ] None | Replace with "market," "space," "industry" |
leverage | [ ] None | Replace with "use," "take advantage of" |
robust | [ ] None | Replace with "strong," "solid" |
seamless | [ ] None | Replace with "smooth," "easy" |
utilize | [ ] None | Replace with "use" |
myriad | [ ] None | Replace with "many," "lots of" |
it's important to note | [ ] None | Just state the thing |
it's worth mentioning | [ ] None | Just mention it |
In conclusion | [ ] None | Conclude naturally |
---
Statistics Boxes Verification
| Stat | Number | Text | Entry Created? | Published? |
|---|---|---|---|---|
| Stat 1 | [ ] | [ ] | ||
| Stat 2 | [ ] | [ ] | ||
| Stat 3 | [ ] | [ ] | ||
| Statistic Group | [ ] | [ ] |
Statistic Group ID: _____________
---
Readability & List Usage (HARD REQUIREMENT)
⛔ MINIMUM: 3 lists per post. Target: 4-6 lists.
Dense prose without visual breaks hurts readability. Every post MUST include lists to improve scannability.
⛔ Mandatory List Check (Do This First)
Before publishing, verify lists in these HIGH-PRIORITY sections:
| Section | Has List? | If No List, Why? |
|---|---|---|
| Breaking down the numbers | [ ] Yes / [ ] No (needs justification) | _____________ |
| How to take advantage | [ ] Yes / [ ] No (needs justification) | _____________ |
| Supporting data | [ ] Yes (REQUIRED) | N/A (always a list) |
⚠️ If "Breaking down the numbers" or "How to take advantage" has NO list, you must justify why prose is better for that specific content. Dense data or action steps almost ALWAYS need lists.
Additional List Opportunities
Check these sections for additional list opportunities to reach 4-6 total:
- [ ] "What the data shows" — platform comparisons (if 4+ platforms)
- [ ] "Why it matters" — industry applications (if 3+ examples)
- [ ] "The bigger picture" — future predictions (if 3+ items)
List Verification Table
| # | Section | List Type | Items | Purpose |
|---|---|---|---|---|
| 1 | Supporting data | Unordered | _____ | Quick-reference stats |
| 2 | ||||
| 3 | ||||
| 4 | ||||
| 5 | ||||
| 6 |
Total lists: _____ (Minimum: 3, Target: 4-6)
List Format Rules
- Bold lead-in phrase for each item:
- Key point: Explanation here - 3-7 items per list (8+ should be reconsidered or split)
- Parallel structure (all items start same way: verb, noun, etc.)
- 1-2 sentences max per list item
- Ordered lists for sequential/step-based content
- Unordered lists for non-sequential parallel items
---
Content Quality Checks
- [ ] Read aloud test: Content sounds natural, not robotic
- [ ] Sentence variety: Not all sentences start with "This" or "It"
- [ ] Readability: 3+ lists breaking up dense prose where content calls for it
- [ ] No generic statements: Specific data with specific sources
- [ ] Adwave mentions: 2-3 natural mentions (not forced)
- [ ] CTA present: Clear call-to-action with /how-it-works and /pricing links
---
Final Pre-Publish Verification
Before creating the Contentful resource entry:
- [ ] Word count verified: _____ words (min 3,000)
- [ ] All 11 sections present and substantive
- [ ] 4+ images uploaded with asset IDs recorded
- [ ] 8+ internal links included
- [ ] 5+ source citations with working links
- [ ] 3+ lists for readability (where content calls for them)
- [ ] AI content scrubbed (zero flagged terms)
- [ ] Statistics entries created and published
- [ ] Statistic Group created and published
---
Contentful Entry Creation
| Field | Value | Verified? |
|---|---|---|
| title | [ ] | |
| slug | [ ] | |
| shortDescription | [ ] | |
| headerImage | Asset ID: | [ ] |
| resourceDate | YYYY-MM-DD | [ ] |
| resourceType | Insights | [ ] |
| bodyContent | RichText built | [ ] |
| seoDescription | [ ] |
---
Post-Publish Verification
After publishing:
- [ ] Entry published successfully (Entry ID: _________)
- [ ] Calendar updated with Entry ID, status, word count, and image count
- [ ] Live URL verified: https://adwave.com/resources/[slug]
---
Sign-Off
This post has been verified against all QC requirements.
| Item | Confirmed |
|---|---|
| Word count ≥ 3,000 | [ ] |
| All 11 sections present | [ ] |
| 4+ images embedded | [ ] |
| 8+ internal links | [ ] |
| 5+ source citations | [ ] |
| 3+ lists for readability | [ ] |
| AI content scrubbed | [ ] |
| Statistics created | [ ] |
Date completed: ____________
Entry ID: ____________
---
Quick Reference: Common Failures
| Failure | Prevention |
|---|---|
| Word count under 3,000 | Check wc -w BEFORE publishing. Expand thin sections. |
| Missing sections | Use template. Verify all 11 sections exist. |
| Unsourced statistics | Never include a number without a source link. |
| AI telltale language | Run search for flagged terms before publishing. |
| Insufficient images | Generate all 4+ images before starting Contentful entry. |
| Too few internal links | Fetch sitemap first. Plan 8-12 links during outline. |
| Too few lists (dense text) | Include 3+ lists where content calls for them (data comparisons, steps, features). |
---
Enforcement
This checklist is MANDATORY, not optional.
- Do NOT proceed to Contentful entry creation until all checks pass
- Do NOT publish entries that fail any verification
- If time constraints exist, delay publication rather than publish non-compliant content
- Quality over speed: A delayed compliant post beats a fast non-compliant one
---
Template Usage
Copy this checklist for each new post:
## QC Checklist: [Post Title]
**Slug:** `[slug]`
**Date:** [YYYY-MM-DD]
### Pre-Writing
- [ ] Slug available
- [ ] Primary source identified
- [ ] 3+ supporting sources
- [ ] Sitemap fetched
### Word Count
**Result:** _____ words
- [ ] ≥ 3,000 words
### Sections (all 11)
- [ ] Opening (150+)
- [ ] What the data shows (500+)
- [ ] Breaking down (400+)
- [ ] Why it matters (400+)
- [ ] How to take advantage (400+)
- [ ] Bigger picture (350+)
- [ ] Experts saying (250+)
- [ ] Questions answered (400+)
- [ ] Supporting data (200+)
- [ ] CTA (100+)
- [ ] Statistics boxes
### Images (4+ total)
- [ ] Hero uploaded
- [ ] Body 1 uploaded
- [ ] Body 2 uploaded
- [ ] Body 3 uploaded
- [ ] All text verified
### Sources (5+ unique)
- [ ] Opening paragraph sourced
- [ ] All stats sourced
- [ ] Supporting data sourced
### Internal Links (8+)
**Count:** _____
- [ ] ≥ 8 internal links
### Readability & Lists (3+ total, target 4-6)
**Count:** _____
- [ ] "Breaking down the numbers" has a list (or justified why not)
- [ ] "How to take advantage" has a list (or justified why not)
- [ ] "Supporting data" has a list (REQUIRED)
- [ ] At least 3 lists total for readability
### AI Scrubbing
- [ ] Zero emdashes
- [ ] Zero flagged words
### Statistics
- [ ] 3 stats created
- [ ] Statistic group created
### Final
- [ ] All checks passed
- [ ] Entry published
**Entry ID:** ____________Latest change
# Stat Snapshot Pages: Complete Writing Guidelines
- > **Note:** For the overall workflow and quick reference, see `strategy/agent-context.md` first. This document provides detailed writing guidelines for stat snapshot pages.
+ > **Note:** For the overall workflow and quick reference, see `CLAUDE.md` (workspace instructions) first. This document provides detailed writing guidelines for stat snapshot pages.
---
## ⛔ MANDATORY: QC Checklist
- **BEFORE publishing ANY stat snapshot post, you MUST complete the QC checklist in `strategy/stat-snapshot-qc-checklist.md`.**
+ **BEFORE publishing ANY stat snapshot post, you MUST complete the QC Checklist section at the end of this document.**
No exceptions. No shortcuts. Every post must pass ALL verification checks before publishing.
**Key requirements that MUST be verified:**
- ✅ Word count ≥ 3,000 words (run `wc -w` on draft)
- ✅ All 11 sections present with minimum word counts
- ✅ 4+ images (1 hero + 3 body) uploaded and embedded
- ✅ 8+ internal links included
- ✅ 5+ source citations with working links
- ✅ AI content scrubbed (zero emdashes, zero flagged words)
- ✅ Statistics entries created and published
**If any check fails, FIX IT before publishing. Do not publish non-compliant content.**
---
## Overview
Stat snapshot pages are data-driven "quick reference" pages that answer specific questions people search for. They're designed for featured snippets, authority building, and driving organic traffic.
**Key differentiators from our current pages:**
- **Comprehensive long-form content (3,000-4,000 words HARD MINIMUM)**
- Better HTML-to-content ratio for SEO
- 3 highlighted stats at the top (statistic boxes)
- 8-12 contextual internal links
- In-depth analysis, context, and expert insight
- **Deep research with multiple authoritative sources**
- **All data sources linked for verification**
- **Draft review and revision step before publishing**
- **AI content scrubbing (no emdashes, no AI telltale phrases)**
- - **Prose-first writing (not bullet-point dumps)** — see `strategy/prose-first-writing-guide.md`
+ - **Prose-first writing (not bullet-point dumps)** — see the Balanced Prose & Lists section in `strategy/content-playbooks.md`
---
## ⚠️ Balanced Prose & Lists
**Use the format that best serves the reader for each type of information.**
Stat snapshot pages should read like expert analysis that's also easy to scan. Readers want to understand the data AND be able to quickly find key numbers. This requires a balance: prose to explain and connect ideas, lists to make data scannable and comparable.
### The Core Principle
**Let the content dictate the format.** Read what you've written and ask: "Would this be clearer as a list or as prose?"
- **3+ parallel items** → Usually a list (platform comparisons, demographic breakdowns, feature lists)
- **Sequential steps** → Ordered list
- **Complex explanations** → Prose with context
- **Quick reference data** → Bullet list
### When to Use Lists
| Content Type | Use List? | Why |
|--------------|-----------|-----|
| Platform-by-platform comparisons | ✅ Yes | Readers scan for their platform |
| Demographic breakdowns (age, region) | ✅ Yes | Data is easier to compare |
| Action steps or "how to" | ✅ Yes | Sequential items need visibility |
| Benefits or features (3+) | ✅ Yes | Parallel items scan better |
| Complex analysis or context | ❌ No | Needs narrative flow |
| Expert quotes or commentary | ❌ No | Prose maintains voice |
| Single or two items | ❌ No | Not worth a list |
### Minimum Requirement
**Every post needs at least 3 lists** to break up dense prose and improve readability. Target 4-6 lists per post.
### ⛔ Mandatory List Placement Guide
To ensure every post meets the 3-list minimum, use this section-by-section checklist. Not every section needs a list, but these are the HIGH-OPPORTUNITY sections where lists almost always improve readability:
| Section | List Likely? | What to List |
|---------|-------------|--------------|
| Opening paragraph | ❌ Rarely | Keep as prose |
| What the data shows | ⚠️ Sometimes | Platform comparisons (4+ platforms) |
| **Breaking down the numbers** | **✅ Usually** | **Demographics, segments, or platform breakdowns** |
| Why it matters | ⚠️ Sometimes | Industry applications (if 3+ examples) |
| **How to take advantage** | **✅ Usually** | **Action steps or strategy checklist** |
| The bigger picture | ⚠️ Sometimes | Future predictions (if 3+ items) |
| What experts are saying | ❌ Rarely | Keep as prose with quotes |
| Common questions answered | ❌ Rarely | Keep FAQ answers as prose |
| **Supporting data** | **✅ Always** | **Quick-reference stats with sources** |
| CTA | ❌ Never | Keep as prose |
**The 3 most common list locations:**
1. **"Breaking down the numbers"** — demographic or segment breakdowns
2. **"How to take advantage"** — actionable steps or strategy tips
3. **"Supporting data"** — always a bullet list of sourced stats
**If you're missing lists, check these sections first.** Dense prose in "Breaking down the numbers" or "How to take advantage" is usually the problem.
### Examples
**❌ Bad (data buried in prose):**
```markdown
## Breaking down the numbers
Adults 65 and older watch 6.5 hours daily, while adults 50-64 watch 5.4 hours, adults 35-49 watch about 4 hours, adults 18-34 watch 3.5 hours, and teens watch 2.5 hours daily. The pattern shows older Americans watch more TV.
```
**✅ Good (scannable data with context):**
```markdown
## Breaking down the numbers
The 3.7-hour average conceals enormous variation across age groups:
- **Adults 65+:** 6.5 hours daily (nearly double the average)
- **Adults 50-64:** 5.4 hours daily
- **Adults 35-49:** 4.0 hours daily
- **Adults 18-34:** 3.5 hours daily
- **Teens 12-17:** 2.5 hours daily
The pattern is clear: older Americans watch significantly more television. For advertisers, this means TV campaigns naturally reach older demographics more efficiently.
```
**❌ Bad (how-to with no structure):**
```markdown
Start with geographic targeting around your service area, typically 15-25 miles. Time campaigns for evening hours when households gather. Budget $200-500 for two weeks to achieve frequency. Use AI creative tools. Measure brand metrics not clicks.
```
**✅ Good (actionable list with context):**
```markdown
Understanding viewing patterns is useful. Here's how to act on it:
- **Geographic targeting:** 15-25 mile radius around your location
- **Timing:** Evening hours (6-10 PM) when households are together
- **Budget:** $200-500 for two weeks achieves real frequency
- **Creative:** AI platforms generate broadcast-quality ads from your website
- **Measurement:** Track brand search volume and traffic, not just clicks
Start with enough budget to reach your audience multiple times. Frequency builds recognition.
```
---
## Reference: Existing Pages
Study these two live pages as a baseline:
- [What share of TV viewing is streaming?](https://adwave.com/resources/us-tv-viewing-share-streaming)
- [What percentage of U.S. TV time is ad-supported?](https://adwave.com/resources/us-tv-ad-supported-share-q2-2025)
We'll keep their structure but expand significantly.
---
## Title & Date Marking
### Initial Publish Format
```
[Question]? (Q[X] 2025)
```
**Examples:**
- "What is YouTube's share of TV viewing? (Q2 2025)"
- "How much does a local TV ad cost? (Q3 2025)"
### Quarterly Refresh Format
```
[Question]? (Q[X] 2025 Update)
```
**Examples:**
- "What is YouTube's share of TV viewing? (Q3 2025 Update)"
### SEO Metadata
| Field | Requirement |
|-------|-------------|
| Title | 50-65 characters (including quarter marker) |
| Meta description | 150-155 characters, include key stat |
| URL slug | No dates, 3-5 words, lowercase hyphenated |
---
## Contentful Structure
### Content Type: `resource`
Stat snapshot pages use the `resource` content type with:
| Field | Value |
|-------|-------|
| `title` | Full title with quarter marker |
| `slug` | Evergreen URL (no dates) |
| `shortDescription` | Brief summary for listings |
| `headerImage` | Hero image (data visualization) |
| `resourceDate` | Publish date |
| `resourceType` | "Insights" |
| `bodyContent` | RichText with embedded components |
| `seoDescription` | Meta description |
---
## The Statistics Boxes (Key Feature)
Every stat snapshot page starts with **3 highlighted statistics** in visual boxes at the top. This is implemented using two content types:
### Content Type: `statistic`
Individual stat box with two fields:
| Field | Description | Example |
|-------|-------------|---------|
| `number` | The headline number (Symbol) | "47.3%", "$25", "10.6%" |
| `statisticText` | Description below the number (Symbol) | "Share of U.S. TV viewing time" |
### Content Type: `statisticGroup`
Groups 3 statistics together:
| Field | Description |
|-------|-------------|
| `title` | Internal name for the group (e.g., "YouTube Stats Q2 2025") |
| `statistics` | Array of 3 links to `statistic` entries |
### How to Create Statistics in Contentful
**Step 1:** Create 3 individual `statistic` entries
```
Statistic 1:
number: "10.6%"
statisticText: "YouTube's share of total U.S. TV viewing"
Statistic 2:
number: "#1"
statisticText: "Largest streaming platform by viewing share"
Statistic 3:
number: "+1.2pts"
statisticText: "Year-over-year growth"
```
**Step 2:** Create 1 `statisticGroup` entry
```
statisticGroup:
title: "YouTube TV Viewing Stats Q2 2025"
statistics: [link to stat 1, link to stat 2, link to stat 3]
```
**Step 3:** Embed the `statisticGroup` at the TOP of `bodyContent`
In the RichText editor, insert the statisticGroup as an **embedded entry block** as the FIRST element, before any text content.
### Statistics Box Best Practices
| Do | Don't |
|----|-------|
| Use exactly 3 stats | Use 2 or 4+ stats |
| Keep `statisticText` under 50 chars | Write long descriptions |
| Lead with the most impactful number | Bury the key insight |
| Include YoY change when available | Only show current numbers |
| Use consistent formatting (%, $, #) | Mix formats randomly |
**Good statistic combinations:**
1. **Primary metric** (the headline number)
2. **Ranking or comparison** (how it compares)
3. **Trend indicator** (YoY change, growth rate)
---
## Article Structure Template
### Word Count Target: 3,000-4,000 words
**HARD MINIMUM: 3,000 words. Target: 3,000-4,000 words.** Comprehensive long-form content is essential for SEO competitiveness and establishing authority. If your draft is under 3,000 words, it's too thin and needs more depth, research, and analysis.
**Why we need more words:**
- Higher content-to-HTML ratio improves SEO
- More content = more opportunities for internal links
- Comprehensive articles rank better and build authority
- Readers searching for data want depth, not summaries
### Required Elements
Every stat snapshot page must include:
1. **Hero image** (data visualization in headerImage field)
2. **3-4 body images** (embedded via placeholders in bodyContent)
3. **Statistics boxes** (3 stats in embedded statisticGroup)
4. **3,000-4,000 words** of body content across 11+ sections
5. **8-12 internal links** (more than the previous 6-10 minimum)
6. **5+ external source citations** with working links
7. **3+ bullet lists** in distinct sections (see "Balanced Prose & Lists" above)
---
## ⚠️ CRITICAL: Word Count Verification (MANDATORY)
**DO NOT SKIP THIS STEP. DO NOT PUBLISH WITHOUT VERIFICATION.**
### Pre-Draft Checkpoint
Before writing ANY stat snapshot content:
1. ✅ **Verify slug is available:** `npm run check-slug -- "slug-here"` (MANDATORY)
2. ✅ Confirm you will write ALL 11 sections
3. ✅ Plan for 3,000-4,000 words total
4. ✅ Identify 5+ authoritative sources for research
5. ✅ Prepare 8-12 internal link targets from sitemap
6. ✅ **Plan 3+ lists:** Identify data for "Breaking down the numbers" list and action steps for "How to take advantage" list
### During-Draft Word Count Targets
Track word count as you write. Each section has a MINIMUM:
| Section | Min Words | Cumulative Min |
|---------|-----------|----------------|
| Opening paragraph | 150 | 150 |
| What the data shows | 500 | 650 |
| Breaking down the numbers | 400 | 1,050 |
| Why it matters for your business | 400 | 1,450 |
| How to take advantage | 400 | 1,850 |
| The bigger picture | 350 | 2,200 |
| What experts are saying | 250 | 2,450 |
| Common questions answered | 400 | 2,850 |
| Supporting data | 200 | 3,050 |
| CTA section | 100 | 3,150 |
**If your cumulative count is below the target at any point, STOP and add more content.**
### Post-Draft Verification (REQUIRED BEFORE CONTENTFUL)
**Run this command to count words in your draft:**
```bash
wc -w drafts/stat-snapshots/YYYY-MM-DD-slug.md
```
**⚠️ CRITICAL: `wc -w` counts markdown formatting and URLs as words.**
The published content will have approximately 100-200 fewer "readable" words than the markdown file.
**Results interpretation (MINIMUM 3,200 in markdown to ensure 3,000+ published):**
- ❌ Under 3,200 words: DO NOT PROCEED. Add more content.
- ⚠️ 3,200-3,300 words: Borderline, consider expanding to be safe
- ✅ 3,300-4,000 words: Good length (ensures 3,100+ published)
- ✅ 4,000+ words: Excellent depth
**To verify actual published word count after updating Contentful:**
Use the word count verification script to count text nodes in the entry.
**Verify list placement (REQUIRED):**
```bash
awk '/^## /{section=$0} /^- /{print section}' drafts/stat-snapshots/YYYY-MM-DD-slug.md | sort | uniq -c
```
**Results interpretation:**
- ❌ Lists only in "Supporting data": Add lists to "Breaking down the numbers" AND "How to take advantage"
- ⚠️ Lists in 2 sections: Add at least one more list section
- ✅ Lists in 3+ sections: Meets minimum requirement
### What to Do If Under 3,000 Words
If your draft is too short, expand these sections (in order of priority):
1. **"What the data shows"** - Add more data points, comparisons, year-over-year analysis
2. **"Breaking down the numbers"** - Add demographic breakdowns, geographic analysis, device comparisons
3. **"Common questions answered"** - Add more FAQ items (aim for 6-8, not just 5)
4. **"Why it matters"** - Add industry-specific examples, case references
5. **"The bigger picture"** - Add historical context, future projections, market trends
### Final Pre-Publish Checklist
**DO NOT PUBLISH until ALL boxes are checked:**
- [ ] Word count verified at 3,000+ words
- [ ] All 11 sections present and substantive
- [ ] **3+ lists in distinct sections** (Breaking down, How to take advantage, Supporting data)
- [ ] 8-12 internal links included
- [ ] 5+ external source citations with working links
- [ ] Hero image uploaded and linked
- [ ] 3-4 body images embedded
- [ ] Statistics boxes created (3 stats)
- [ ] AI content scrubbed (no emdashes, no AI phrases)
- [ ] Draft reviewed and revised at least once
### Section Flow (with Image Placements)
```
0. Hero Image (uploaded to headerImage field) — REQUIRED
1. Statistics Boxes (embedded statisticGroup)
2. Opening paragraph (direct answer + hook) — 150-200 words
3. ## What the data shows — 500-700 words
📷 IMAGE 1: Data visualization (platform comparison, trend chart, etc.)
4. ## Breaking down the numbers — 400-600 words
📷 IMAGE 2: Demographic or segment breakdown
5. ## Why it matters for your business — 400-500 words
📷 IMAGE 3: Business opportunity or industry application
6. ## How to take advantage of this trend — 400-500 words
7. ## The bigger picture — 350-450 words
📷 IMAGE 4 (optional): Historical trend or future projection
8. ## What experts are saying — 250-350 words
9. ## Common questions answered — 400-500 words (FAQ format, 5-6 questions)
10. ## Supporting data — 200-300 words
11. ## Get started with TV advertising (CTA) — 100-150 words
```
**Minimum: 4 images total (1 hero + 3 body)**
### Minimum Section Count
Every stat snapshot page must include **all 11 sections** with the word counts above to achieve the 3,000 word minimum. If any section feels thin, add more research and context.
### Section Depth Check
**Before publishing, verify each section:**
- "What the data shows" has 5-8 specific data points with sources
- "Breaking down the numbers" has 3+ subsections (by age, geography, platform, etc.)
- "Common questions answered" has 5-6 FAQ items, not just 3-4
- "Supporting data" has 7-10 linked bullet points, not just 4-5
---
## Section-by-Section Writing Guide
### 1. Statistics Boxes
**Position:** First element in bodyContent (embedded entry block)
**Always include 3 stats:**
- Primary headline stat
- Comparative/ranking stat
- Trend/change stat
### 2. Opening Paragraph (100-150 words)
**Purpose:** Immediately answer the question, then hook for more.
**Formula:**
```
[Direct answer with specific stat and linked source]. [2-3 sentences of context/significance]. [Hook to keep reading].
```
**Example:**
> YouTube accounts for 10.6% of total U.S. TV viewing time, making it the single largest streaming platform by viewing share, according to [Nielsen's Gauge](https://www.nielsen.com/data-center/the-gauge/) data (April 2025). That means YouTube now commands more TV attention than Netflix, Hulu, or any other streaming service. This dominance has reshaped the advertising landscape, creating unprecedented opportunities for businesses of all sizes to reach audiences on the biggest screen in the house. Here's what that means for small businesses and how to take advantage of this shift.
**Include:**
- The exact stat with percentage/number
- Linked source attribution
- Date reference (Month Year)
- Significance statement (2-3 sentences)
- Hook for continued reading
### 3. What the Data Shows (400-600 words)
**Purpose:** Comprehensive breakdown of the headline stat with context, comparisons, and analysis.
**Format:** Primarily prose with strategic data callouts. This section should READ like analysis, not scan like a spec sheet.
**Writing approach:**
- Open with a thesis paragraph that frames what the data reveals
- Weave specific numbers INTO sentences rather than bullet-pointing them
- Use comparison and context to make numbers meaningful
- Save bullet lists ONLY for 4+ truly parallel data points that would be awkward as prose
- Close with analysis explaining what's driving the trends
**Example structure:**
```markdown
## What the data shows
YouTube's dominance in TV viewing reflects a fundamental shift in how Americans consume content on the big screen. The platform now captures 10.6% of all U.S. TV viewing time, making it the single largest streaming destination, ahead of Netflix (8.4%) and even traditional cable networks.
What makes this number particularly striking is the trajectory. YouTube's TV viewing share has grown 1.2 percentage points year-over-year, while most traditional networks continue their steady decline. The platform isn't just maintaining its position; it's actively taking share from both legacy TV and competing streamers.
The viewing patterns tell their own story. YouTube viewership peaks during prime time hours (7-10 PM), directly competing with scripted television for household attention. This isn't background viewing or quick clips; it's deliberate, lean-back entertainment consumption on the biggest screen in the house.
This growth is driven primarily by YouTube's expansion beyond mobile. Smart TV apps and streaming devices have transformed what was once a "second screen" platform into a primary TV destination. For advertisers, that shift matters enormously: TV viewing commands different attention than phone scrolling, and YouTube is increasingly capturing that premium attention.
```
**When to use a data list:** Only when presenting 4+ parallel statistics that would genuinely be clearer as a list (e.g., platform-by-platform breakdown, year-by-year comparison table).
**Internal link opportunity:** Link to relevant guide or explainer article.
### 4. Breaking Down the Numbers (300-500 words)
**Purpose:** Deep dive into specific data segments, demographics, or comparisons.
**NEW SECTION** — This expands the analysis beyond the headline stat.
**Writing approach:** Use prose to EXPLAIN patterns, not just list them. A demographic breakdown should tell a story about who's watching and why, not just present numbers in bullet form. Reserve tables and lists for genuinely complex comparisons where prose would be confusing.
**What to include:**
- Demographic analysis with context (not just bullets of age ranges)
- Geographic or time-based patterns explained in prose
- Platform comparisons (tables acceptable here for 4+ platforms)
- Business implications woven throughout
**Example:**
```markdown
## Breaking down the numbers
Understanding the full picture requires looking beyond the headline 10.6% figure. YouTube's dominance varies significantly across different demographics, time slots, and content types, and those variations matter for how you target your advertising.
### By age group
The generational divide in YouTube TV viewing is stark. Among viewers 18-34, YouTube captures roughly 15% of all TV viewing time, making it the dominant streaming destination for this cohort. That share drops to around 11% for viewers 35-49, and falls further to about 7% for those 50-64. Among seniors 65 and older, YouTube represents only about 4% of TV time.
This pattern isn't surprising when you consider viewing habits. Younger audiences grew up with YouTube and naturally gravitate toward it on every screen. But the business implication is clear: if your target customers skew under 50, YouTube is increasingly where they spend their evening entertainment hours.
### By time of day
YouTube's viewing patterns diverge from traditional TV in revealing ways. During daytime hours (6am-4pm), YouTube viewing indexes higher than its overall share would suggest, driven partly by work-from-home flexibility and the platform's utility for background content.
The real story, though, is prime time. From 8-11pm, YouTube competes directly with scripted television for household attention, particularly among cord-cutting households. And after 11pm, YouTube dominates as the default destination for on-demand entertainment when traditional programming winds down.
### Compared to other platforms
For context, here's how the top streaming services compare in total TV viewing share:
| Platform | Share of TV Viewing | YoY Change |
|----------|--------------------| -----------|
| YouTube | 10.6% | +0.8% |
| Netflix | 7.9% | +0.2% |
| Amazon Prime | 3.1% | -0.1% |
| Hulu | 2.6% | Flat |
| Disney+ | 1.9% | +0.3% |
What makes YouTube's lead particularly significant for advertisers is the ad model. YouTube is ad-supported by default, while a large portion of Netflix and Disney+ viewers pay for ad-free tiers. YouTube's 10.6% share represents almost entirely addressable advertising inventory.
```
**Internal link opportunity:** Link to platform-specific advertising guides.
### 5. Why It Matters for Your Business (300-400 words)
**Purpose:** Connect the data to SMB opportunity. This is the Adwave angle.
**Writing approach:** This section should feel like advice from a trusted consultant, not a sales pitch. Use prose to explain implications and build understanding. Only use lists for genuinely parallel examples (like industry applications) where the reader benefits from quick scanning.
**What to include:**
- Clear explanation of what this data means for SMBs
- 2-3 industry-specific applications (can be brief bullet or prose)
- Context on how this compares to traditional options
- Natural Adwave mention showing accessibility
**Example:**
```markdown
## Why it matters for your business
If your customers are watching YouTube on their TV, your ads can reach them there too. And you don't need a Super Bowl budget to make it happen.
YouTube's TV viewing surge means small businesses now have access to audiences on the biggest screen in the house. Unlike mobile YouTube ads, which are skippable and often watched with divided attention, TV-delivered YouTube ads command something different: full-screen, lean-back attention. Viewers are engaged, often watching with household members, and in a receptive mindset for brand messages.
The applications vary by business type. Local service businesses like plumbers, dentists, and attorneys can target homeowners within a specific radius during evening hours, when people are thinking about home projects and services they need. Restaurants and retailers can reach hungry viewers during dinner decision-making hours or promote weekend specials to households in their delivery zone. E-commerce brands can use TV to build brand awareness with relaxed, receptive audiences, then retarget those viewers with performance ads elsewhere.
What makes this moment different from even five years ago is accessibility. Traditional TV advertising required $50,000 or more for production costs alone, plus five-figure media buys for any meaningful reach. That world is effectively over.
With platforms like Adwave, you can run [TV advertising](https://adwave.com/resources/tv-advertising-for-small-business) campaigns across YouTube and 100+ other premium channels starting at just $50. No production budget required because AI generates your commercial from your website. No agency needed. Your ad can be live in minutes, reaching the same audiences that major brands target.
For local businesses especially, this creates a genuine opportunity to build brand awareness in your community using the same screens where national brands advertise. The playing field hasn't just been leveled; it's been opened entirely.
```
**Required internal links:**
- Link to relevant Adwave guide
- Link to 2+ industry pages
### 6. How to Take Advantage of This Trend (300-400 words)
**Purpose:** Actionable guidance for readers who want to act on this information.
**NEW SECTION** — Provides practical next steps.
**Writing approach:** This section is about helping readers take action, not dumping a checklist on them. Use prose to explain the *why* behind recommendations, with numbered steps ONLY for truly sequential processes where order matters.
**What to include:**
- Strategic approach (not just tactics)
- Budget and timeline guidance in context
- Targeting recommendations with reasoning
- Clear path forward
**Example:**
```markdown
## How to take advantage of this trend
Understanding that YouTube dominates TV viewing is useful. Knowing how to act on that information is what actually grows your business.
The smartest approach for most small businesses is to start with a test campaign. Don't overthink it or try to optimize everything from day one. Set aside $100-$200, run for two weeks, and treat it as a learning exercise. You're gathering data about what resonates with your audience, not trying to hit a home run immediately. For local businesses, start with geographic targeting around your service area, typically a 15-25 mile radius. Use AI-generated video to keep production costs at zero.
Once your test is running, focus your targeting on the patterns the data reveals. YouTube's TV viewers aren't randomly distributed. Evening hours from 7-10 PM capture the most engaged viewers, when households are settled in for entertainment. Geographic precision matters more than broad reach for most local businesses. And certain content categories on YouTube will align better with your specific audience, something you'll learn from your initial campaign data.
Measuring success for TV advertising requires different thinking than performance marketing. You're not looking for immediate clicks and conversions. Instead, watch for brand search lift (are more people Googling your business name?), overall website traffic increases during and after your campaign, QR code scans if your ad includes one, and simple customer surveys asking new customers how they heard about you.
When you find something that works, scale deliberately. Increase budget on winning creative rather than spreading thin across variations. Expand your geographic targeting. Test additional streaming platforms beyond YouTube. Layer in retargeting to capture viewers who've shown interest.
The key is starting. Many small businesses never advertise on TV because they assume it's not for them. The viewing data says otherwise, and the barriers that used to justify that assumption simply don't exist anymore.
```
**Internal link opportunity:** Link to getting started guide, pricing, how it works.
### 7. The Bigger Picture (250-350 words)
**Purpose:** Place this stat in broader context (market trends, industry shifts, future implications).
**What to include:**
- How this stat fits into larger trends
- What's driving the change
- Future implications and predictions
- Competitive landscape context
**Example:**
```markdown
## The bigger picture
YouTube's TV growth is part of a larger streaming revolution that's fundamentally reshaping the television industry. Streaming overall now accounts for over 40% of all TV viewing in the U.S., up from 28% just three years ago. Cable and broadcast continue their steady decline as viewers shift to on-demand content.
### The ad-supported shift
What makes this moment particularly significant for advertisers is where the growth is happening. While subscription services like Netflix and Disney+ have dominated streaming headlines, free and ad-supported platforms are driving much of the actual growth. YouTube, along with FAST (Free Ad-Supported Streaming TV) services like Tubi and Pluto TV, are creating more advertising inventory at accessible price points.
### What's next
Industry analysts project streaming will capture 50%+ of all TV viewing by late 2026. Within that:
- YouTube is expected to maintain or grow its lead
- Ad-supported tiers on premium services will continue expanding
- Local advertising options will become more sophisticated
### The democratization continues
For small businesses, this trend is unambiguously positive. Every percentage point that shifts from linear TV to streaming represents inventory that's more targetable, more measurable, and more accessible to smaller budgets. The days when [TV advertising](https://adwave.com/resources/how-to-advertise-on-tv) required six-figure budgets are definitively over.
```
**Internal link opportunity:** Link to streaming stats, CTV overview, or predictions article.
### 8. What Experts Are Saying (200-300 words)
**Purpose:** Add authority through industry perspectives and analysis.
**NEW SECTION** — Incorporates third-party credibility.
**What to include:**
- Quotes or paraphrased insights from industry analysts
- Research firm perspectives
- Platform or network commentary
- Academic or trade publication insights
**Example:**
```markdown
## What experts are saying
Industry analysts have noted YouTube's TV growth as one of the most significant shifts in media consumption.
Nielsen's latest Gauge report highlighted that "YouTube's expansion from mobile-first platform to living room staple represents a fundamental change in how Americans think about television." The research firm noted that YouTube's growth has come primarily at the expense of cable networks, not other streaming services.
Advertising industry observers point to the opportunity this creates:
> "The rise of ad-supported streaming, led by YouTube, is the biggest shift in TV advertising since cable fragmented the broadcast monopoly," notes a recent IAB analysis. "Except this time, the beneficiaries aren't just big brands—they're any business with a message and a modest budget."
Trade publications have emphasized the accessibility angle. Marketing Week reported that "the combination of programmatic buying, AI-generated creative, and low minimum spends has effectively removed every traditional barrier to TV advertising for small businesses."
What's notable is the consensus: this isn't a temporary blip. The structural shift toward streaming, and specifically ad-supported streaming, represents a permanent change in the television landscape.
```
**Note:** Use verifiable quotes when possible; paraphrase and attribute when direct quotes aren't available.
### 9. Common Questions Answered (300-400 words)
**Purpose:** Address related searches and frequently asked questions in FAQ format.
**NEW SECTION** — Captures long-tail search traffic and improves featured snippet potential.
**Writing approach:** Each FAQ answer should be a complete, helpful response in prose form. Avoid turning every answer into a bullet list. Use 2-4 sentences of explanation, and only use lists when the question genuinely calls for enumerating multiple parallel items.
**Format:** Use H3 headers for each question, followed by direct prose answers.
**Example:**
```markdown
## Common questions answered
### How is TV viewing share measured?
Nielsen's Gauge methodology measures TV viewing across all sources, including broadcast, cable, streaming, and other delivery methods. The data comes from a panel of representative U.S. households combined with set-top box data and smart TV automatic content recognition (ACR) technology. Nielsen tracks what's being watched on the TV screen regardless of how the content is delivered, and releases the data monthly with approximately a one-month lag.
### Does YouTube TV viewing include YouTube TV (the live TV service)?
No, Nielsen's Gauge reports separate YouTube (the main streaming platform and app) from YouTube TV (the live TV subscription service). The 10.6% viewing share figure refers specifically to the main YouTube platform. YouTube TV, which competes with services like Hulu Live and Sling TV, is counted separately in the virtual MVPD category.
### What counts as "TV viewing" in these stats?
TV viewing in Nielsen's methodology refers to content watched on a television screen, regardless of delivery method. This includes traditional broadcast and cable, streaming apps running on smart TVs, content cast or mirrored from mobile devices to the TV screen, and viewing through gaming consoles and streaming devices like Roku, Fire TV, and Apple TV. Mobile phone and computer viewing are tracked separately and aren't included in these TV-specific statistics.
### Is YouTube's dominance expected to continue?
All major industry forecasts project continued growth for YouTube's TV viewing share through at least 2027. Several factors support this trajectory: smart TV penetration continues to grow, YouTube is investing heavily in living room experiences, both YouTube Premium and ad-supported viewing are expanding, and YouTube Shorts is increasingly being consumed on TV screens. No credible analysis suggests YouTube's TV share will decline in the near term.
### How does this compare globally?
YouTube's TV dominance is most pronounced in the United States. In other major markets like the UK, Germany, and Australia, YouTube holds significant but smaller shares, typically 6-8% of total TV viewing compared to the U.S. figure of over 10%. The U.S. leads primarily due to higher smart TV penetration rates and earlier, more widespread cord-cutting adoption.
```
**Internal link opportunity:** Link to glossary terms, explainer articles.
### 10. Supporting Data (150-250 words)
**Purpose:** Provide additional stats that add depth, all with linked sources.
**Format:** Bullet points with linked sources and dates.
**⚠️ Note on lists:** This is one of the FEW sections where a bullet list is appropriate. The Supporting Data section is designed as a quick-reference resource, where readers scan for specific stats. The bullets here serve a genuine purpose (7+ parallel data points with identical structure). This is NOT a model for other sections.
**Example:**
```markdown
## Supporting data
Additional context on YouTube and streaming TV viewing:
- **Total streaming share:** Streaming represents 40.3% of U.S. TV time ([Nielsen Gauge](https://www.nielsen.com/data-center/the-gauge/), April 2025)
- **YouTube growth:** YouTube TV viewing up 120%+ since 2021 ([Nielsen](https://www.nielsen.com/news-center/))
- **Smart TV penetration:** 85% of U.S. households have at least one smart TV ([Parks Associates](https://www.parksassociates.com/), 2025)
- **Ad-supported dominance:** 73% of all TV viewing is ad-supported ([Nielsen](https://www.nielsen.com/news-center/2025/nielsen-launches-the-ad-supported-gauge/), Q1 2025)
- **CTV ad spend:** U.S. CTV advertising projected to reach $30+ billion in 2025 ([eMarketer](https://www.emarketer.com/))
- **Cord-cutting pace:** 6 million U.S. households cut the cord in 2024 ([Leichtman Research](https://www.leichtmanresearch.com/), 2025)
- **Average streaming time:** U.S. adults stream an average of 3+ hours per day ([Nielsen](https://www.nielsen.com/))
All sources linked above. Data current as of [Month] 2025.
```
### 11. CTA Section (80-120 words)
**Purpose:** Natural transition to Adwave.
**Format:**
```markdown
## Get started with TV advertising
Ready to reach [audience descriptor] on the biggest screen in the house? Adwave makes [TV advertising](https://adwave.com/resources/how-to-advertise-on-tv) accessible for small businesses, with campaigns starting at just $50.
[See how it works](https://adwave.com/how-it-works) | [View pricing](https://adwave.com/pricing)
```
**Audience descriptors by topic:**
- Platform share: "YouTube viewers", "streaming audiences"
- Cord cutting: "cord cutters", "streaming-first households"
- Industry size: "CTV audiences", "streaming viewers"
- Demographics: "millennial viewers", "Gen Z audiences"
---
## Internal Linking Requirements
### Minimum: 8-12 Internal Links Per Article
With longer content (3,000-4,000 words), every stat snapshot must include **at least 8 contextual internal links** from the [Adwave sitemap](https://adwave.com/sitemap.xml). Aim for 10-12 when natural opportunities exist. More content = more linking opportunities.
### Link Placement Strategy
| Section | Link Target | Purpose |
|---------|-------------|---------|
| Opening/What data shows | Related guide article | Deepen understanding |
| Why it matters | Industry page or TV guide | Connect to vertical |
| Bigger picture | Another stat page or overview | Build topic cluster |
| CTA | /how-it-works, /pricing | Convert |
| Throughout | Relevant resources | Natural mentions |
### High-Value Link Targets
**Guides (link from relevant stats):**
- `/resources/tv-advertising-for-small-business`
- `/resources/how-to-advertise-on-tv`
- `/resources/what-is-connected-tv-advertising`
- `/resources/ctv-advertising-statistics-2025`
- `/resources/roku-advertising-small-business`
- `/resources/hulu-advertising-small-business`
- `/resources/local-tv-advertising-costs`
**Industry Pages (link from relevant verticals):**
- `/industries/food-beverage`
- `/industries/real-estate`
- `/industries/healthcare`
- `/industries/home-services`
**Product Pages (CTA section):**
- `/how-it-works`
- `/pricing`
- `/features`
### Link Formatting
**In RichText bodyContent:**
- Use `hyperlink` node type for external URLs
- Use `entry-hyperlink` node type for internal Contentful entries
**Anchor text rules:**
- Descriptive, not "click here"
- Natural integration into sentences
- Keyword-relevant when possible
---
## File Structure for Drafts
```
/drafts/stat-snapshots/
├── 2025-04-18-youtube-tv-viewing-share.md
├── 2025-04-21-netflix-tv-viewing-share.md
└── images/
└── 2025-04-18-youtube-tv-viewing-share/
└── hero.png
```
---
## Markdown Draft Template
```markdown
## Article Brief
**Publish Date:** YYYY-MM-DD
**URL Slug:** `[slug]`
**Category:** Insights
**Funnel Stage:** TOFU
**Strategy:** Beyond
**Target Word Count:** 2,500-4,000 (hard minimum 2,500)
---
## SEO Metadata
**Title:** [Question]? (Q[X] 2025)
**Meta Description:** [Direct answer with key stat]. [Source]. Updated [Month] 2025.
**Primary Keyword:** [main search query]
**Secondary Keywords:** [3-5 related terms]
---
## Statistics Boxes
Create as separate Contentful entries, then embed as statisticGroup.
**Stat 1:**
- Number: [X%]
- Text: [Brief description]
**Stat 2:**
- Number: [#X or X%]
- Text: [Brief description]
**Stat 3:**
- Number: [+X% or X]
- Text: [Brief description]
---
## Article Content
# [Title as Question]? (Q[X] 2025)
[Opening paragraph: 150-200 words. Direct answer with linked stat and source. 3-4 sentences of context/significance. Hook to continue reading.]
---
## What the data shows
[500-700 words — PROSE-FIRST, weave data into flowing paragraphs]
[Opening paragraph: Thesis statement framing what the data reveals, with 1-2 key numbers woven in]
[Body paragraph 1: Expand on the primary data point with context and comparison. Include specific numbers IN sentences, not as bullets.]
[Body paragraph 2: Secondary data points with analysis. Explain what's driving the numbers, not just what they are.]
[Body paragraph 3: Historical context or year-over-year analysis. How has this changed? Why does the trajectory matter?]
[Closing paragraph: Synthesis — what does this all mean together?]
**NOTE:** Only use a data list if you have 5+ parallel statistics that would be genuinely awkward as prose. Even then, lead with prose context first.
<!-- IMAGE: data-visualization -->
**Placement:** After "What the data shows" section
**Type:** Chart
**Description:** [Data visualization showing the key stat - bar chart, pie chart, etc.]
**Filename:** data-visualization.png
<!-- /IMAGE -->
[Internal link to related guide]
---
## Breaking down the numbers
[400-600 words]
[Introduction to deeper analysis]
### By [segment 1] (e.g., age group, geography, time)
[Breakdown with specific data points]
### By [segment 2]
[Breakdown with specific data points]
### Compared to [relevant comparison]
[Comparison table or analysis]
<!-- IMAGE: breakdown-chart -->
**Placement:** After "Breaking down the numbers" section
**Type:** Chart
**Description:** [Breakdown visualization - demographic groups, segments, etc.]
**Filename:** breakdown-chart.png
<!-- /IMAGE -->
[Internal link to relevant guide]
---
## Why it matters for your business
[400-500 words — PROSE-FIRST, explain implications conversationally]
[Opening paragraph: Hook connecting this data to the reader's business opportunity]
[Body paragraph 1: Explain the core implication — what does this stat mean for someone trying to grow a business?]
[Body paragraph 2: Industry applications — you can briefly mention 2-3 industry types, but explain HOW they can use this, not just list them. Example: "Local service businesses like plumbers and dentists can target homeowners within their service radius during evening hours when people are thinking about home projects."]
[Body paragraph 3: The accessibility angle — explain how barriers have collapsed. Weave in Adwave naturally ($50 minimum, AI-generated ads, 100+ channels) as part of the larger story, not as a feature dump.]
[Closing paragraph: Tie it together — why this moment is different]
**NOTE:** Do NOT bullet-point industry examples. Weave them into prose.
<!-- IMAGE: business-opportunity -->
**Placement:** After "Why it matters" section
**Type:** Concept
**Description:** [Visual showing business opportunity or industry application]
**Filename:** business-opportunity.png
<!-- /IMAGE -->
[Internal links to industry pages]
---
## How to take advantage of this trend
[400-500 words — PROSE-FIRST, write as advice, not as checklists]
[Opening paragraph: Set up the strategic approach — understanding data is step one, acting on it is what grows your business]
[Body paragraph 1: Test campaign guidance — explain the approach (budget range, duration, targeting philosophy) in flowing prose. Don't bullet-point "Budget: $100-200, Duration: 2 weeks" etc.]
[Body paragraph 2: Targeting strategy — explain the thinking behind good targeting, not just a list of targeting options. Help readers understand WHY to target certain ways.]
[Body paragraph 3: Measurement approach — explain how TV advertising measurement differs from performance marketing. What should they watch for? How long before they see results?]
[Body paragraph 4: Scaling strategy — once they have data, how should they think about growing? Again, explain the reasoning.]
[Closing: The key is starting — encourage action]
[Internal links to getting started guide, pricing]
**NOTE:** Numbered steps are acceptable IF they're truly sequential, but each step should be a full explanation, not a one-liner.
---
## The bigger picture
[350-450 words]
[How this stat fits into larger industry trends]
### [Trend heading] (e.g., The ad-supported shift)
[Trend analysis]
### What's next
[Future implications and predictions]
<!-- IMAGE: trend-chart (OPTIONAL 4th image) -->
**Placement:** After "The bigger picture" section
**Type:** Chart
**Description:** [Historical trend line or future projection visualization]
**Filename:** trend-chart.png
<!-- /IMAGE -->
### The democratization continues
[How this benefits small businesses]
[Internal link to related overview or stat page]
---
## What experts are saying
[250-350 words]
[Industry analyst perspectives]
[Quotes or paraphrased insights from authoritative sources]
[Trade publication or research firm commentary]
[Implications drawn from expert analysis]
---
## Common questions answered
[400-500 words, 5-6 FAQ items — PROSE ANSWERS, not bullet lists]
### [Question 1]?
[2-4 sentences of prose answering the question completely. Do NOT bullet-point the answer. Write it as you would explain it to a colleague.]
### [Question 2]?
[2-4 sentences of prose. If the answer involves multiple items (e.g., "what counts as TV viewing"), write them as a sentence with commas, not as bullets.]
### [Question 3]?
[Direct prose answer]
### [Question 4]?
[Direct prose answer]
### [Question 5]?
[Direct prose answer]
**NOTE:** Each FAQ answer should be a complete, helpful response in prose form. The only exception is if a question genuinely asks for a list of 4+ items (rare).
---
## Supporting data
[200-300 words, 7-10 linked bullet points]
Additional context on [topic]:
- **[Stat label 1]:** [Number/fact] ([Source Name](source-url), [Date])
- **[Stat label 2]:** [Number/fact] ([Source Name](source-url), [Date])
- **[Stat label 3]:** [Number/fact] ([Source Name](source-url), [Date])
- **[Stat label 4]:** [Number/fact] ([Source Name](source-url), [Date])
- **[Stat label 5]:** [Number/fact] ([Source Name](source-url), [Date])
- **[Stat label 6]:** [Number/fact] ([Source Name](source-url), [Date])
- **[Stat label 7]:** [Number/fact] ([Source Name](source-url), [Date])
All sources linked above. Data current as of [Month] 2025.
---
## Get started with TV advertising
[100-150 words]
Ready to reach [audience descriptor]? Adwave makes [TV advertising](https://adwave.com/resources/how-to-advertise-on-tv) accessible for small businesses, with campaigns starting at just $50. No production budget required. No agency needed.
[See how it works](https://adwave.com/how-it-works) | [View pricing](https://adwave.com/pricing)
---
## Internal Links Used (Minimum 8-12)
1. [Anchor text](URL) - in [section]
2. [Anchor text](URL) - in [section]
3. [Anchor text](URL) - in [section]
4. [Anchor text](URL) - in [section]
5. [Anchor text](URL) - in [section]
6. [Anchor text](URL) - in [section]
7. [Anchor text](URL) - in [section]
8. [Anchor text](URL) - in [section]
9. [Anchor text](URL) - in [section]
10. [Anchor text](URL) - in [section]
11. [Anchor text](URL) - in [section] (if applicable)
12. [Anchor text](URL) - in [section] (if applicable)
---
## AI Scrubbing Checklist
Before publishing, verify:
- [ ] **Zero emdashes (—):** Use Cmd+F to search, replace ALL with commas/parentheses/periods
- [ ] **No AI telltale words:** Search for: delve, landscape, leverage, robust, seamless, utilize, myriad, realm, embark, paradigm, tapestry
- [ ] **No hedging phrases:** Remove "it's important to note," "it's worth mentioning," "it should be noted"
- [ ] **Sentence variety:** Not all sentences start with "This" or "It"
- [ ] **Natural flow:** Read aloud, sounds human-written
- [ ] **No generic conclusions:** No "In conclusion" or "To summarize"
---
## Images (Minimum 4 Total)
| Image | Filename | Type | Placement | Description |
|-------|----------|------|-----------|-------------|
| Hero | hero.png | Bar chart | headerImage field | [Main stat visualization] |
| Body 1 | data-visualization.png | Chart | After "What the data shows" | [Key data comparison] |
| Body 2 | breakdown-chart.png | Chart | After "Breaking down the numbers" | [Segment/demographic breakdown] |
| Body 3 | business-opportunity.png | Concept | After "Why it matters" | [Business application visual] |
| Body 4 (opt) | trend-chart.png | Line graph | After "The bigger picture" | [Historical trend or projection] |
**Image generation prompts:**
- Hero: [Describe the main visualization]
- Body 1: [Describe data comparison visual]
- Body 2: [Describe breakdown visual]
- Body 3: [Describe business opportunity visual]
---
## Sources
| Stat | Source | URL | Data Date |
|------|--------|-----|-----------|
| [Primary stat] | [Source] | [Full URL] | [Month Year] |
| [Stat 2] | [Source] | [Full URL] | [Month Year] |
| [Stat 3] | [Source] | [Full URL] | [Month Year] |
| [Stat 4] | [Source] | [Full URL] | [Month Year] |
| [Stat 5] | [Source] | [Full URL] | [Month Year] |
| [Stat 6] | [Source] | [Full URL] | [Month Year] |
| [Stat 7] | [Source] | [Full URL] | [Month Year] |
| [Stat 8] | [Source] | [Full URL] | [Month Year] |
**Primary source update schedule:** [e.g., Monthly for Nielsen Gauge]
```
---
## Image Requirements (MANDATORY)
**Every stat snapshot page MUST have:**
- **1 hero image** (uploaded to headerImage field)
- **3-4 body images** (embedded in bodyContent via placeholders)
**Total minimum: 4 images per post.** Do not proceed to publishing without all images.
---
### Hero Image
**Style:** Editorial Clean (Data Visualization)
Each stat snapshot needs ONE hero image showing the key stat visually.
**Hero image types by topic:**
| Topic | Recommended Visual |
|-------|-------------------|
| Platform share | Bar chart comparing platforms |
| Industry size | Line graph showing growth |
| Consumer behavior | Donut chart with breakdown |
| Device penetration | Icon-based comparison |
| Ad costs | Comparison bars |
| Demographics | Grouped bar chart by age |
| Predictions | Line graph with projection |
---
### Body Images (3-4 Required)
Body images break up text, visualize data, and improve engagement. Place them strategically throughout the article.
**Recommended placements:**
1. **After "What the data shows"** → Data visualization or comparison chart
2. **After "Breaking down the numbers"** → Demographic breakdown or segment chart
3. **After "Why it matters for your business"** → Industry application or opportunity visual
4. **After "The bigger picture"** → Trend line or future projection (optional 4th image)
**Body image types:**
| Section | Image Type | Example |
|---------|-----------|---------|
| What the data shows | Bar/pie chart | Platform comparison |
| Breaking down the numbers | Grouped bars | Demographics breakdown |
| Why it matters | Concept illustration | Business opportunity |
| The bigger picture | Line graph | Historical trend |
---
### Image Placeholder Format (REQUIRED)
**⚠️ CRITICAL: Standard markdown images `` DO NOT WORK in Contentful.**
You MUST use the placeholder format below. The markdown-to-richtext script ignores standard markdown image syntax.
**Required format for ALL body images:**
```markdown
<!-- IMAGE: unique-id -->
**Placement:** [Where in article]
**Type:** [Chart | Diagram | Concept]
**Description:** [Alt text for accessibility]
**Filename:** exact-filename.png
<!-- /IMAGE -->
```
**Example:**
```markdown
<!-- IMAGE: platform-comparison -->
**Placement:** After "What the data shows" section
**Type:** Chart
**Description:** Bar chart comparing streaming platform TV viewing shares
**Filename:** platform-comparison.png
<!-- /IMAGE -->
```
**The `**Filename:**` line MUST match exactly what's in `asset-ids.json`.**
---
### Image Specifications
- **Dimensions:** 1344x768px (16:9)
- **Colors:** Navy (#222239), Teal (#57b4ad), Lime (#d7df27), Cream background
- **Style:** Flat, no shadows, no gradients, large data callouts
- **Text:** Minimal, verified for accuracy
### Image Generation Workflow
1. **Generate hero image** using nano-banana MCP
2. **Generate 3-4 body images** using nano-banana MCP
3. **Review ALL text** in each image at 100% zoom
4. **Copy to article folder:**
```bash
mkdir -p drafts/stat-snapshots/images/[slug]/
cp "/Users/naffis/generated_imgs/generated-XXX.png" "drafts/stat-snapshots/images/[slug]/hero.png"
cp "/Users/naffis/generated_imgs/generated-XXX.png" "drafts/stat-snapshots/images/[slug]/platform-comparison.png"
# etc.
```
5. **Upload all images:**
```bash
npm run upload-images -- "drafts/stat-snapshots/images/[slug]/" "Article Title"
```
6. **Add placeholders to draft** with exact filenames from asset-ids.json
---
## Research Workflow
### Research Depth Requirements
**Every stat snapshot requires DEEP research, not surface-level data collection.**
**⚠️ CRITICAL: Only include data you can SOURCE. If you cannot find a verifiable source for a statistic, do NOT include it.**
Before writing, you must:
1. **Search multiple sources** for each key stat (minimum 3 searches)
2. **Read full articles**, not just headlines or snippets
3. **Find supporting data** beyond the headline stat — WITH SOURCES
4. **Understand the methodology** behind key numbers
5. **Identify trends and context** (YoY changes, historical data) — WITH SOURCES
6. **Look for expert commentary** (analyst quotes, industry perspectives) — VERIFY QUOTES ARE REAL
7. **Record source URLs** for every data point you plan to use
### Research Checklist
- [ ] **Primary source identified and verified** (Nielsen, eMarketer, etc.) — MUST HAVE URL
- [ ] **3+ supporting sources found** with corroborating or contextual data — ALL WITH URLs
- [ ] **Historical data gathered** (at least 2-3 years of trends) — ONLY IF SOURCED
- [ ] **Demographic breakdowns found** (by age, geography, platform) — ONLY IF SOURCED
- [ ] **Industry commentary collected** (analyst quotes, expert perspectives) — MUST BE VERIFIABLE
- [ ] **Competitive/comparison data gathered** — ONLY IF SOURCED
- [ ] **Methodology understood** (how is this data measured?)
- [ ] **Limitations noted** (what doesn't this data show?)
- [ ] **⚠️ SOURCE URL RECORDED** for every single data point you plan to include
### Step 1: Find Primary Source
| Category | Primary Source |
|----------|---------------|
| TV viewing share | Nielsen Gauge |
| Industry size/spend | eMarketer, IAB |
| Cord cutting | Leichtman Research |
| Device penetration | Parks Associates |
| Platform subscribers | Company earnings |
| Ad costs | IAB, industry reports |
### Step 2: Verify Recency
- Data must be from within last 6 months
- Note "as of [Month Year]" prominently
- Plan updates when new data releases
### Step 3: Cross-Reference
- Verify key stats in 2+ sources when possible
- Use most authoritative as primary
- Note discrepancies if significant
### Step 4: Expand Beyond the Headline
Don't stop at the primary stat. For every headline number, also find:
- **Historical context:** What was this number 1, 2, 3 years ago?
- **Demographic breakdown:** How does this vary by age, income, geography?
- **Platform/segment breakdown:** How does this break down by category?
- **Expert analysis:** What do industry analysts say about this trend?
- **Business implications:** What does this mean for advertisers?
- **Future projections:** What are forecasts for next 1-3 years?
### Step 5: Fill Content Gaps
If any section of your draft feels thin, go back and research more. Common gaps:
- **"Breaking down the numbers"** lacks demographic or segment data
- **"What experts are saying"** has no actual quotes or analyst perspectives
- **"The bigger picture"** doesn't include future projections
- **"Common questions answered"** only has 3-4 FAQs instead of 5-6
---
## ⛔ CRITICAL: No Unsourced Data
**NEVER include statistics, percentages, or specific data points without a verifiable source link.**
### The Golden Rule
**If you cannot provide a source link, do not present it as a fact.**
This is non-negotiable. Spreading unverified data:
- Damages Adwave's credibility
- Risks publishing false information
- Hurts SEO when readers/fact-checkers find errors
- Can lead to embarrassing corrections
### What REQUIRES a Source (No Exceptions)
- Market sizes (e.g., "$33 billion")
- Percentages and shares (e.g., "38% of TV ad spend")
- Year-over-year changes (e.g., "up 16%")
- Platform-specific numbers (e.g., "Netflix has 94M users")
- Category or demographic breakdowns
- Historical data and projections
- Expert quotes
- Research findings
### What Can Be Stated Without a Source
- Common knowledge (e.g., "TV advertising is expensive for small businesses")
- Adwave product facts (e.g., "$50 minimum, 100+ channels")
- General explanations and definitions
- Recommendations and strategic advice
### If You Cannot Find a Source
1. **Do not invent numbers** — No "approximately," "around," or "estimated" without basis
2. **Describe qualitatively** instead of quantitatively (e.g., "varies significantly by category" instead of made-up percentages)
3. **Remove the claim** entirely if you cannot source it
### Pre-Publish Audit
Before publishing, manually check:
- [ ] Every percentage has a source link
- [ ] Every dollar amount has a source link
- [ ] Every claim about market trends has a source link
- [ ] Every breakdown (by category, geography, etc.) has a source link
- [ ] The Supporting Data section has a source for EVERY bullet
---
## Source Citation Requirements
**Every stat must be verifiable.** Readers (and Google) trust content that shows its work. All data points must link to their original sources so anyone can verify the information.
### Citation Format in Body Content
When citing stats in the body, use this format with a linked source:
```markdown
YouTube captured 10.6% of all U.S. TV viewing time in April 2025, according to [Nielsen's Gauge](https://www.nielsen.com/data-center/the-gauge/).
```
**Rendered as:**
> YouTube captured 10.6% of all U.S. TV viewing time in April 2025, according to [Nielsen's Gauge](https://www.nielsen.com/data-center/the-gauge/).
### Citation Format in Supporting Data Section
Each bullet in the "Supporting data" section must include:
1. The specific stat with number
2. The source name (linked to source URL)
3. The date of the data
**Format:**
```markdown
- **Total streaming share:** Streaming represents 40.3% of U.S. TV time ([Nielsen Gauge](https://www.nielsen.com/data-center/the-gauge/), April 2025)
```
**Full example:**
```markdown
## Supporting data
Additional context on YouTube and streaming TV viewing:
- **Total streaming share:** Streaming represents 40.3% of U.S. TV time ([Nielsen Gauge](https://www.nielsen.com/data-center/the-gauge/), April 2025)
- **YouTube growth:** YouTube TV viewing up 120%+ since 2021 ([Nielsen](https://www.nielsen.com/news-center/2025/streaming-reaches-historic-tv-milestone/))
- **Smart TV penetration:** 85% of U.S. households have at least one smart TV ([Parks Associates](https://www.parksassociates.com/), 2025)
- **Ad-supported dominance:** 73% of all TV viewing is ad-supported ([Nielsen Ad-Supported Gauge](https://www.nielsen.com/news-center/2025/nielsen-launches-the-ad-supported-gauge/), Q1 2025)
- **CTV ad spend:** U.S. CTV advertising projected to reach $30+ billion in 2025 ([eMarketer](https://www.emarketer.com/), 2025)
```
### Primary Source URLs by Category
Always link to the most authoritative, direct source:
| Category | Source | URL |
|----------|--------|-----|
| TV viewing share | Nielsen Gauge | `https://www.nielsen.com/data-center/the-gauge/` |
| Nielsen press releases | Nielsen News Center | `https://www.nielsen.com/news-center/` |
| CTV/streaming spend | eMarketer | `https://www.emarketer.com/` |
| Ad industry reports | IAB | `https://www.iab.com/insights/` |
| Cord cutting stats | Leichtman Research | `https://www.leichtmanresearch.com/` |
| Device penetration | Parks Associates | `https://www.parksassociates.com/` |
| Platform earnings | Investor relations | Company-specific IR pages |
### Citation Rules
1. **Link to the specific report/page when possible**, not just the homepage
- ✅ `https://www.nielsen.com/news-center/2025/streaming-reaches-historic-tv-milestone/`
- ❌ `https://www.nielsen.com/`
2. **For paywalled sources (eMarketer)**, link to the press release or public summary if available
3. **For company earnings data**, link to the investor relations page or SEC filing
4. **Always include the date** of the data, not just the source name
- ✅ "(Nielsen Gauge, April 2025)"
- ❌ "(Nielsen)"
5. **Opening paragraph must cite the primary source** with a link
6. **"Supporting data" section must have every stat linked**
### Draft Metadata: Sources Section
Every draft must include a complete sources section at the bottom:
```markdown
---
## Sources
| Stat | Source | URL | Data Date |
|------|--------|-----|-----------|
| YouTube 10.6% share | Nielsen Gauge | https://www.nielsen.com/data-center/the-gauge/ | April 2025 |
| Streaming 40.3% of TV | Nielsen Gauge | https://www.nielsen.com/data-center/the-gauge/ | April 2025 |
| 120% growth since 2021 | Nielsen News | https://www.nielsen.com/news-center/2025/streaming-reaches-historic-tv-milestone/ | June 2025 |
| 85% smart TV penetration | Parks Associates | https://www.parksassociates.com/ | 2025 |
| 73% ad-supported | Nielsen | https://www.nielsen.com/news-center/2025/nielsen-launches-the-ad-supported-gauge/ | Q1 2025 |
| $30B CTV ad spend | eMarketer | https://www.emarketer.com/ | 2025 |
```
This table ensures:
- Every stat is traceable
- URLs are preserved for Contentful entry creation
- Refreshes can verify/update each source
---
## Quarterly Refresh Workflow
### CRITICAL: Refreshes Create NEW Posts
**DO NOT replace or update existing stat posts.** Each quarterly refresh creates a brand new post. This preserves:
- Historical record of past data
- SEO value of existing URLs
- Ability to track data changes over time
### Refresh Schedule
- **Q3 Refresh (July):** Create new posts for Q2 topics with Q3 data
- **Q4 Refresh (October):** Create new posts for Q2 + Q3 topics with Q4 data
- **Q1 Refresh (January):** Major annual refresh - new posts for all high-traffic topics
### New Post Requirements
Each refresh post is a **completely new article** with:
1. **New title:** Include DATA quarter in title (e.g., "What is YouTube's share of TV viewing? (Q4 2025)" for December 2025 data)
2. **New slug:** Add DATA quarter suffix (e.g., `youtube-tv-viewing-share-q4-2025`)
3. **New Contentful entry:** Fresh entry ID, not an update to existing
4. **New statistics:** Create new statistic entries in Contentful
5. **Updated content:** All sections rewritten with latest data
6. **Historical context:** Reference previous quarters for trend analysis
**IMPORTANT:** The quarter in the slug and title indicates when the DATA is from, not when the post is published. December 2025 data = Q4 2025. January 2026 data = Q1 2026.
### What Makes a Refresh Post Different
| Element | Original Post | Refresh Post |
|---------|--------------|--------------|
| Slug | `youtube-tv-viewing-share` | `youtube-tv-viewing-share-q4-2025` |
| Title | What is YouTube's share of TV viewing? (Q2 2025) | What is YouTube's share of TV viewing? (Q4 2025) |
| Entry ID | Original ID (keep live) | New entry ID |
| Statistics | Original numbers | New statistic entries |
| Content | Original analysis | Updated with new data + YoY trends |
### Contentful Publishing Process for Refreshes
1. **Check slug availability:** `npm run check-slug -- "topic-slug-q4-2025"`
2. **Create new statistic entries** (3 required) with updated numbers
3. **Create new statisticGroup entry** linking the 3 statistics
4. **Write new article** following all stat snapshot guidelines
5. **Create new Contentful entry** with new slug and fresh resourceDate
6. **DO NOT unpublish or modify the original post**
---
## Draft Review & Revision Workflow
**Every draft must go through a review and revision cycle before publishing.**
### Step 1: Initial Draft
Write the complete draft following all section guidelines:
- All 11 sections present
- 2,000-3,500 word count achieved
- Sources researched and cited
- Internal links identified
### Step 2: Review Checklist
After completing the draft, review against these criteria:
#### Content Quality
- [ ] **Word count:** 3,000-4,000 words (check exact count, 3,000 minimum)
- [ ] **All sections present:** All 11 sections included with adequate depth
- [ ] **Section balance:** No section too thin (under 150 words) or bloated (over 700 words)
- [ ] **Flow:** Sections transition naturally, no abrupt topic jumps
- [ ] **Voice:** Conversational, not academic; confident, not salesy
- [ ] **Depth:** Each section goes beyond surface-level, with specific data and analysis
#### AI Scrubbing (CRITICAL)
- [ ] **No emdashes (—):** Search and replace ALL emdashes with commas, parentheses, or periods
- [ ] **No AI telltale words:** No "delve," "landscape," "leverage," "robust," "seamless," "utilize," "myriad," "realm," "embark," "paradigm," "tapestry"
- [ ] **No hedging phrases:** No "it's important to note," "it's worth mentioning," "it should be noted"
- [ ] **Sentence variety:** Not all sentences start with "This" or "It"
- [ ] **Natural conclusion:** No "In conclusion" or "To summarize"
- [ ] **Read aloud test:** Content sounds natural when spoken
#### Data Accuracy
- [ ] **Primary stat verified:** Headline stat double-checked against source
- [ ] **All stats current:** No data older than 6 months
- [ ] **Sources authoritative:** All sources are recognized industry authorities
- [ ] **Numbers consistent:** Same stat isn't cited with different numbers in different sections
- [ ] **Math correct:** Any calculations or percentages are accurate
#### Source Citations
- [ ] **Every stat linked:** Every data point has a linked source
- [ ] **Links work:** All source URLs verified as working
- [ ] **Dates included:** Every citation includes data date
- [ ] **Primary source in opening:** First paragraph includes linked source
#### SEO & Structure
- [ ] **H2 headings:** All main sections use H2
- [ ] **H3 for subsections:** Subsections use H3 (not H2)
- [ ] **Internal links:** 6-10 contextual internal links present
- [ ] **Meta description:** Under 155 chars, includes key stat
- [ ] **Title:** Includes quarter marker, under 65 chars
#### Adwave Integration
- [ ] **Natural mentions:** Adwave mentioned naturally, not forced
- [ ] **Value proposition clear:** $50 minimum, AI-generated ads, 100+ channels mentioned
- [ ] **CTA present:** Clear call-to-action with links to /how-it-works and /pricing
- [ ] **Industry links:** Relevant industry pages linked where appropriate
#### Images (REQUIRED)
- [ ] **Hero image planned:** Data visualization type identified for hero
- [ ] **Body image placeholders:** 3-4 `<!-- IMAGE: -->` placeholders in draft
- [ ] **Placement strategic:** Images placed after key sections to break up text
- [ ] **Descriptions clear:** Each placeholder has clear description for generation
### Step 3: Revision Pass
After review, make a revision pass addressing:
1. **Content gaps:** Add depth to any thin sections (go back and research more if needed)
2. **Source issues:** Fix or add citations as needed
3. **Link opportunities:** Add internal links where natural (aim for 8-12)
4. **AI scrubbing:** Remove ALL emdashes and AI telltale language
5. **Voice cleanup:** Ensure conversational tone throughout
6. **Data verification:** Re-verify any stats that weren't sourced correctly
7. **Word count check:** If under 3,000, expand thin sections
### Step 4: Final Review
Before publishing, confirm:
- [ ] All checklist items from Step 2 are now passing
- [ ] Word count is within 2,000-3,500 range
- [ ] Draft reads naturally when read aloud
- [ ] All links are correct (internal and external)
- [ ] Sources table at bottom is complete
### Step 5: Proceed to Publishing
Only after passing all review criteria, proceed to Contentful publishing workflow.
---
## Quality Checklist
Quick reference checklist (use after Draft Review & Revision is complete):
### Content Structure
- [ ] **Statistics boxes:** 3 stats created and embedded at top
- [ ] **Title:** Includes quarter marker (Q2 2025)
- [ ] **Opening:** Directly answers question with linked source
- [ ] **Word count:** 3,000-4,000 words (hard minimum 3,000)
- [ ] **All sections:** 11 sections present with adequate depth
### AI Scrubbing (CRITICAL)
- [ ] **No emdashes:** Zero (—) characters in the entire document
- [ ] **No AI words:** No delve, landscape, leverage, robust, seamless, utilize, myriad, realm, embark, paradigm, tapestry
- [ ] **No hedging:** No "it's important to note," "it's worth mentioning"
- [ ] **Natural voice:** Reads like a human expert wrote it
### Images (REQUIRED - Minimum 4 Total)
- [ ] **Hero image:** Data visualization uploaded to headerImage field
- [ ] **Body images:** 3-4 images embedded in bodyContent via placeholders
- [ ] **Image placeholders:** All use `<!-- IMAGE: -->` format with correct filenames
- [ ] **Text reviewed:** All text in images verified at 100% zoom for accuracy
- [ ] **Asset IDs:** All images uploaded and asset-ids.json generated
### ⛔ Source Citations (CRITICAL — NO EXCEPTIONS)
- [ ] **⚠️ NO UNSOURCED DATA:** Every statistic, percentage, and specific number has a source link
- [ ] **Opening paragraph:** Primary source linked (e.g., "according to [Nielsen's Gauge](url)")
- [ ] **All stats linked:** Every stat in body and "Supporting data" has source link
- [ ] **Source URLs verified:** All links are working and go to correct pages
- [ ] **Data dates included:** Every citation includes date (Month Year or Quarter Year)
- [ ] **Sources table complete:** Draft includes full sources table at bottom
- [ ] **No invented data:** If you couldn't find a source, the data is NOT included
### Links
- [ ] **Internal links:** 8-12 contextual Adwave links included (minimum 8)
- [ ] **CTA:** Links to /how-it-works and /pricing
- [ ] **External sources:** All source links working (minimum 5 external sources)
### SEO & Metadata
- [ ] **Data recency:** All data within 6 months
- [ ] **Adwave mention:** Natural mentions in "Why it matters" and "How to take advantage" sections
- [ ] **Slug:** No date (evergreen URL)
- [ ] **Meta description:** Under 155 chars, includes key stat
---
## Contentful Publishing Workflow
### Step 0: Generate ALL Images (REQUIRED)
**Before creating any Contentful entries, generate all images:**
#### 0a. Generate Hero Image
1. Follow "Editorial Clean" style (data visualization)
2. Generate 1344x768px showing key stat
3. Verify all text at 100% zoom
4. Save to `/drafts/stat-snapshots/images/[slug]/hero.png`
#### 0b. Generate Body Images (3-4)
1. Generate each image based on placeholders in draft
2. Use same Editorial Clean style and brand colors
3. Verify all text at 100% zoom
4. Save with exact filenames matching placeholders:
- `platform-comparison.png`
- `demographics-breakdown.png`
- `trend-chart.png`
- etc.
#### 0c. Upload All Images
```bash
npm run upload-images -- "drafts/stat-snapshots/images/[slug]/" "Article Title"
```
This generates `asset-ids.json` with all asset IDs needed for embedding.
#### 0d. Body Image Embedding Note
⚠️ **IMPORTANT:** Stat snapshot pages contain markdown tables, which prevent the automated `markdown-to-richtext` script from running. For these pages:
**Option A: Manual Embedding in Contentful**
1. Create/update the resource entry with text-only bodyContent first
2. After publishing, open the entry in Contentful web app
3. Position cursor where image should appear
4. Insert → Embedded Asset → Select the uploaded image
5. Republish
**Option B: Direct RichText Manipulation**
1. Get the existing entry's bodyContent
2. Insert `embedded-asset-block` nodes at the correct positions:
```json
{
"nodeType": "embedded-asset-block",
"data": {
"target": {
"sys": {
"id": "ASSET_ID_HERE",
"type": "Link",
"linkType": "Asset"
}
}
},
"content": []
}
```
3. Update the entry with modified bodyContent
**Option C: For Non-Table Pages Only**
If the markdown has no tables, use the standard workflow:
```bash
npm run markdown-to-richtext -- "drafts/file.md" "drafts/images/slug/asset-ids.json"
```
**Do not proceed to Step 1 without all images uploaded.**
### Step 1: Create Statistics (3 entries)
1. Go to Content → Add Entry → Statistic
2. Fill in `number` and `statisticText`
3. Save (don't publish yet)
4. Repeat for all 3 stats
### Step 2: Create Statistic Group (1 entry)
1. Go to Content → Add Entry → Statistic group
2. Fill in `title` (internal reference name)
3. Add links to your 3 statistic entries
4. Save (don't publish yet)
### Step 3: Create Resource Entry
1. Go to Content → Add Entry → Resource
2. Fill in all fields:
- `title`: Full title with quarter
- `slug`: Evergreen URL
- `shortDescription`: Brief summary
- `headerImage`: Upload hero image
- `resourceDate`: Publish date
- `resourceType`: "Insights"
- `bodyContent`: See below
- `seoDescription`: Meta description
### Step 4: Build bodyContent
1. Click into bodyContent RichText field
2. **FIRST:** Insert → Embed Entry → Select your statisticGroup
3. **THEN:** Add text content below the embedded statisticGroup
4. Use H2 headings for each section
5. Add internal links using Insert → Link → Link to Entry (for Contentful pages) or Insert → Link → URL (for external)
6. Format lists with bullet points
### Step 5: Publish All Entries
Publish in this order:
1. All 3 `statistic` entries
2. The `statisticGroup` entry
3. The `resource` entry
---
## AI Content Scrubbing (MANDATORY)
**Every draft must be scrubbed for AI telltale signs before publishing.** This is non-negotiable.
### Emdash Removal (CRITICAL)
**NEVER use emdashes (—) in any content.** They are a dead giveaway of AI-generated text.
**Replace emdashes with:**
- Commas
- Parentheses
- Colons
- Periods (split into separate sentences)
**Examples:**
❌ **BAD (emdash):**
> Streaming platforms—like Hulu and Roku—have changed everything about TV advertising.
✅ **GOOD (commas):**
> Streaming platforms, like Hulu and Roku, have changed everything about TV advertising.
✅ **GOOD (parentheses):**
> Streaming platforms (like Hulu and Roku) have changed everything about TV advertising.
❌ **BAD (emdash):**
> The shift is significant—and it's accelerating.
✅ **GOOD (period):**
> The shift is significant. And it's accelerating.
### Words and Phrases to Remove/Replace
| AI Telltale | Replace With |
|-------------|--------------|
| Delve | explore, dig into, look at |
| Landscape | market, space, industry, world |
| Leverage | use, take advantage of, apply |
| Robust | strong, solid, comprehensive |
| Seamless/seamlessly | smooth, easy, without friction |
| Tapestry | (don't use at all) |
| Utilize | use |
| Myriad | many, lots of, plenty of |
| Realm | area, space, field |
| Embark | start, begin, get going |
| Paradigm | model, approach, way |
| Comprehensive (overused) | (be specific about what's included) |
| Significant | (use specific numbers instead) |
| It's important to note that | (just state the thing) |
| It's worth mentioning that | (just mention it) |
| In conclusion | (just conclude naturally) |
| To summarize | (just summarize) |
| Game-changer | (describe the actual impact) |
| Navigate (non-literal) | handle, work through, figure out |
| Pivotal | important, key, crucial |
| Paramount | critical, essential, most important |
| Plethora | many, lots of |
| Nuanced | (be specific about what's complex) |
| Resonate | connect, appeal to |
| Synergy | (don't use) |
### Sentence Patterns to Fix
**Too many sentences starting with "This" or "It":**
> ❌ This represents a major shift. This is driven by cord-cutting. It's creating new opportunities.
> ✅ The numbers represent a major shift, driven by cord-cutting and creating new opportunities for advertisers.
**Overly parallel structure (every sentence same rhythm):**
> ❌ YouTube leads with 10.6%. Netflix follows with 7.9%. Hulu trails with 2.6%.
> ✅ YouTube leads the pack at 10.6%, with Netflix a distant second at 7.9%. Hulu rounds out the top three at 2.6%.
**Excessive hedging:**
> ❌ It's worth noting that YouTube's share has grown. It's important to consider that this represents a shift.
> ✅ YouTube's share has grown significantly, representing a fundamental shift in how Americans watch TV.
**Generic conclusions:**
> ❌ In conclusion, these trends show that streaming is growing and businesses should consider advertising.
> ✅ The data is clear: streaming has become the default way Americans watch TV, and small businesses finally have a seat at the table.
### Punctuation Red Flags
| Red Flag | Fix |
|----------|-----|
| Emdashes (—) | Replace with commas, parentheses, periods, or colons |
| Excessive semicolons | Break into separate sentences |
| Overuse of colons before lists | Vary sentence structure |
| Multiple exclamation points | Remove or reduce to one (sparingly) |
### Content Authenticity Check
After scrubbing, ask yourself:
- [ ] Would a real marketing expert say this exactly this way?
- [ ] Are there specific, concrete details or just generic statements?
- [ ] Does it sound like it was written for THIS audience or any audience?
- [ ] Read it aloud: Does it sound natural or stilted?
- [ ] Is there any phrase that makes you cringe as "obviously AI"?
### AI Scrubbing Workflow
1. **Write the draft** (AI-assisted is fine)
2. **Search for emdashes** (Cmd+F for "—") and replace ALL of them
3. **Search for AI telltale words** (delve, landscape, leverage, etc.)
4. **Read aloud** and fix anything that sounds unnatural
5. **Check sentence variety** (vary length and structure)
6. **Remove hedging phrases** ("it's important to note", "it's worth mentioning")
7. **Final read** as if you're a skeptical reader
---
## Voice & Tone Reminders
Even data-focused content should feel accessible:
- **Conversational:** "Here's the thing..." not "It should be noted..."
- **Concrete:** Specific numbers, not "significant growth"
- **Optimistic:** Frame as opportunity for SMBs
- **Concise:** Every word earns its place
- **No emdashes:** Use commas, parentheses, or periods instead
**Good:**
> YouTube commands over 10% of all TV viewing. That's a massive audience you can now reach without a massive budget.
**Bad:**
> It is important to note that YouTube has achieved a significant market share in the television viewing landscape.
**Bad (emdash):**
> YouTube—the world's largest streaming platform—has achieved significant market share.
**Good (no emdash):**
> YouTube, now the world's largest streaming platform, commands over 10% of all TV viewing.
+
+ ---
+
+ > **Merged from `strategy/stat-snapshot-qc-checklist.md`** during the Library consolidation (2026-07-05). The source document is archived; this is now the canonical home for its content.
+
+ # Stat Snapshot QC Checklist
+
+ > **⛔ MANDATORY: No stat snapshot post may be published until ALL items below are verified and checked off.**
+
+ This checklist must be completed for EVERY stat snapshot post BEFORE publishing to Contentful. Do not skip any items. If a post fails any check, fix it before proceeding.
+
+ ---
+
+ ## Pre-Writing Verification
+
+ Complete these BEFORE drafting:
+
+ - [ ] **Slug availability confirmed** via `npm run check-slug -- "slug-here"`
+ - [ ] **Primary source identified** with working URL
+ - [ ] **3+ supporting sources** gathered with URLs
+ - [ ] **Sitemap fetched** via firecrawl_map for internal links
+
+ ---
+
+ ## Word Count Verification (HARD REQUIREMENT)
+
+ **⛔ MINIMUM: 3,000 words. Target: 3,000-4,000 words.**
+
+ Run this command and record the result:
+
+ ```bash
+ wc -w drafts/stat-snapshots/YYYY-MM-DD-slug.md
+ ```
+
+ **Word count: _______ words**
+
+ | Result | Action |
+ |--------|--------|
+ | ❌ Under 3,000 | **STOP. Do not publish. Expand content.** |
+ | ⚠️ 3,000-3,200 | Borderline. Consider expanding to be safe. |
+ | ✅ 3,200+ | Proceed to next checks. |
+
+ ---
+
+ ## Required Sections (All 11 Must Be Present)
+
+ Verify each section exists AND meets minimum word count:
+
+ | # | Section | Min Words | Present? | Word Count |
+ |---|---------|-----------|----------|------------|
+ | 1 | Opening paragraph | 150 | [ ] | _____ |
+ | 2 | What the data shows | 500 | [ ] | _____ |
+ | 3 | Breaking down the numbers | 400 | [ ] | _____ |
+ | 4 | Why it matters for your business | 400 | [ ] | _____ |
+ | 5 | How to take advantage | 400 | [ ] | _____ |
+ | 6 | The bigger picture | 350 | [ ] | _____ |
+ | 7 | What experts are saying | 250 | [ ] | _____ |
+ | 8 | Common questions answered | 400 | [ ] | _____ |
+ | 9 | Supporting data | 200 | [ ] | _____ |
+ | 10 | CTA section | 100 | [ ] | _____ |
+ | 11 | Statistics boxes (3 stats) | N/A | [ ] | N/A |
+
+ **If ANY section is missing or under minimum, STOP and add content.**
+
+ ---
+
+ ## Image Requirements (HARD REQUIREMENT)
+
+ **⛔ MINIMUM: 4 images (1 hero + 3 body)**
+
+ | Image | Type | Filename | Uploaded? | Asset ID |
+ |-------|------|----------|-----------|----------|
+ | Hero | Scrapbook | hero.png | [ ] | _________ |
+ | Body 1 | Chart | _________.png | [ ] | _________ |
+ | Body 2 | Chart | _________.png | [ ] | _________ |
+ | Body 3 | Concept | _________.png | [ ] | _________ |
+ | Body 4 (opt) | Chart | _________.png | [ ] | _________ |
+
+ **Image QC:**
+ - [ ] All images generated at 1344x768px (16:9)
+ - [ ] All text in images reviewed at 100% zoom for typos
+ - [ ] Brand colors used: Navy (#222239), Teal (#57b4ad), Lime (#d7df27)
+ - [ ] All images uploaded via `npm run upload-images`
+ - [ ] `asset-ids.json` generated
+
+ ---
+
+ ## Source Citation Requirements (HARD REQUIREMENT)
+
+ **⛔ Every statistic MUST have a source link. No exceptions.**
+
+ | Check | Status |
+ |-------|--------|
+ | [ ] Opening paragraph includes linked source |
+ | [ ] Every percentage has a source link |
+ | [ ] Every dollar amount has a source link |
+ | [ ] Every market trend claim has a source link |
+ | [ ] Supporting data section: ALL bullets have sources |
+ | [ ] Sources table completed at bottom of draft |
+
+ **Source count: _____ (Minimum: 5 unique sources)**
+
+ ---
+
+ ## Internal Link Requirements (HARD REQUIREMENT)
+
+ **⛔ MINIMUM: 8 internal links. Target: 10-12.**
+
+ List all internal links:
+
+ | # | Anchor Text | URL | Section |
+ |---|-------------|-----|---------|
+ | 1 | | | |
+ | 2 | | | |
+ | 3 | | | |
+ | 4 | | | |
+ | 5 | | | |
+ | 6 | | | |
+ | 7 | | | |
+ | 8 | | | |
+ | 9 | | | |
+ | 10 | | | |
+ | 11 | | | |
+ | 12 | | | |
+
+ **Total internal links: _____ (Minimum: 8)**
+
+ ---
+
+ ## AI Content Scrubbing (REQUIRED)
+
+ Run these searches and confirm ZERO matches:
+
+ | Search Term | Found? | Action |
+ |-------------|--------|--------|
+ | `—` (emdash) | [ ] None | Replace with comma, parentheses, or period |
+ | `delve` | [ ] None | Replace with "explore," "dig into," "look at" |
+ | `landscape` | [ ] None | Replace with "market," "space," "industry" |
+ | `leverage` | [ ] None | Replace with "use," "take advantage of" |
+ | `robust` | [ ] None | Replace with "strong," "solid" |
+ | `seamless` | [ ] None | Replace with "smooth," "easy" |
+ | `utilize` | [ ] None | Replace with "use" |
+ | `myriad` | [ ] None | Replace with "many," "lots of" |
+ | `it's important to note` | [ ] None | Just state the thing |
+ | `it's worth mentioning` | [ ] None | Just mention it |
+ | `In conclusion` | [ ] None | Conclude naturally |
+
+ ---
+
+ ## Statistics Boxes Verification
+
+ | Stat | Number | Text | Entry Created? | Published? |
+ |------|--------|------|----------------|------------|
+ | Stat 1 | | | [ ] | [ ] |
+ | Stat 2 | | | [ ] | [ ] |
+ | Stat 3 | | | [ ] | [ ] |
+ | Statistic Group | | | [ ] | [ ] |
+
+ **Statistic Group ID: _____________**
+
+ ---
+
+ ## Readability & List Usage (HARD REQUIREMENT)
+
+ **⛔ MINIMUM: 3 lists per post. Target: 4-6 lists.**
+
+ Dense prose without visual breaks hurts readability. Every post MUST include lists to improve scannability.
+
+ ### ⛔ Mandatory List Check (Do This First)
+
+ Before publishing, verify lists in these HIGH-PRIORITY sections:
+
+ | Section | Has List? | If No List, Why? |
+ |---------|-----------|------------------|
+ | **Breaking down the numbers** | [ ] Yes / [ ] No (needs justification) | _____________ |
+ | **How to take advantage** | [ ] Yes / [ ] No (needs justification) | _____________ |
+ | **Supporting data** | [ ] Yes (REQUIRED) | N/A (always a list) |
+
+ **⚠️ If "Breaking down the numbers" or "How to take advantage" has NO list, you must justify why prose is better for that specific content. Dense data or action steps almost ALWAYS need lists.**
+
+ ### Additional List Opportunities
+
+ Check these sections for additional list opportunities to reach 4-6 total:
+
+ - [ ] "What the data shows" — platform comparisons (if 4+ platforms)
+ - [ ] "Why it matters" — industry applications (if 3+ examples)
+ - [ ] "The bigger picture" — future predictions (if 3+ items)
+
+ ### List Verification Table
+
+ | # | Section | List Type | Items | Purpose |
+ |---|---------|-----------|-------|---------|
+ | 1 | Supporting data | Unordered | _____ | Quick-reference stats |
+ | 2 | | | | |
+ | 3 | | | | |
+ | 4 | | | | |
+ | 5 | | | | |
+ | 6 | | | | |
+
+ **Total lists: _____ (Minimum: 3, Target: 4-6)**
+
+ ### List Format Rules
+
+ - **Bold lead-in phrase** for each item: `- **Key point:** Explanation here`
+ - **3-7 items per list** (8+ should be reconsidered or split)
+ - **Parallel structure** (all items start same way: verb, noun, etc.)
+ - **1-2 sentences max** per list item
+ - **Ordered lists** for sequential/step-based content
+ - **Unordered lists** for non-sequential parallel items
+
+ ---
+
+ ## Content Quality Checks
+
+ - [ ] **Read aloud test:** Content sounds natural, not robotic
+ - [ ] **Sentence variety:** Not all sentences start with "This" or "It"
+ - [ ] **Readability:** 3+ lists breaking up dense prose where content calls for it
+ - [ ] **No generic statements:** Specific data with specific sources
+ - [ ] **Adwave mentions:** 2-3 natural mentions (not forced)
+ - [ ] **CTA present:** Clear call-to-action with /how-it-works and /pricing links
+
+ ---
+
+ ## Final Pre-Publish Verification
+
+ Before creating the Contentful resource entry:
+
+ - [ ] Word count verified: _____ words (min 3,000)
+ - [ ] All 11 sections present and substantive
+ - [ ] 4+ images uploaded with asset IDs recorded
+ - [ ] 8+ internal links included
+ - [ ] 5+ source citations with working links
+ - [ ] **3+ lists for readability** (where content calls for them)
+ - [ ] AI content scrubbed (zero flagged terms)
+ - [ ] Statistics entries created and published
+ - [ ] Statistic Group created and published
+
+ ---
+
+ ## Contentful Entry Creation
+
+ | Field | Value | Verified? |
+ |-------|-------|-----------|
+ | title | | [ ] |
+ | slug | | [ ] |
+ | shortDescription | | [ ] |
+ | headerImage | Asset ID: | [ ] |
+ | resourceDate | YYYY-MM-DD | [ ] |
+ | resourceType | Insights | [ ] |
+ | bodyContent | RichText built | [ ] |
+ | seoDescription | | [ ] |
+
+ ---
+
+ ## Post-Publish Verification
+
+ After publishing:
+
+ - [ ] Entry published successfully (Entry ID: _________)
+ - [ ] Calendar updated with Entry ID, status, word count, and image count
+ - [ ] Live URL verified: https://adwave.com/resources/[slug]
+
+ ---
+
+ ## Sign-Off
+
+ **This post has been verified against all QC requirements.**
+
+ | Item | Confirmed |
+ |------|-----------|
+ | Word count ≥ 3,000 | [ ] |
+ | All 11 sections present | [ ] |
+ | 4+ images embedded | [ ] |
+ | 8+ internal links | [ ] |
+ | 5+ source citations | [ ] |
+ | 3+ lists for readability | [ ] |
+ | AI content scrubbed | [ ] |
+ | Statistics created | [ ] |
+
+ **Date completed:** ____________
+
+ **Entry ID:** ____________
+
+ ---
+
+ ## Quick Reference: Common Failures
+
+ | Failure | Prevention |
+ |---------|------------|
+ | Word count under 3,000 | Check `wc -w` BEFORE publishing. Expand thin sections. |
+ | Missing sections | Use template. Verify all 11 sections exist. |
+ | Unsourced statistics | Never include a number without a source link. |
+ | AI telltale language | Run search for flagged terms before publishing. |
+ | Insufficient images | Generate all 4+ images before starting Contentful entry. |
+ | Too few internal links | Fetch sitemap first. Plan 8-12 links during outline. |
+ | **Too few lists (dense text)** | Include 3+ lists where content calls for them (data comparisons, steps, features). |
+
+ ---
+
+ ## Enforcement
+
+ **This checklist is MANDATORY, not optional.**
+
+ - Do NOT proceed to Contentful entry creation until all checks pass
+ - Do NOT publish entries that fail any verification
+ - If time constraints exist, delay publication rather than publish non-compliant content
+ - Quality over speed: A delayed compliant post beats a fast non-compliant one
+
+ ---
+
+ ## Template Usage
+
+ Copy this checklist for each new post:
+
+ ```
+ ## QC Checklist: [Post Title]
+
+ **Slug:** `[slug]`
+ **Date:** [YYYY-MM-DD]
+
+ ### Pre-Writing
+ - [ ] Slug available
+ - [ ] Primary source identified
+ - [ ] 3+ supporting sources
+ - [ ] Sitemap fetched
+
+ ### Word Count
+ **Result:** _____ words
+ - [ ] ≥ 3,000 words
+
+ ### Sections (all 11)
+ - [ ] Opening (150+)
+ - [ ] What the data shows (500+)
+ - [ ] Breaking down (400+)
+ - [ ] Why it matters (400+)
+ - [ ] How to take advantage (400+)
+ - [ ] Bigger picture (350+)
+ - [ ] Experts saying (250+)
+ - [ ] Questions answered (400+)
+ - [ ] Supporting data (200+)
+ - [ ] CTA (100+)
+ - [ ] Statistics boxes
+
+ ### Images (4+ total)
+ - [ ] Hero uploaded
+ - [ ] Body 1 uploaded
+ - [ ] Body 2 uploaded
+ - [ ] Body 3 uploaded
+ - [ ] All text verified
+
+ ### Sources (5+ unique)
+ - [ ] Opening paragraph sourced
+ - [ ] All stats sourced
+ - [ ] Supporting data sourced
+
+ ### Internal Links (8+)
+ **Count:** _____
+ - [ ] ≥ 8 internal links
+
+ ### Readability & Lists (3+ total, target 4-6)
+ **Count:** _____
+ - [ ] "Breaking down the numbers" has a list (or justified why not)
+ - [ ] "How to take advantage" has a list (or justified why not)
+ - [ ] "Supporting data" has a list (REQUIRED)
+ - [ ] At least 3 lists total for readability
+
+ ### AI Scrubbing
+ - [ ] Zero emdashes
+ - [ ] Zero flagged words
+
+ ### Statistics
+ - [ ] 3 stats created
+ - [ ] Statistic group created
+
+ ### Final
+ - [ ] All checks passed
+ - [ ] Entry published
+
+ **Entry ID:** ____________
+ ```
+ Version history
- v2 · 7/5/2026, 6:30:28 PM · Library consolidation: merged stat-snapshot-qc-checklist.md into this document; repointed stale references
- v1 · 6/20/2026, 3:11:54 AM · migration import