Skip to content

Paid media

Prices clicks before any spend, runs ads on your own ad accounts within your spend limit, and stops what does not pay back.

File convention
agents/marketing/paid-media-manager.mdx
Noun
Role
Metric.query
You, to your agent

Show me return on ad spend by Campaign for the last 4 weeks.

curl -X POST "https://api.sb/leaseline.app/metrics/query?mode=try" \
  -H "Authorization: Bearer $SB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"metric":"metric:return-on-ad-spend","shape":"trend","breakdown":"campaign","window":"28d"}'
npx startup-builder do Metric.query --try --data '{"metric":"metric:return-on-ad-spend","shape":"trend","breakdown":"campaign","window":"28d"}'
{
  "name": "do",
  "arguments": {
    "mode": "try",
    "code": "return await $.Metric.query({ metric: 'metric:return-on-ad-spend', shape: 'trend', breakdown: 'campaign', window: '28d' })"
  }
}
import { $ } from 'startup-builder'

const result = await $.try.Metric.query({ metric: 'metric:return-on-ad-spend', shape: 'trend', breakdown: 'campaign', window: '28d' })
Response
{
  "metric": "metric:return-on-ad-spend",
  "window": "28d",
  "rows": [
    {
      "campaign": "rent-ledger-search",
      "value": 2.4
    },
    {
      "campaign": "meta-lookalike-test",
      "value": 0.8
    }
  ]
}
Try mode reads, stores nothing and spends nothingAPI referenceIts Nouns

Responsibilities

  • Forecasts clicks and cost on each term before any spend.
  • Builds each Campaign on your own ad account, with its stop rule set before launch.
  • Rotates creative, and pauses an Ad whose cost per click runs above break-even for 3 days at 100 or more clicks, or whose cost per signup runs above twice its target at 20 or more signups.
  • Sends conversions back to every ad site, so each one optimizes for buyers.

Verbs

VerbObjectEvent
Keyword.forecastKeywordNone: a read
Audience.createAudienceAudience.created
Campaign.createCampaignCampaign.created
Campaign.updateCampaignCampaign.updated
Ad.createAdAd.created
Ad.findAdNone: a read
Metric.queryMetricMetric.queried

Role contract

PartThis seat
PurposeMake every paid dollar buy customers the startup can afford.
ResultsReturn on ad spend; Payback on acquisition cost
TargetCost per click at or under your break-even, $4.29 at $149 a month, read at 100 clicks, and at least 1 signup per 150 clicks (Planning estimate).
StandardsPauses an Ad on leading indicators with their samples: cost per click above break-even for 3 days at 100 or more clicks, or cost per signup above twice its target at 20 or more signups. Spends only within the Demand Budget, on spend you authorized.
LimitsMandate.spend up to $500 a week (the hub Paid Media Manager’s limit), and only on spend you authorized
ScheduleDaily
Channelssocial
Also calledPerformance Marketer, Media Buyer
Filled byA role agent, from the start; the spend is yours, on your own account.

Hands off to

  • Marketing lead: A Campaign’s stop rule fires: the readout and the next test go to the weekly review.
  • Content lead: An ad angle wins: it briefs a page on the same promise.

Processes owned

Launches · Compile the demand kit · Run an experiment

Metrics

Return on ad spend · Acquisition payback

Approvals

You see the plan and its price before anything runs. Sends and posts go out within the limits you set; one approval rule on a class such as send makes every action in it wait for you, and going over a limit always asks.

It asks youWhenAnswered by
Spend past the week’s limitPast the seat’s weekly Mandate.spend limit, or on spend you have not authorizedYou

Each class and its default amount: the hub’s approvals page.

Works with

  • Ad kit (agent task): One angle in, five headlines and texts, five images at each site’s sizes and a 6-second clip out, every claim checked, saved as Variants.
  • Ad test setup (Workflow): Your ad Variants in, one campaign out on your own ad account, split evenly, with the conversion checked and the stop rule set first.
  • Message test (agent task): Four angles in your buyers’ words run as ads on $100 of your spend, and the winner named by a rule set before any spend.

It trades hand-offs with Marketing lead and Content lead.

Example

Before any spend, the agent forecasts three rent-ledger terms at about $2.40 a click, under the $4.29 break-even at $149 a month, and launches on Google Search at $70 a day, inside the $500-a-week limit. By day 16 one term has 104 clicks at $5.10 each, above break-even for 3 days running, so the agent pauses it and moves its budget to the two terms still under the line.

Contents