feat: add campaign brief documentation and examples #66
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
- Add brief-expectations to navigation under Core Concepts - Create comprehensive example-briefs.md with realistic campaign briefs - Include minimal, standard, and comprehensive brief examples - Cover various industries: retail, B2B, automotive, financial services, healthcare, streaming, mobile apps - Demonstrate proper brief structure at different quality levels 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]>
Based on expert feedback: - Reduced to 4 core annotated examples with clear learning progression - Added realistic metrics and budgets for each industry vertical - Included AdCP-specific workflow language showing protocol integration - Added annotations explaining why each brief works - Included publisher response predictions for each example - Added industry quick-reference section with compliance considerations - Included brief evaluation checklist for self-assessment - Improved technical specifications (asset sizes, formats, etc.) - Added phased campaign execution example for complex scenarios 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]>
- All examples now use proper "brief" field with natural language content - Removed non-existent structured JSON fields (objectives, target_audience, etc.) - Examples now match actual AdCP schema where everything is in the brief text - Maintained all the realistic metrics and detailed campaign information - Kept annotations explaining why each brief works and publisher responses 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]>
…tails - Briefs now focus solely on audience-enabled media buying - Removed all creative specifications, asset requirements, and technical specs - Removed attribution models, measurement vendor details, and implementation specifics - Added "What NOT to Include in Briefs" section for clarity - Simplified examples to show WHO to reach and WHAT outcome to drive - Made it clear that creative is handled via sync_creatives, not briefs - All examples now properly demonstrate audience targeting strategies 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]>
…d geography - All briefs now include creative format preferences (display, video, CTV, etc.) - Every brief specifies country/geographic markets and currency - Rewrote briefs to describe customers naturally rather than prescribe targeting - Added "Let Publishers Add Value" guidance to encourage flexibility - Emphasized describing customer situations, values, and behaviors - Made it clear publishers should suggest targeting approaches - Kept focus on WHO (customers) and WHAT (outcomes) with HOW (formats) 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Changes
sidebars.tsto include both brief-expectations and example-briefs in the Media Buy > Core Concepts sectiondocs/media-buy/example-briefs.mdwith:Test plan
🤖 Generated with Claude Code