A marketing plan is the execution side of AI-powered plan generation. It pairs a blueprint's market intelligence with plan-specific inputs - budget, channels, personas, duration - to produce strategy summaries, campaign recommendations, and a full media plan. Plans build on a completed blueprint, so the same intelligence can power several plans with different shapes.
API operations
Relationships
Every plan is created from a blueprint. The blueprint provides market analysis and personas as the foundation. Multiple plans can reference the same blueprint.
Every plan belongs to an advertiser through the blueprint's account association.
campaignBuilder
A ready plan contains campaign builders - AI-recommended campaign configurations with channel types, budgets, targeting, and scheduling. These can be transferred to the DSP for actual campaign creation.
Statuses
processing
Plan is being generated by AI. Sections and campaign builders are not yet available.
ready
Plan generation is complete. All sections and campaign builders are available. Sections can be edited.
transferred
Plan's campaigns have been transferred to the DSP for activation.
deleted
Plan has been deleted.
Key concepts
Budget Mode
Plans can use an AI-recommended budget (omit monthlyBudget) or a user-specified budget. When AI-recommended, the plan response includes aiRecommendedMin, aiRecommendedTarget, and aiRecommendedMax.
Channel Mode
Plans can use AI-recommended channels (omit channels) or specify channels to include/exclude.
Persona Mode
Plans can use all personas from the blueprint (omit personas) or select specific personas by name.
Campaign Builders
AI-generated campaign configurations. Each has a channel type (internet, billboard, tv, audio, or off-AdCritter), budget, targeting, and scheduling. Off-AdCritter campaigns represent advertising on platforms outside AdCritter's DSP.
AI Editing
Plans support AI-powered editing where you provide a natural language prompt and the AI modifies market analysis sections, personas, campaign builders, or executive summary content.
Constraints
⚠Rules to follow
The referenced blueprint must be in 'ready' status before a plan can be created from it.
Plan generation is asynchronous and can take up to 24 hours.
Updates to text sections only work when plan status is 'ready' (otherwise the API returns INVALID_STATE).
Only provided fields are changed on update; omitted fields retain their current values.
Plan sections
A ready plan exposes five viewable sections. Executive summary is a high-level overview with introduction, channel utilization, audience strategy, geographic targeting, and budget. Market analysis is inherited from the blueprint with plan-level customization across seven structured subsections. Personas are inherited from the blueprint and editable at the plan level without affecting the blueprint. Media plan contains the campaign builders (budget allocation, channel type, targeting, scheduling) plus a narrative budget section. Projections covers delivery projections including CPM estimates, impression forecasts, placement categories, and geographic distribution.
When building apps
*Async Generation Polling
Create a plan from a blueprint in 'ready' status, then poll get-plan with exponential backoff until status becomes 'ready' - generation can take up to 24 hours, so don't hold the user on a loading screen. Once ready, review the sections and campaign builders, let the user edit text sections, and offer reset-plan or reset-plan-section to restore AI originals. Spinning up multiple plans from the same blueprint with different budgets, channels, or durations is a good way to let users compare strategies side by side.