@koda-sl/baker-cli 0.241.0 → 0.243.0

package/dist/cli.js

@@ -2122,6 +2122,18 @@ var BIDDING_STRATEGY_TYPES = [
   "MANUAL_CPV",
   "PERCENT_CPC"
 ];
+var MERGED_TARGET_STRATEGY_CHANNELS = /* @__PURE__ */ new Set(["SEARCH"]);
+var MERGED_TARGET_CPA_MESSAGE = "Google doesn't accept Target CPA as a bidding strategy of its own on a Search campaign \u2014 the target sits inside Maximize conversions. Choose Maximize conversions and give it the same target CPA; it bids exactly the same.";
+var MERGED_TARGET_ROAS_MESSAGE = "Google doesn't accept Target ROAS as a bidding strategy of its own on a Search campaign \u2014 the target sits inside Maximize conversion value. Choose Maximize conversion value and give it the same target ROAS; it bids exactly the same.";
+function mergedTargetStrategyRefusal(channelType, biddingType) {
+  if (channelType === void 0 || !MERGED_TARGET_STRATEGY_CHANNELS.has(channelType)) {
+    return void 0;
+  }
+  if (biddingType === "TARGET_CPA") {
+    return MERGED_TARGET_CPA_MESSAGE;
+  }
+  return biddingType === "TARGET_ROAS" ? MERGED_TARGET_ROAS_MESSAGE : void 0;
+}
 var POSITIVE_GEO_TARGET_TYPES = ["PRESENCE_OR_INTEREST", "PRESENCE"];
 var NEGATIVE_GEO_TARGET_TYPES = ["PRESENCE_OR_INTEREST", "PRESENCE"];
 var BUDGET_DELIVERY_METHODS = ["STANDARD", "ACCELERATED"];
@@ -2846,6 +2858,10 @@ var campaignCreateSchema2 = z4.strictObject({
   if (p.channelType === "PERFORMANCE_MAX" && p.bidding && p.bidding.type === "MANUAL_CPC") {
     ctx.addIssue({ code: "custom", path: ["bidding"], message: "Performance Max does not support Manual CPC" });
   }
+  const mergedTarget = mergedTargetStrategyRefusal(p.channelType, p.bidding?.type);
+  if (mergedTarget) {
+    ctx.addIssue({ code: "custom", path: ["bidding"], message: mergedTarget });
+  }
   if (p.startDate && p.endDate && p.endDate <= p.startDate) {
     ctx.addIssue({ code: "custom", path: ["endDate"], message: "endDate must be after startDate" });
   }
@@ -12529,6 +12545,20 @@ var analyticsCampaignRowSchema = z24.object({
   utmSource: z24.string(),
   utmMedium: z24.string(),
   utmCampaign: z24.string(),
+  /**
+   * The platform a click id proves, or `""` when the visit carried none.
+   *
+   * What separates a campaign the ad breakdown already reports — with its
+   * platform proven and its ad set and ad underneath — from one nothing else
+   * can show: the newsletter, the partner link, the hand-tagged post. The two
+   * are otherwise identical, because `utm_campaign={campaignid}` is the normal
+   * tagging convention and produces the same ids in both places.
+   *
+   * Kept on the row rather than filtered out here: a CLI hint reads an empty
+   * campaign list as "no campaign tagging on any traffic", and dropping the
+   * paid ones would make that fire on a perfectly tagged account.
+   */
+  clickPlatform: z24.string(),
   sessions: z24.number().int().nonnegative(),
   conversions: z24.number().int().nonnegative(),
   conversionRate: z24.number().min(0).max(1).nullable()
@@ -13241,7 +13271,8 @@ var analyticsTrackingPlatformSchema = z24.object({
   /** The pairs to append to the account's tagging, or `""`. */
   suffix: z24.string(),
   whereItGoes: z24.string(),
-  fix: z24.string().optional()
+  /** Which level to put them at, who can write it, and how an existing value is treated. */
+  fix: z24.string()
 });
 var analyticsTrackingResponseSchema = z24.object({
   ok: z24.literal(true),
@@ -13613,10 +13644,16 @@ var campaignsCommand = defineCommand30({
         "budget-ref": { type: "string", description: "Budget ref (g_temp_*, id, or resource name)" },
         "bidding-strategy": {
           type: "string",
-          description: "MANUAL_CPC | MAXIMIZE_CONVERSIONS | TARGET_CPA | TARGET_ROAS | \u2026"
+          description: "MANUAL_CPC | MAXIMIZE_CONVERSIONS | MAXIMIZE_CONVERSION_VALUE | TARGET_SPEND | \u2026"
+        },
+        "target-cpa": {
+          type: "string",
+          description: "Target CPA (major units). On a Search campaign pair it with --bidding-strategy MAXIMIZE_CONVERSIONS \u2014 Google keeps the target inside that strategy and rejects a standalone TARGET_CPA."
+        },
+        "target-roas": {
+          type: "string",
+          description: "Target ROAS (e.g. 4.0). On a Search campaign pair it with --bidding-strategy MAXIMIZE_CONVERSION_VALUE \u2014 Google keeps the target inside that strategy and rejects a standalone TARGET_ROAS."
         },
-        "target-cpa": { type: "string", description: "Target CPA (major units) for TARGET_CPA" },
-        "target-roas": { type: "string", description: "Target ROAS (e.g. 4.0) for TARGET_ROAS" },
         ...maxCpcArg,
         ...finalUrlSuffixArg,
         ...urlOptionsArgs,
@@ -13663,9 +13700,18 @@ var campaignsCommand = defineCommand30({
         ...fileArg,
         name: { type: "string" },
         "budget-ref": { type: "string" },
-        "bidding-strategy": { type: "string" },
-        "target-cpa": { type: "string" },
-        "target-roas": { type: "string" },
+        "bidding-strategy": {
+          type: "string",
+          description: "MANUAL_CPC | MAXIMIZE_CONVERSIONS | MAXIMIZE_CONVERSION_VALUE | TARGET_SPEND | \u2026"
+        },
+        "target-cpa": {
+          type: "string",
+          description: "Target CPA (major units). On a Search campaign pair it with --bidding-strategy MAXIMIZE_CONVERSIONS \u2014 Google keeps the target inside that strategy and rejects a standalone TARGET_CPA."
+        },
+        "target-roas": {
+          type: "string",
+          description: "Target ROAS (e.g. 4.0). On a Search campaign pair it with --bidding-strategy MAXIMIZE_CONVERSION_VALUE \u2014 Google keeps the target inside that strategy and rejects a standalone TARGET_ROAS."
+        },
         ...maxCpcArg,
         ...finalUrlSuffixArg,
         ...urlOptionsArgs,
@@ -23296,8 +23342,18 @@ function buildAnalyticsHints(data, platform) {
       "No campaign tagging on any traffic \u2014 ad clicks cannot be attributed to a campaign until the destination URLs carry utm parameters."
     );
   }
+  hints.push(...campaignOriginHints(data.topCampaigns));
   return hints;
 }
+function campaignOriginHints(rows) {
+  const campaigns = rows ?? [];
+  const fromAds = campaigns.filter((row) => row.clickPlatform !== "");
+  if (fromAds.length === 0) return [];
+  const own = campaigns.length - fromAds.length;
+  return [
+    `${fromAds.length} of these campaigns arrived on an ad click (\`clickPlatform\` is set). \`baker analytics ads --role campaign_id\` MAY report the same campaigns under the platform's own ids \u2014 check before you quote both, or you will count one campaign twice. It may equally report nothing: \`ads\` only reads parameters the account tags separately, and \`utm_campaign\` is reserved and never reaches it, so an account whose only campaign signal is \`utm_campaign\` has its campaigns HERE and nowhere else. Never report "no campaigns" on the strength of an empty \`ads\`. ${own === 0 ? "Every row here came from an ad." : `The other ${own} carry no click id at all \u2014 a newsletter, a partner link, a tagged post \u2014 and only this report can show them.`}`
+  ];
+}
 
 // src/commands/analytics/presets.ts
 var ANALYTICS_PRESET_INFO = [
@@ -24019,7 +24075,7 @@ var trackingCommand = (() => {
 Read this before auditing an ad account and before answering any "which ad performed best" question. Each dimension comes back in one of four states, and they need different things:
   covered  \u2014 arriving and understood, nothing to do
   unmapped \u2014 the URLs carry it under a name Baker does not read yet. Free to fix, and it repairs the traffic already collected: run the \`mapCommand\` in the response
-  missing  \u2014 nothing carries it. Add \`suffix\` to the account's tagging (\`whereItGoes\` says where, \`fix\` says whether Baker can stage it). This one cannot be filled in later \u2014 a parameter's values are only stored once it starts arriving
+  missing  \u2014 nothing carries it. \`fix\` says which LEVELS that platform accepts tagging at (widest first \u2014 prefer it), which Baker can stage and which the user must do by hand, and how each field treats what is already in it. \`suffix\` is only the MISSING pairs, so read the current value, add them, write the union. This one cannot be filled in later \u2014 a parameter's values are only stored once it starts arriving
   unknown  \u2014 no visit arrived AND the account could not be read. Not a finding; do not report it as untagged
 
 Baker reads the client's own Google tracking templates and Meta URL parameters, so a platform that has not run yet still gets a real answer.