Plan a boost
boost_planPlan a boost: on X (default) one to three of the founder's own posts; on Google (platform google) one to three search ads, each with its own keywords (the searches it answers), headlines (3 to 15, up to 30 characters) and descriptions (2 to 4, up to 90), only with searchVolumes from keyword_research showing people search for them; on Meta (platform meta) one to three ads written for it, each a primary text and a headline over the product video; on Reddit (platform reddit) one to three ads written for it, each a headline (up to 300 characters) over the product video, or with format post a text-only ad that reads like a post: a title (text, up to 300 characters) and a body, with comments on, on the Traffic objective optimised for clicks (Reddit offers text post ads no Sales objective, so no optimize) and with no destination URL: the tagged link is the body's last line, in brief.copy per ad group. An equal budget per post or ad (default $45, at most $300), the days, a tagged link per post so each visit and signup traces to it, what to expect and the stop rule. A post the founder named goes in as is: no data is read about it. Goal visits (default) runs each post as a Promoted-only copy with its link; reach boosts the post itself. targeting is who sees it, as the founder answered: locations, and optionally languages, gender, age, follower look-alikes, keywords, interests, and on Reddit communities (Meta: no look-alikes or keywords; Reddit: no look-alikes). Refused until ads_setup says the ad account and tracking are done on that platform. optimize is the step of the ladder the founder confirmed; a step with too few a week for the platform to learn from is refused (it bids high for the few people it guesses) unless force is true, which only the founder's own say-so after hearing that allows. posts[].media names the files you upload for each ad (cut and format), else the ad's files by name in the ads folder on the Desktop. refreshOf replaces a running boost whose creative or setup is weak: its messages are not offered again, and the plan returns what is left of its budget. firstStep (once per product, kept): whether a phone can take the product's first step, as you found it and the founder confirmed; without one on file a visits plan is refused. devices: every device, desktop only, or split (each ad twice, desktop only and phones only, half its budget each), as the founder confirmed; default from the first step (split when a phone cannot take it), returned as devices with the why. sizing says what each question costs: clicks (enough impressions to compare click rates) and signups (about 5 signups per ad group at the site's own rate, or why it cannot be priced), and what this budget answers; question sets the budget to the one the founder picked. landing: the A/B test of each ad's own line as the landing page's headline, only for the boost's visits (key, name, hypothesis, path, goal for experiment_create, and the gated page code for a PR). retargetOf plans the optional second phase: a small ad to an earlier boost's visitors who did not sign up (default $20 over 5 days, desktop only when a phone cannot take the first step; the audience is created first, in the setup). Returns the Ads Manager setup, the checks for the Review page, and brief.warnings: what is wrong with the audience for this message. Nothing is launched or spent. Free.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Default 3 | |
| goal | No | ||
| force | No | Only when the founder still wants a step with too few a week to learn from, after you told them it bids high | |
| posts | Yes | ||
| format | No | Reddit only. video (default): a headline over the product video. post: a text-only ad written like a post to the community, a title (text) and a body, comments on; no video or image | |
| repeat | No | Only when the founder asked to boost again a post or message boosted before; without it a repeat is refused | |
| source | No | founder: they named it. ranked: from boost_candidates | |
| devices | No | As the founder confirmed; default from the first step | |
| optimize | No | What the campaign optimises for, as the founder confirmed from ads_setup's recommend; default that recommendation. Not for a Reddit post ad: it runs on Traffic, optimised for clicks | |
| platform | No | Default x | |
| question | No | What the founder wants the budget to answer, from sizing; sets the budget when budgetUsd is not given | |
| budgetUsd | No | Total, split equally; default 45 | |
| firstStep | No | Once per product, after the founder confirmed it; kept for later plans | |
| refreshOf | No | The id of the boost this one replaces; its ads are paused by the founder first | |
| targeting | No | Who sees the ads, as the founder answered. Ask before planning. | |
| landingUrl | No | Where the link goes; default the site's home page | |
| retargetOf | No | Retarget this earlier boost's visitors who did not sign up (optional, only on the founder's yes) | |
| searchVolumes | No | Google: each keyword's searches a month and cost per click, from keyword_research |