@koda-sl/baker-cli 0.387.0 → 0.388.0

package/README.md

@@ -157,7 +157,7 @@ Use `--output` to change format:
 
 ### Ad Platforms (`baker ads`)
 
-Multi-platform ad commands. Google, Meta, and LinkedIn support both reads and **staged writes** (create/update campaigns, ad sets/ad groups, ads, creatives, audiences — applied on chat publish); X (Twitter) is read + analytics. TikTok is coming.
+Multi-platform ad commands. Google, Meta, and LinkedIn support both reads and **staged writes** (create/update campaigns, ad sets/ad groups, ads, creatives, audiences — applied on chat publish); X (Twitter) is read + analytics; ChatGPT Ads is read + analytics + staged writes. TikTok is coming.
 
 ---
 
@@ -863,6 +863,48 @@ baker ads x targeting-constants --constant tv_shows --locale en-US
 
 ---
 
+### ChatGPT Ads (`baker ads chatgpt`)
+
+Read the company's ChatGPT Ads account (OpenAI's ads inside ChatGPT conversations) and how it performs, and stage changes to it that apply when the chat is published. The company connects one account in the dashboard (Brain → Integrations → ChatGPT Ads) with an API key from its Ads Manager; the key stays in Baker and never reaches the CLI, so there is no account id to pass.
+
+| Subcommand | What it returns |
+|---|---|
+| `account` | Name, currency, timezone, status, and the brand and account reviews that decide whether anything serves |
+| `campaigns` | Campaigns: objective, daily or lifetime budget (currency units), schedule, locations, platforms, serving issues |
+| `ad-groups` | Ad groups (`--campaign-id`): bid strategy, max bid, context hints, serving issues |
+| `ads` | Ads (`--ad-group-id`): the card's copy, image, destination, review outcome, serving issues |
+| `conversions` | Pixels (with the pixel id a landing page installs) and conversions, with the campaigns using each |
+| `insights` | Impressions, clicks, spend, CTR, CPC, CPM, conversions, CPA, ROAS — per `--level account\|campaign\|ad_group\|ad`, over `--days N` or `--since/--until`, `--granularity`, `--segment country\|device\|platform\|product` |
+| `campaigns create\|update\|pause\|resume\|archive` | Stage a campaign change: objective, daily or lifetime budget (currency units), schedule, countries and regions included and excluded, audiences, platforms, tracking template, status, the conversions it measures (`--conversion-event-ids`), a catalog (`--catalog-id`) |
+| `ad-groups create\|update\|pause\|resume\|archive` | Stage an ad group change: context hints, bid strategy, max bid, audience bid adjustments, tracking template, product filters, status |
+| `ads create\|update\|pause\|resume\|archive` | Stage a chat card: title, body, landing page, image and its crop, tracking template, status |
+| `ads create-product` | Stage a catalog ad group's product ad: a title template the catalog's products fill in |
+| `pixels create` | Stage a new website pixel |
+| `audiences` | Custom audiences, with `create\|add\|remove\|archive` — members hashed on your machine, never sent raw |
+| `catalogs` | Product catalogs, with `uploads` (how each upload went) and `products` (preview filters) |
+| `conversions report` | Conversions split into click-through and view-through, with the attribution windows |
+| `history` | What changed in the account, by anyone, with each field before and after |
+| `account update` | Stage the advertiser's brand name or icon (`--favicon-url`) |
+| `conversions create` | Stage a conversion — a standard event (`lead_created`, `order_created`, …) or a custom one by name — counted from the account's pixel |
+| `conversions events` | What the pixel delivered in the last ~15 minutes — proof a site sends the event |
+| `locations <place>` | Regions, cities and markets ChatGPT Ads can target, with the id `--location-ids` takes |
+| `draft` | Review the staged changes as a tree; `show`, `amend`, `remove`, `clear`. After a publish, what applied and what failed |
+
+`--full` on the list commands returns ChatGPT Ads' own objects. ChatGPT Ads refuses some metric and breakdown combinations (CPA, conversion rate and sales cannot be broken down; conversions come daily or as one total); `insights` refuses them first and says why.
+
+Writes need `BAKER_CHAT_ID`: they stage on the chat and reach ChatGPT Ads only when it is published. New entities are created paused unless `--status active`.
+
+```bash
+baker ads chatgpt account
+baker ads chatgpt insights --days 30 --granularity daily --level account
+baker ads chatgpt insights --campaign-id cmpn_123 --level ad --sort spend
+baker ads chatgpt campaigns create --name "Spring push" --objective clicks --daily-budget 20 --countries ES
+baker ads chatgpt ad-groups create --campaign-id chatgpt_temp_ab12 --name "Rooftop owners" --context-hints "solar panels for my house" --max-bid 2.50
+baker ads chatgpt draft
+```
+
+---
+
 ### Meta Ads (`baker ads meta`)
 
 Meta Marketing API (Facebook + Instagram). Connect via OAuth in the dashboard, pick which ad accounts to scope to, then call from the CLI. Account ID via `--account-id act_123` or `BAKER_META_AD_ACCOUNT_ID` env var.

package/dist/{chunk-HJEMOSPH.js → chunk-AOVFDDVW.js}

@@ -4,6 +4,14 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __glob = (map) => (path) => {
+  var fn = map[path];
+  if (fn) return fn();
+  throw new Error("Module not found in bundle: " + path);
+};
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
 var __commonJS = (cb, mod) => function __require() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
@@ -1247,6 +1255,8 @@ function childEnvWith(extra) {
 }
 
 export {
+  __glob,
+  __esm,
   __commonJS,
   __toESM,
   isChallengeBody,
@@ -1289,4 +1299,4 @@ export {
   captureVimeoCookie,
   childEnvWith
 };
-//# sourceMappingURL=chunk-HJEMOSPH.js.map
+//# sourceMappingURL=chunk-AOVFDDVW.js.map