>_

SpendSignoff documentation

The always-on operator for your ad accounts. Read and draft from your AI client — approve before anything goes live.

Agent guide

Core campaign workflows

Step-by-step guides for the five recurring ad operations — audit, launch, optimize, report, and monitor — from the first plain-English instruction to an approved live change.

Your AI can read and draft — it can never spend without your approval.

How to read these guides

Each workflow is a sequence of steps: what you type to the agent, what the agent does, and what you do in the SpendSignoff app. The agent handles reads and drafts; you handle approvals.

Exact prompts are shown in code format. You do not need to use the exact wording — the agent responds to natural variations. The prompts here are the most direct form.

Workflow 1 — Audit an account

Run a full read of an account to find wasted spend and pacing issues before making any changes.

1

Start the audit

Type: audit my Google Ads account [account name or ID]. The agent calls list_ad_accounts to confirm the account is linked, then get_account_snapshot for current pacing, then query_entities for campaign and ad set level performance over the trailing 7 days.

2

Read the summary

The agent returns a plain-English summary: campaigns pacing over budget, ad sets with high spend and zero conversions, top performers by ROAS, and any anomalies. No drafts are produced at this step.

3

Drill into a specific area

Follow up with a targeted question: which ad sets in the retargeting campaigns have a cost per purchase above $25? The agent calls query_entities with the specified filter and returns a ranked list.

4

Move to a draft if warranted

If the audit surfaces an obvious fix, continue to Workflow 3 (Optimize) or type a direct change request: propose reducing the budget on [campaign name] by 20%.

Workflow 2 — Launch a campaign

Draft a new campaign from a plain-English brief and route it through the approval queue.

1

Write a brief

Type a brief in plain English: draft a new Meta retargeting campaign for users who viewed the product page in the last 14 days. Daily budget $75. Optimize for add-to-cart. Use the existing lookalike audience named "30-day purchasers."

2

Review the draft diff

The agent calls get_account_snapshot to check existing structure, then propose_change with a typed campaign-create payload. It returns a before-and-after diff: proposed campaign name, objective, targeting parameters, budget, and bid strategy.

3

Check the flagged gaps

If the brief references an audience or creative that does not exist, the agent flags the gap in the diff rather than substituting silently. Resolve flagged gaps in the ad platform UI or revise the brief before approving.

4

Approve in the SpendSignoff app

Open the Approval Queue in the SpendSignoff app. Read the full diff. Click Approve and push live, then Confirm. The API call goes to Meta and the result is recorded in the audit log.

Workflow 3 — Optimize spend

Find high-impact changes and draft the top fixes in one pass.

1

Request an optimization pass

Type: optimize my Meta account — find the three highest-impact budget changes. The agent reads performance across campaigns and ad sets, ranks candidate changes by estimated spend recovery, and drafts the top three.

2

Read the ranked reasoning

Before producing each draft, the agent explains its reasoning in plain English: "Ad set X has spent $340 over 7 days with 0 purchases against a $18 CPA target. Proposed action: pause." You see the reasoning before you see the diff.

3

Review the draft queue

Each proposed change is a separate Draft in the SpendSignoff approval queue. You can approve them in any order, skip some, and reject others without affecting the rest.

4

Approve selectively

For each draft: open the diff in the approval queue, confirm it reflects your intent, and use the two-step Approve and Confirm control. A KMS-signed audit entry is written on each confirmation.

Workflow 4 — Run a performance report

Get a normalized cross-platform spend and ROAS summary for any time range.

1

Request the report

Type: performance report for last week across all accounts. The agent calls query_entities with metric filters for the specified range across both Google Ads and Meta, then applies the cross-platform attribution substrate to compute unified ROAS.

2

Read the output

The report shows total spend, impressions, clicks, conversions, and ROAS per platform and per top-level campaign, plus a narrative paragraph on the key movements. No drafts are produced.

3

Request a comparison

Follow up with: compare to the week before. The agent fetches the prior period from the same substrate and returns a side-by-side delta per metric per platform.

4

Drill into a specific campaign

Type: break down the top Meta campaign by ad set. The agent calls query_entities scoped to the named campaign and returns ad-set-level metrics for the same time range.

Workflow 5 — Monitor for anomalies

Run a point-in-time anomaly check and get plain-English recommended actions.

1

Trigger the check

Type: check for anomalies across all accounts. The agent calls get_account_snapshot and query_entities comparing trailing 24-hour metrics to the 7-day baseline for each linked account.

2

Read the anomaly list

The agent returns each detected anomaly: entity name, metric name, observed value, baseline value, and recommended action in plain English. If there are no anomalies, it says so explicitly.

3

Draft a fix for a flagged anomaly

Follow up with: draft a fix for the spend spike on campaign X. The agent calls propose_change with the appropriate corrective action and returns a diff for your review in the approval queue.

4

Approve in the SpendSignoff app

Review the draft diff in the SpendSignoff approval queue and confirm via the two-step Approve and Confirm control. The change is applied and the anomaly flag clears on the next sync cycle.

Read and draft only — the agent cannot spend your budget

The SpendSignoff Performance Marketing Agent holds mcp.read and mcp.draft scopes only. It reads account data and produces change drafts. It cannot push a change live. Every live change requires a two-step Approve and Confirm in the SpendSignoff app and is recorded in a KMS-signed append-only audit log.

Chain workflows without starting over

You can move between workflows in the same conversation. Run an audit, ask for an optimization pass, review the proposed drafts, and then ask for a report — all in one session. The agent maintains context across tool calls within the session.

Next

Diagnostic tools

Check token health, draft status, audit log, and sync state when something looks wrong.

    SpendSignoff core campaign workflows — audit, launch, optimize, report, monitor