Skip to content

docs: add Media Buy Lifecycle Flow page with state diagram and PG deal variation#3354

Draft
bokelley wants to merge 2 commits intomainfrom
claude/issue-2570-media-buy-lifecycle-page
Draft

docs: add Media Buy Lifecycle Flow page with state diagram and PG deal variation#3354
bokelley wants to merge 2 commits intomainfrom
claude/issue-2570-media-buy-lifecycle-page

Conversation

@bokelley
Copy link
Copy Markdown
Contributor

Summary

  • New page docs/media-buy/media-buys/lifecycle.mdx — the canonical "what's the sequence?" reference for builders asking about media buy lifecycle, creative sync timing, PG deals, and SSP integration patterns (~75 Addie questions/week, no single page to point to)
  • Covers all 5 AC items from docs: Media Buy Lifecycle page with state diagram and PG variation #2570:
    • Sequenced flow diagram (Mermaid flowchart): get_productscreate_media_buysync_creatives → delivery
    • Full state machine (stateDiagram-v2): all 7 states with every allowed transition
    • Guaranteed/PG deal variation: IO acceptance path, accountability_terms required fields, makegoods
    • Creative sync timing: inline vs deferred, creative_deadline hierarchy (package > media buy), CREATIVE_REJECTED, library persistence after terminal state
    • See also links to all related pages
  • Nav entry added in both navigation tabs (buyer quickstart and seller nav)
  • Quickstart "What's next" section linked
  • sales-agent-creative-capabilities.mdx Related section linked

Test plan

  • Page renders at /docs/media-buy/media-buys/lifecycle
  • Both Mermaid diagrams render (standard flow + PG variation)
  • State machine stateDiagram-v2 renders without errors
  • All internal links resolve (index, task-reference pages, accountability, creative-libraries anchor)
  • Page appears in both nav tabs under Media Buys

Closes #2570.

https://claude.ai/code/session_01HULrqPhn8kLM76nSmcpj4d


Generated by Claude Code

claude added 2 commits April 27, 2026 11:33
…ookup_key aliases

When the LLM passes an aliased lookup_key (e.g. explorer_annual instead of
aao_membership_explorer_50), create_payment_link/send_invoice/confirm_send_invoice
now include did_you_mean: canonicalKey in the JSON response so the model learns
the canonical key for subsequent calls in the same conversation.

Also tightens the three tool descriptions to explicitly forbid constructing the
key from tier name and billing interval. Bumps CODE_VERSION to 2026.04.6.

Closes #2550

https://claude.ai/code/cse_01HULrqPhn8kLM76nSmcpj4d
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: Media Buy Lifecycle page with state diagram and PG variation

2 participants