adops-campaign

GAM Campaign Lifecycle

Always start by confirming the tenant: call get_my_tenant_id. If unauthenticated, stop and ask the user to run orbiads auth login.

read

Call campaign(action="read", params={campaign_id}).

This returns a live CampaignRecap: order, groups, line items, LICAs, creatives, and targeting assembled from GAM. It is free and performs zero GAM writes.

Use this recap as the source of truth before edit-intents, diagnostics, or resume work. It reflects GAM live state, not a Firestore mirror or previous LLM context that may have drifted.

dry-run

Call campaign(action="dry_run", params={campaign_id}) or campaign(action="dry_run", params={job_id}).

The server returns a signed ExecutionPlan:

{
  operation,
  resourceType: "campaign",
  preview,
  mutations[],
  risks[],
  warnings[],
  estimatedCost,
  confirmationToken,
  expiresIn: 300
}

This step is free and performs zero GAM or Firestore writes. The confirmationToken produced here is consumed by campaign(action="deploy").

Error handling:

• CONFIRMATION_REQUIRED: no token was supplied for execute; re-run dry_run.
• PAYLOAD_MISMATCH: the payload drifted between dry-run and deploy; re-run dry_run.
• TOKEN_EXPIRED: the token is older than 300 seconds; re-run dry_run.

plan-deployment

Call campaign(action="plan_deployment", params={preset, ...}).

Available presets: display_banner, video_vast, video_hosted, audio_vast, audio_hosted, custom_spec. Pass product_id when an ADCP Product should prefill placements, pricing, and formats.

The server returns a signed ExecutionPlan with dry_run=true implied. It is free, and the resulting token is consumed by campaign(action="deploy_media").

deploy-media

Call campaign(action="deploy_media", params={confirmation_token}).

This executes through the unified CampaignPipeline.deploy saga. It costs credits using the same grid as deploy, and it requires a confirmation_token from plan_deployment or dry_run.