Record a boost's numbers
boost_recordRecord what the platform's Ads Manager shows for a boost, read in the founder's Chrome: per post or ad (n, the ad group's or ad set's number in the plan; a split boost per ad group, with device desktop or phone) the spend in USD (an account billing in another currency: converted at today's rate), impressions, and link clicks, not all clicks (engagements for a reach boost). status running when the founder has pressed Launch or Publish, stopped when they stop it. Reddit and Google, where your browser cannot go, or a TikTok export: pass the founder's export as csv (Reddit Ads, Reports, by ad group, Export; TikTok Ads Manager, the campaign's Ad group tab, Export, with Cost, Impressions and Clicks (destination); Google Ads, Campaigns, Download) and the server reads each ad group named "ad ", or Google campaign named sf-boost-- (spend or cost, impressions, clicks; daily rows added up), with usdRate when the account bills in another currency; numbers in posts win over it. Never invent a number: leave out what you could not read. Free.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "boost_record"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| csv | No | The Ads Manager export, pasted as it is, broken down by ad group | |
| posts | No | ||
| status | No | ||
| capture | No | The phone capture's PR is merged for this boost: where its emails go, own (the founder's list or email provider) or shipfound (setup_link user events on their Users page). The signup follow-up picks these people up | |
| usdRate | No | USD per unit of the account's currency, for the export's spend; default 1 |