Skip to content

docs: add AdCP vs RTB one-minute explainer page#3384

Closed
bokelley wants to merge 1 commit into
mainfrom
claude/issue-2573-adcp-vs-rtb-comparison
Closed

docs: add AdCP vs RTB one-minute explainer page#3384
bokelley wants to merge 1 commit into
mainfrom
claude/issue-2573-adcp-vs-rtb-comparison

Conversation

@bokelley

Copy link
Copy Markdown
Contributor

Closes #2573

Adds a top-of-funnel "AdCP vs RTB" comparison page at /docs/adcp-vs-rtb, driven by Addie weekly insights showing ~90 foundational "What is AdCP / how does it differ from RTB?" questions per week. The existing adcp-vs-openrtb.mdx targets implementers; this page targets the pre-enrollment, discovery-mode audience.

Changes

  • docs/adcp-vs-rtb.mdx — new one-minute explainer: 4-row comparison table, "how they fit together" section (before/after the auction framing), inline FAQ (no accordions so the content is skim-visible), Academy Basics + Ask Addie CTAs
  • docs.json — nav entry in both 3.0 and latest version groups, immediately after docs/intro
  • docs/intro.mdx — Card added to "Where do you want to start?" CardGroup (updated to cols={3})
  • docs/building/understanding/adcp-vs-openrtb.mdx<Note> cross-link callout at the top routing discovery-mode readers to the new page
  • .changeset/adcp-vs-rtb-comparison-page.md — empty changeset (docs-only, no protocol impact)

Non-breaking justification

Adds new MDX page and nav entries; no existing pages or schema fields modified in a breaking way. Homepage card and technical-page cross-link are purely additive.

Pre-PR review

  • code-reviewer: approved — no CI-impacting blockers; nits surfaced: og:title redundancy (fixed), pronoun agreement (fixed), cols={2}→cols={3} orphan card (fixed), TMP link path convention (fixed)
  • docs-expert: approved — factual accuracy confirmed against FAQ and technical page; "layers" framing replaced with "before/after the auction" throughout; "Scope"+"Operations" table row overlap resolved by collapsing to "What it handles"; Note callout framing updated from "short version" to audience-routing

Nits surfaced (not fixed — for reviewer awareness):

  • "Academy Basics (free)" card title uses parenthetical — can remove (free) qualifier if preferred
  • <Note> on adcp-vs-openrtb.mdx uses "coming from real-time bidding" — reviewers may prefer different phrasing

Triage-managed PR. This bot does not currently iterate on
review comments or PR conversation threads (only on the source
issue). To unblock:

  • Push fixup commits directly: gh pr checkout <num>
    fix → push.
  • Or re-trigger: comment /triage execute on the source
    issue.

See #3121
for context.

Session: https://claude.ai/code/cse_01HULrqPhn8kLM76nSmcpj4d


Generated by Claude Code

Add top-of-funnel comparison page at /docs/adcp-vs-rtb for discovery-mode
readers who know RTB and want to understand how AdCP fits alongside it.

Driven by Addie weekly insights showing ~90 such questions per week. The
existing adcp-vs-openrtb.mdx targets implementers; this page targets the
pre-enrollment audience.

https://claude.ai/code/cse_01HULrqPhn8kLM76nSmcpj4d
@bokelley bokelley added the claude-triaged Issue has been triaged by the Claude Code triage routine. Remove to re-triage. label Apr 28, 2026
@bokelley

Copy link
Copy Markdown
Contributor Author

Closing — the data behind this PR doesn't hold up.

The "~90 foundational AdCP-vs-RTB questions per week" cited in #2573 is an LLM-extrapolated theme.count from server/src/addie/services/conversation-insights-builder.ts (the prompt at line 354, 363 explicitly asks Claude to estimate frequency across all threads from a sample), and the sample is biased toward escalations and low ratings (line 254-257). It is not a SQL count.

I queried the prod admin API for all Apr 11–18 threads matching "rtb" anywhere in message content (the exact window #2573 cites) — 103 threads. Of those:

Count First user message Source
22 Start module A1 Sage Academy curriculum CTA
14 What is AdCP and how does it work? chat.html welcome button "Learn about AdCP"
13 What can you do? What kinds of things can I ask you about? chat.html welcome button
12 How is agentic advertising different from programmatic, and why does it matter? chat.html welcome button "AdCP vs programmatic"
10 I'd like to start learning AdCP in the Academy… Academy CTA
3 Start module A2/A3/B1 Sage curriculum

72% (74 of 103) start with a canned CTA chip, not a typed question. The CTA chips are at server/public/chat.html:2547-2552. "rtb" matched in those threads because Addie/Sage mentions OpenRTB/RTB in its response, not because the user asked.

Of the 28% (29) genuinely typed messages, only a handful are anywhere near "AdCP vs RTB?" as a discovery question. The rest are mid-curriculum learners or different topics ("how does AdCP compare to IAB AAMP?", "Where does a DSP fit?", "what commercial agreements do I need", etc.).

There is no measurable cohort of pre-enrollment "AdCP vs RTB?" askers leaving without enrolling. The existing docs/building/understanding/adcp-vs-openrtb.mdx plus Sage's A3 module already serve the audiences that actually ask.

Closing this PR. Closing #2573 (the source issue) for the same reason.

Separately filing an issue on the weekly-insights pipeline — including CTA-chip-initiated threads in theme frequency means any homepage button essentially manufactures its own demand signal.

The IAB Tech Lab and AAMP questions are real and recurring, so I tightened the FAQ entries on both in a separate change.

@bokelley

Copy link
Copy Markdown
Contributor Author

Acknowledged — the closure makes sense given the data. The 72% CTA-chip contamination explains why the raw RTB-thread count looked like organic demand; the existing adcp-vs-openrtb.mdx + Sage A3 already cover the audience that actually shows up with the question.

Good catch on the insights pipeline — worth tracking so theme frequencies don't manufacture their own demand signal going forward.

Session: https://claude.ai/code/session_017GN4Ztqi4J9aqeKBAVW1oS


Generated by Claude Code

@bokelley

Copy link
Copy Markdown
Contributor Author

Noted — no action needed here. Closed PR stands.

Triaged by Claude Code. Session: https://claude.ai/code/session_01Qok8hB7ZHv1HCwadpsW51v


Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

claude-triaged Issue has been triaged by the Claude Code triage routine. Remove to re-triage.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

website: AdCP vs RTB 60s explainer / comparison asset

2 participants