Monitor rules reference
Every metric, condition and action you can use in a Monitor task.
Everything you can set on a Monitor trigger in an Agent Task, and the steps it can run. For a worked example, see Stop runaway spend.
Monitor setup
| Setting | Options |
|---|---|
| Level | Campaign, Ad set or Ad. Starts on Campaign. |
| Check every | 5 minutes, Hour, 12 hours or Day. Starts on Day. |
| Brand and Campaigns | The ad account and the campaigns to watch. A brand is always required. The campaign list is required unless you turn on the next option. The Brand picker only appears in the All Accounts view; elsewhere the task uses the account you're in. |
| Apply to new campaigns automatically | Watches all campaigns in the ad account, including ones launched later. |
| Rules | At least one condition. See below. |
| On Meta API outage | What to do if the ad platform can't be reached. See below. |
Parts of a condition
| Part | Options |
|---|---|
| Metric | See the metric tables below. |
| Operator | Greater Than, Less Than, Equal |
| Value | A number. Money metrics show your currency sign, percentages show %. |
| Time Range | Today, Yesterday, Last 2 Days, Last 3 Days, Last 7 Days, Last 14 Days, Last 28 Days, Last 30 Days, Lifetime |
| Attribution Window | Only for the Purchase ROAS metrics and for conversion-style metrics, which includes Hyros Sales: Default, 1-day click, 1-day view, 7-day click, 7-day view, 28-day click, 28-day view. Starts on Default. |
A new condition starts as Spend, Greater Than, 0, Today, from Meta.
Combining conditions. Add condition adds a condition joined with AND: both must be true. Add alternative starts a new group joined with OR: either group can be true.
Metrics
The metric list is grouped by data source. Picking a tracker metric before that tracker is connected asks you to connect it first.
| Data source | Metrics |
|---|---|
| Meta (Facebook & Instagram) | Spend, Cost Per Result, Purchase ROAS, Website Purchase ROAS, Mobile App Purchase ROAS, Offline Purchase ROAS, CTR, Conversions, CPC |
| RedTrack | Clicks, Spend, Conversions, Revenue, CPA, ROI, ROAS, CVR, RPC, CPC, AOV, Profit, Profit Margin |
| Cometly (Beta) | Conversions, Revenue, CPA, ROAS, AOV |
| Hyros (Beta) | Sales, Revenue, Cost, CPA, ROAS, ROI, AOV |
Tracker setup: RedTrack, Cometly, Hyros.
When a tracker number is missing. If Koast can't get a value for a tracker metric, for example the tracker returned nothing for that campaign, the rule is skipped for that check. It's never treated as 0, so a missing number can't trigger a pause. Hyros rules don't run at the ad level.
API outage
| Option | What happens if the ad platform's API is down |
|---|---|
| Do nothing | The Monitor waits for the next check. |
| Pause affected entities | Pauses what the Monitor watches. New Monitors you set up in the builder start on this option. |
| Pause, then resume on recovery | Pauses, then turns things back on when the API recovers. |
Actions
When the rule is met, the task runs its steps in order.
| Step | Options |
|---|---|
| Pause | Pauses the campaign, ad set or ad. |
| Adjust budget | Increase or Decrease by a percentage, 20% by default. Not available on ad-level Monitors. Use Percent: a run refuses a fixed Amount. |
| Slack notification | Posts a message to the Slack channel you pick. |
| Wait | Delays the next step. |
| Agent step | Runs plain-English instructions with Koast Agent. |
Pause, Adjust budget and Slack notification can each require approval first. See Approvals and the Sign-off queue.