campaign
Automate the full lifecycle of ad orders and line items in Google Ad Manager — from draft creation to deployment, updates, pause, archive, and rollback.
Instructions
Orchestrate GAM campaign lifecycle — the primary write surface for creating and managing campaigns.
MODE: write-heavy (most actions modify GAM data) AUTH: OAuth 2.0 required CREDITS: deploy = 2–5 credits depending on line item count. Other write operations = 0.5–1 credit. Reads = 0. CONFIRMATION TOKEN: create_draft, deploy and rollback require a confirmation_token obtained from a prior dry-run preview. This prevents accidental deployment. DEPLOY WORKFLOW: create_draft creates a Firestore campaigns/{campaignId} document from MCP. deploy accepts either campaignId (modern campaigns/{id}) or jobId (legacy jobs/{id}). For direct GAM-only display trafficking, use create_display. OUTPUT: deploy returns {campaign_id, order_id, line_item_ids[], creative_ids[], status}. rollback returns {reverted_to_version, entities_affected}. SIDE EFFECTS: deploy creates Order + LineItems + Creatives + LICAs in GAM — irreversible without rollback. rollback archives the current version and restores the previous one. WHEN TO USE: Use campaign for end-to-end campaign creation from a blueprint. Use line_items or orders for surgical updates to existing campaigns. DESTRUCTIVE: rollback and archive are non-trivial — they modify live GAM entities.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jobId | No | Legacy Firestore jobs/{jobId} document. deploy also accepts modern campaignId. | |
| action | Yes | Sub-operation to perform: • deploy: Deploy a complete campaign to GAM: accepts campaignId from create_draft/REST or legacy jobId, plus confirmation_token. Creates Order, LineItems, Creatives, and LICAs. • create_draft: Create an OrbiAds campaigns/{campaignId} draft from MCP without using the web UI. Write, requires confirmation_token. • update: Update an existing campaign's metadata, budget, or targeting without full redeployment. Write. • ensure_template: Ensure a native ad template exists in GAM, creating it if absent. Idempotent write. • create_native_style: Create a GAM native ad style for use in native campaigns. Write. • create_line_items_batch: Create multiple line items under an existing order in one call. Write. Faster than individual line item creation. • create_licas: Create LineItem-Creative Associations (LICAs) to link creatives to line items. Write. • create_display: Create a standard display ad campaign (order + line items + creatives) from a template. Write, requires confirmation_token. • rollback: Revert a campaign to its previous deployed version. Destructive write — archives current version. Requires confirmation_token. • pause: Pause all active line items in a campaign. Write. • archive: Archive a campaign (order + line items). Destructive — removes from active serving. Requires confirmation_token. | |
| campaign_id | No | OrbiAds campaigns/{campaignId} identifier, accepted by deploy and campaign lifecycle actions. | |
| network_code | No | GAM network code (e.g. 12345678). Required for all network-scoped operations. Obtain via select_gam_network or list_accessible_networks. | |
| confirmation_token | No | Write-confirmation token from a prior estimate/preview call. Required for deploy, rollback, archive. |