Guide
Campaigns and approvals
Follow the state changes from audience brief to reconciled delivery, with explicit boundaries around spending.
Plan
A persona preserves requested demographics, interests, intent, geography and exclusions. Each channel compilation shows represented and unsupported constraints, modeled catalogue evidence and the need for provider validation.
A plan combines channel budgets, flight and forecast assumptions. Money in the REST API uses integer minor units. MCP convenience fields named budgetPounds or amountPounds are converted by deterministic code; the tool contract records that mapping.
Unknown geographic population stays unknown. A reach upper bound is not a verified audience size, and a contextual proxy is not proof of audience membership.
Approve an exact action
Prepare the intended action and retain its returned snapshot and digest. Request a human review of the exact creative, targeting, budget, flight and effect.
A permitted human resolves the request. The agent reads the approval, advances the run and creates its execution step. It then calls the requested operation with both execution headers. The MCP tool fields map to these headers automatically.
x-chorus-agent-step-id: <returned execution step ID>
x-chorus-agent-action-digest: <approved action digest>Book or stage
| Path | Meaning |
|---|---|
| Managed booking | A retained order and media commitment enter a 12-hour supplier confirmation window. A human records the actual supplier outcome. |
| Native staging | Supported native clients create spend-disabled provider objects and retain exact account, configuration and creative references. |
| Creative review | Approval applies to the exact asset bytes, copy and destination. Changed content invalidates that evidence. |
| Resume | A separate approved operation validates the retained provider hierarchy before enabling spend. |
Measure and close
Delivery, response, causal lift and brand-lift evidence are distinct outputs. Modeled reach remains labeled, and underpowered lift studies are refused.
A successful pause does not immediately release money. Reports must reconcile through the stopping boundary; controlled native buys also require matching provider-spend evidence.
Never-enabled staged campaigns have a human-attested zero-delivery cancellation path. Ambiguous provider outcomes enter reconciliation and are never automatically treated as failed.