📗 This is the user manual for the Suite for ChatGPT Ads, the tool in the Ninja Scripts panel. Here you can search it, listen to it, highlight it and save it to favourites. It is updated with every release of the tool.
The four screens that change the account. They all share the same engine, so they all inherit the same guarantees: the value is re-read live before writing, confirmed by reading afterwards, logged in the history, and the last change of each lever can be undone (once: what you undo can't be undone again).
🎛️ Bids · the target judge
The first thing on this screen isn't a button: it's a verdict per ad group. Does it meet your target cost per conversion?
How it's worked out, so you can trust it:
- The last 14 complete days, dropping its campaign's anomalous days (a day that spent less than 20 % of the median or more than three times it: a half pause, an odd spike).
- Preferred source: your own leads from Ninja Leads (with at least 5). If you don't measure them, OpenAI's conversions. The screen tells you which one it's judging with (👤 or 🤖): they aren't the same and it's worth knowing.
- Verdicts: meets · borderline (up to 20 % over) · doesn't meet · no data · no target. Plus in quarantine, when the group has just taken an automatic change and isn't judged yet.
That cross-reference — judging a ChatGPT Ads bid with the real leads from your CRM — is one of the things no tool that only sees ChatGPT can do.
The three levers
| Lever | What it changes |
|---|---|
| Fixed bid | The ad group's maximum bid |
| Strategy | Fixed bid ↔ maximise clicks ↔ maximise conversions |
| Budget | The campaign's daily budget. The ACCOUNT sets the minimum, not the objective: OpenAI requires a different figure depending on the account (25 in a dollar account, for instance, clicks campaigns included) and publishes it nowhere. The panel does not invent it: the first time OpenAI rejects a lower figure it keeps OpenAI's, and from then on offers it in the form |
⚠️ The automatic strategy has to match the campaign's objective, and the rule works BOTH ways. The objective is immutable after creation, so:
| Campaign created for… | Maximise clicks | Maximise conversions | Fixed bid |
|---|---|---|---|
| clicks | ✅ | ❌ | ✅ |
| conversions | ❌ | ✅ | ✅ |
Fixed bid works in both, and it's the way out when you want to decide yourself. The option that doesn't fit is shown disabled, the panel cuts it before calling OpenAI, and it offers you the link to 🧬 Clone, which creates the same campaign with the other objective, instead of handing you its error.
Caps and quarantine: who they protect
This changed recently and is worth reading carefully, because it's the difference between a tool that helps you and one that gets in your way:
| A change YOU make by hand | A change the panel decides (applying a recommendation, a bulk batch) | |
|---|---|---|
| Caps per move (−30 % / +20 %) | Don't apply: you set whatever figure you want | Yes: never more than a 30 % drop or a 20 % rise at once |
| Quarantine | Doesn't apply: you can touch the same lever again straight away | Yes: 7 days for strategy, 5 for the bid, 3 for the budget |
Quarantine exists because changing and un-changing is the fastest way to wreck a campaign: while it lasts, that lever isn't touched again automatically and the judge withholds its opinion. But your judgement doesn't need protecting: if you want to halve the bid, it gets halved.
Pausing and activating has no quarantine at all. It used to have two days, and it was absurd: the ⏰ Schedule itself activates and pauses those very campaigns twice a day.
⏰ Schedule · the scheduling the platform lacks
ChatGPT Ads doesn't schedule by hour, so our server does: you set the windows and a pass activates and pauses the campaigns at those times. Each campaign can have up to six slots of its own —for example 9:00 to 14:00 and 17:00 to 21:00— and it is active inside any of them.
Where each thing lives. The schedule is SET UP in each campaign's ⚙️ Settings (🏗️ Campaigns → ⚙️ Settings → View and edit → ⏰ When it runs block), next to its budget, its bid and its devices. The ⏰ Schedule screen is for the other half: DECIDING the window with data —the day × hour map and the by-weekday table, which cover the whole account, and the map can be looked at for ONE campaign with its selector— and CHECKING that it is being applied. It also gives you one row per campaign with all of its slots and the link to where they are changed, and the orange frame on the map marks the slots of whatever you are looking at.
What can be looked at by hour, and what cannot. The day × hour map shows impressions, clicks and spend. There are no conversions by hour: its API only gives them by day —asking for them by hour returns "Conversions are only supported for none or daily time_granularity"— so they are not offered, because a map that is all zeros reads as "nobody converts at any hour" when the truth is that OpenAI does not say. By weekday you do have them, in the table below the map, with their cost per conversion. And as soon as 🎯 Conversions picks up leads with a click identifier, the map also offers Leads and Cost/lead by hour: we measure those ourselves, so they can be spread hour by hour.
- The slots belong to each campaign. One can run in the morning and in the evening with midday closed, and another only at weekends. Until a campaign has slots of its own it uses the account's, so nothing changes until you define its first one. In the form, unticking all of a slot's days removes it; to add another there is its button (and without JavaScript, each save offers a new row).
- Two slots that overlap are merged when you save: "9:00-14:00" and "13:00-17:00" become "9:00-17:00", because they mean the same thing and this way the next change is worked out correctly.
- Taking the last scheduled campaign off the schedule turns the account schedule off on its own; scheduling one turns it back on. There is no second switch to remember.
- There is an emergency control in ⏰ Schedule: "Turn off the schedule for the whole account", which keeps the days, the hours and the campaigns, so turning it back on restores exactly what was there. While it is off, the panel turns nothing on or off.
- It's checked every 5 minutes, but OpenAI is only asked when necessary: when what we want doesn't match what the panel knows, near a switching hour, or when more than half an hour has passed without confirmation. That cut the calls by 83 % without losing a single change.
- A transient OpenAI failure is retried within the same pass, so the schedule hits its hour on time. You only get an email if the failure persists for a quarter of an hour.
- While the schedule governs a campaign, the 🩺 Audit does not count it as a problem that it's paused outside its window.
🧰 Bulk · changing many things at once
This is a global screen, not per account: it lists the campaigns and ad groups of all your accounts with their status, budget, bid and 30-day metrics.
The flow has one step you shouldn't skip:
- Filter and tick the rows (by account, type, status or name; or «all visible»).
- Choose the action: pause, activate, budget ±% or fixed, bid ±% or fixed, strategy.
- Simulate — and here's the value: row by row, «now → after», with ✂️ on whatever gets capped and the reason for every row that's skipped: already like that, in quarantine until day X, not on fixed bid, below the minimum…
- Apply N changes, with confirmation. It runs in the background with a progress bar.
- Undo the whole batch, in reverse order.
Guardrails: at most 100 changes per batch, one batch at a time, and it stops at the first real OpenAI failure so as not to leave the account half done without telling you. Accounts without a licence and the demo account appear 🔒 read-only.
🕰️ Changes · the timeline
Everything above leaves a trace here: hints applied, campaigns and groups created, ads fixed, statuses changed, bids, budgets, undos. With the chart behind it, so you can see whether the change on the 12th moved anything.
It's also where to check who did what when a figure doesn't match what you expected.