@koda-sl/baker-cli 0.177.0-dev.0cbdaa224 → 0.178.0

package/dist/cli.js

@@ -36,7 +36,7 @@ import {
   toModelSafeImage,
   ulid,
   validateCanvasDeep
-} from "./chunk-QPVJGKV7.js";
+} from "./chunk-P2T3IZRE.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -2892,6 +2892,7 @@ var historyCategorySchema = z9.enum([
   "creative",
   "report",
   "domain",
+  "hosting",
   "integration",
   "tag_manager"
 ]);
@@ -9962,6 +9963,16 @@ function keywordKillHints(status) {
   const kills = typeof status === "string" && ["PAUSED", "REMOVED"].includes(status.toUpperCase());
   return kills ? KEYWORD_KILL_HINTS : [];
 }
+function keywordFinalUrlHints(finalUrl, count) {
+  if (typeof finalUrl !== "string" || finalUrl.length === 0) {
+    return [];
+  }
+  return count > 1 ? [
+    `--final-url applied the same landing page to all ${count} keywords. A keyword-level URL only earns its place when that keyword must land somewhere the ad doesn't \u2014 one URL shared by every keyword belongs on the ad instead. Re-stage without --final-url unless the destinations genuinely differ per keyword, and set the ad's final URL to this page.`
+  ] : [
+    "Keep --final-url only if this keyword's destination differs from the ad's final URL \u2014 otherwise drop it and let the keyword inherit the ad's landing page."
+  ];
+}
 var keywordWriteSubcommands = {
   add: defineCommand30({
     meta: { name: "add", description: "Add keyword(s) to an ad group \u2014 one --text or a whole batch" },
@@ -9975,19 +9986,24 @@ var keywordWriteSubcommands = {
       file: { type: "string", description: "Text file with one keyword[:MATCH_TYPE] per line" },
       "match-type": { type: "string", description: "Default match type: EXACT | PHRASE | BROAD" },
       "cpc-bid": { type: "string", description: "Keyword CPC bid in major units (applies to all)" },
-      "final-url": { type: "string", description: "Keyword-level final URL (applies to all)" }
+      "final-url": {
+        type: "string",
+        description: "Rarely needed: send THIS keyword to a page the ad doesn't go to. Applies to every keyword in the call, so leave it unset unless the destination is keyword-specific \u2014 otherwise set the ad's final URL"
+      }
     },
     run: async ({ args }) => {
       const customerId = requireCustomerId(args);
       const adGroup = requireStringFlag(args["ad-group-ref"], "--ad-group-ref");
       const cpcBidMicros = microsFlag(args["cpc-bid"], "--cpc-bid");
       const finalUrls = args["final-url"] ? [args["final-url"]] : void 0;
+      const entries = keywordEntries(args);
       await stageGoogleOps(
-        keywordEntries(args).map((entry) => ({
+        entries.map((entry) => ({
           kind: "google.keyword.add",
           customerId,
           payload: { adGroup, text: entry.text, matchType: entry.matchType, cpcBidMicros, finalUrls }
-        }))
+        })),
+        keywordFinalUrlHints(args["final-url"], entries.length)
       );
     }
   }),