# 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.

Source: https://mavendata.ai/docs/getting-started/targets-and-alerts

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 type | Use it when | The budget is | Pacing compares it with |
|---|---|---|---|
| **Fee on top** (default) | You charge your agency fee on top of media | Ad cost only (**Ad cost target**) | Spend before commission |
| **Fee included** | Your fee comes out of the client's budget | The client's total (**Budget incl. agency fee**) | Spend including the fee |
| **Just a budget** | The workspace is not an agency client, so there is no fee | The budget | Spend |

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](https://mavendata.ai/docs/mcp/connect).

**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."

```prompt
Set Acme's Google Ads budget to $12,000 a month for every month of 2027.
```

## 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](https://mavendata.ai/docs/tag-management/tracking-health).

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.

```prompt
How is Acme's ad spend pacing against budget this month, and which platforms will overspend?
```

## 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](https://mavendata.ai/docs/getting-started).

```prompt
Remember that Acme's main KPI is cost per qualified lead, with a goal of under $45.
```

## 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](https://mavendata.ai/docs/mcp).

```prompt
In the Acme workspace, alert me on Slack when ROAS drops below 2 for 3 days in a row.
```

## Related

- [Connect a client's sources](https://mavendata.ai/docs/getting-started/connect-sources)
- [Tracking health and the daily brief](https://mavendata.ai/docs/tag-management/tracking-health)
- [Plans and pricing](https://mavendata.ai/docs/account/plans)
