@koda-sl/baker-cli 0.393.0-dev.10b6da011 → 0.394.0-dev.d28cef496

package/README.md

@@ -876,7 +876,7 @@ Read the company's ChatGPT Ads account (OpenAI's ads inside ChatGPT conversation
 | `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, tracking template, product filters, status |
+| `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 |

package/dist/cli.js

@@ -33531,6 +33531,21 @@ var campaignUpdateSchema4 = z31.strictObject({
   checkRunWindow2(p.startTime, p.endTime, ctx);
   checkTargeting(p, ctx);
 });
+var audienceBidMultipliersSchema = z31.array(
+  z31.strictObject({
+    audienceId: audienceIdSchema,
+    multiplierMicros: z31.number().int().min(1e5, "a bid adjustment is 0.1\xD7 to 10\xD7 \u2014 100000 to 10000000 micros").max(1e7, "a bid adjustment is 0.1\xD7 to 10\xD7 \u2014 100000 to 10000000 micros")
+  })
+).max(100);
+function checkMultipliers(strategy, multipliers, ctx) {
+  if (strategy !== void 0 && strategy !== "fixed_bid" && (multipliers?.length ?? 0) > 0) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["audienceBidMultipliers"],
+      message: "an audience bid adjustment changes a fixed bid \u2014 Maximize Results sets the bid itself"
+    });
+  }
+}
 function checkBidPair2(strategy, maxBid, ctx) {
   if (strategy === "fixed_bid" && maxBid === void 0) {
     ctx.addIssue({ code: "custom", path: ["maxBidMicros"], message: "a fixed bid needs its amount" });
@@ -33558,8 +33573,12 @@ var adGroupCreateSchema2 = z31.strictObject({
   /** Only under a catalog campaign; which of its products this ad group may show. */
   productSet: productSetSchema.optional(),
   /** The campaign's catalog, filled in at stage time — the product set must name it. */
-  productFeedId: z31.string().trim().min(1).optional()
-}).superRefine((p, ctx) => checkBidPair2(p.bidStrategy, p.maxBidMicros, ctx));
+  productFeedId: z31.string().trim().min(1).optional(),
+  audienceBidMultipliers: audienceBidMultipliersSchema.optional()
+}).superRefine((p, ctx) => {
+  checkBidPair2(p.bidStrategy, p.maxBidMicros, ctx);
+  checkMultipliers(p.bidStrategy, p.audienceBidMultipliers, ctx);
+});
 var adGroupUpdateSchema2 = z31.strictObject({
   name: nameSchema3.optional(),
   description: z31.string().trim().max(CHATGPT_LIMITS.nameMax).optional(),
@@ -33571,9 +33590,12 @@ var adGroupUpdateSchema2 = z31.strictObject({
   billingEvent: z31.enum(CHATGPT_BILLING_EVENTS).optional(),
   /** Replaces the whole product set; `{ filters: [] }` shows the whole catalog. */
   productSet: productSetSchema.optional(),
-  productFeedId: z31.string().trim().min(1).optional()
+  productFeedId: z31.string().trim().min(1).optional(),
+  /** Replaces the ad group's adjustments; an empty list clears them. */
+  audienceBidMultipliers: audienceBidMultipliersSchema.optional()
 }).superRefine((p, ctx) => {
   noEmptyUpdate(p, ctx);
+  checkMultipliers(p.bidStrategy, p.audienceBidMultipliers, ctx);
   checkBidPair2(p.bidStrategy, p.maxBidMicros, ctx);
 });
 var titleSchema = z31.string().trim().refine(
@@ -34363,7 +34385,7 @@ var SHARED_ARGS = {
   description: { type: "string", description: "Internal description" },
   "context-hints": {
     type: "string",
-    description: "When the ad would be useful, short phrases separated by commas \u2014 or by | when a phrase has a comma. ChatGPT's counterpart to keywords. On update it replaces the whole list; none clears it"
+    description: "When the ad would be useful, short phrases separated by commas \u2014 or by | when a phrase has a comma. ChatGPT's counterpart to keywords, written in the language of the campaign's countries, as people ask ChatGPT. On update it replaces the whole list; none clears it"
   },
   "bid-strategy": {
     type: "string",
@@ -34374,6 +34396,10 @@ var SHARED_ARGS = {
     type: "string",
     description: "Query string added to this ad group's landing pages, e.g. utm_content={ad_group_id} \u2014 none clears"
   },
+  "audience-bids": {
+    type: "string",
+    description: "Raise or lower the fixed bid for people in an audience: audience=multiplier pairs, 0.1 to 10, e.g. caud_123=1.5,caud_456=0.8. Audiences of ~25,000 people only; not in the EEA or Switzerland. On update it replaces them; none clears"
+  },
   "product-filters": {
     type: "string",
     description: "Catalog campaigns only: which products it shows \u2014 e.g. brand in Acme; price lte 5000 (preview with `catalogs products`). On update it replaces the set; none shows the whole catalog"
@@ -34399,6 +34425,22 @@ function contextHintsArg(value) {
   const separator = value.includes("|") ? "|" : ",";
   return value.split(separator).map((hint) => hint.trim()).filter(Boolean);
 }
+function audienceBidsArg(value) {
+  if (typeof value !== "string" || value.trim() === "") {
+    return void 0;
+  }
+  if (value.trim().toLowerCase() === "none") {
+    return [];
+  }
+  return value.split(",").map((pair) => pair.trim()).filter(Boolean).map((pair) => {
+    const [audienceId = "", multiplier = ""] = pair.split("=").map((part) => part.trim());
+    const times = Number(multiplier.replace(",", "."));
+    if (!audienceId || !Number.isFinite(times)) {
+      failWriteValidation(`"${pair}" is not an audience bid \u2014 write audience=multiplier, e.g. caud_123=1.5`);
+    }
+    return { audienceId, multiplierMicros: Math.round(times * 1e6) };
+  });
+}
 function productSetArg(value) {
   const filters = productFiltersArg(value);
   return filters === void 0 ? void 0 : { filters };
@@ -34412,6 +34454,7 @@ function sharedPayload(args8) {
     maxBidMicros: microsFromArg(args8["max-bid"], "--max-bid"),
     trackingTemplate: clearableArg(args8["tracking-template"]),
     productSet: productSetArg(args8["product-filters"]),
+    audienceBidMultipliers: audienceBidsArg(args8["audience-bids"]),
     status: lowerArg(args8.status)
   };
 }