Getting started

Budgets, goals and alerts

Set monthly media budget targets for a client workspace, track pacing, record the client's KPIs and goals, and create alerts that post to Slack or email.

When a workspace's sources are connected, tell Maven what the client is aiming for. Monthly media budget targets drive pacing: spend to date, projected month-end spend, and over- or under-pacing flags. KPIs and goals go into the workspace's agent context, so reports use the client's own definitions. Alerts watch a metric and tell you in Slack or email when it crosses a line.

Set media budget targets#

Budget targets are monthly amounts per ad platform. You can also set them for individual campaigns, ad groups (Meta ad sets) or ads.

Choose the budget type#

Each workspace has one Budget type. It decides what the budget means and which spend pacing compares with it:

Budget typeUse it whenThe budget isPacing compares it with
Fee on top (default)You charge your agency fee on top of mediaAd cost only (Ad cost target)Spend before commission
Fee includedYour fee comes out of the client's budgetThe client's total (Budget incl. agency fee)Spend including the fee
Just a budgetThe workspace is not an agency client, so there is no feeThe budgetSpend

With Fee included, spend including the fee is spend ÷ (1 − commission % ÷ 100), worked out per platform with that platform's Commission % for the month. A platform with no commission counts at spend. Just a budget hides commission in the budget editors and leaves it out of pacing; any rates you entered before are kept, so switching back restores them.

The budget type is a workspace setting, not part of the monthly budgets. To change it, select the workspace, open Workspace > Profile under Setup in the sidebar, pick an option in Budget type, then select Save budget type. Only workspace admins can change it; everyone else sees it read-only. The new type applies to every month at once. The budget editors show the current type with a link to this setting.

Enter targets#

You can set targets in three ways.

In Maven. On Pacing, select Edit budgets (or Set budgets). Enter each channel's amount for the month and, unless the type is Just a budget, its Commission %.

From Claude or ChatGPT. Ask for it in plain English, for example "Set the Google Ads budget for December to $12,000 for Acme". The assistant uses the workspace tool's set_media_budgets operation. Maven first shows a before-and-after plan of the changes. Nothing is saved until you approve that exact plan. See Connect your AI tools.

In a pacing report. If a client's report includes budget pacing, it has a Media Budget page next to Pacing:

  1. Open the report and select Media Budget.
  2. Pick the Year.
  3. For each platform and month, enter the target. With Fee on top it's the Ad cost target, and an optional Commission % shows Spend with commission. With Fee included it's the Budget incl. fee, and the Commission % shows the Ad cost after fee. With Just a budget there is only the Budget.
  4. Select Save year.

When it saves, Maven shows "Saved to the governed media budget table. Pacing refreshed."

Track pacing#

Pacing compares each month's spend with its targets: spend to date, pace, projected month-end spend, and flags for platforms that are over or under. Spend follows the workspace's budget type: with Fee included, the spend that Pacing and your AI assistant's pacing answers compare with the budget includes the agency fee, and Maven labels it that way. Cross-client pacing tables and budget alerts still compare spend before commission. Ask your AI assistant "How is Acme pacing this month?" and it reads the workspace's pacing. Budget pacing is also part of the daily brief.

Maven doesn't flag projections until it has at least 3 days of spend data for the month. If a platform has spend but no target, or a target but no spend yet, pacing says so instead of guessing.

Record KPIs and goals#

Maven has no separate goals form. Record the client's KPIs and goals in the workspace's agent context instead:

  1. Open Settings from the user menu, then Workspace.
  2. In Agent context, use Tell the agent anything to write the goals and how they're defined, for example "Primary KPI is cost per qualified lead; target under $85".
  3. Select Save context.

Maven keeps your words exactly. It also maintains a read-only Priority KPIs fact under What the agent knows. See Create a client workspace.

Create an alert#

Alerts are on the Scheduled page, on its Alerts tab.

  1. Select New alert and choose the Workspace.
  2. Describe what you want to watch, for example "Warn me when ROAS drops below 2 for 3 days in a row", and select Draft my alert.
  3. Maven drafts the rule and replays it over the workspace's history. You see when it Would have fired, the Fire dates, and What it will say when it fires.
  4. Adjust the rule if you need to. You can set the Severity, how often to Check (Daily or Hourly), the Metric, and when it Fires when. Budget alerts take a Budget ($), a Period and an Alert at (%) threshold. Anomaly alerts use a Deviation from rolling average (%), and flatline alerts use Consecutive flat days.
  5. Choose where it goes: Slack (optionally with a webhook URL), Email, or both.
  6. Select Set live.

You can also create and preview alerts from your AI assistant with the notification tool. See the MCP overview.

Last updated 2026-11-12