@koda-sl/baker-cli 0.434.0 → 0.436.0

package/README.md

@@ -621,6 +621,18 @@ baker ads google campaigns create --customer-id 1234567890 --name "Brand — Sea
 # New campaigns are declared as NOT containing EU political advertising (Google requires the
 # declaration on every create); pass --eu-political-ads only when the campaign does contain it.
 # On update, --eu-political-ads / --eu-political-ads=false corrects an existing declaration.
+# Text guidelines (AI Max Search and Performance Max) stage on update only:
+baker ads google campaigns update <campaign-id> --customer-id 1234567890 \
+  --term-exclusion "cheap" --messaging-restriction "Never promise a delivery date"
+# --term-exclusion (repeatable, up to 25 × 30 chars) and --messaging-restriction (repeatable,
+# up to 40 × 300 chars) each REPLACE the campaign's list; --clear-term-exclusions /
+# --clear-messaging-restrictions empty one. A Search campaign needs AI Max with text
+# customization on (in the same update or before), or staging is refused with the reason.
+# AI Max for Search stages on create and update: --ai-max / --ai-max=false (off turns both
+# features off too), --ai-max-text (text customization, needs AI Max) and
+# --ai-max-url-expansion (final URL expansion, needs text customization). An omitted switch
+# keeps the campaign's value; a combination Google refuses is refused at staging.
+baker ads google campaigns update <campaign-id> --customer-id 1234567890 --ai-max --ai-max-text
 baker ads google ad-groups create --customer-id 1234567890 --name "Brand terms" --campaign-ref g_temp_<campaign>
 baker ads google keywords add --customer-id 1234567890 --ad-group-ref g_temp_<adgroup> --text "brand name" --match-type EXACT
 # Shared negative keyword list → attach to the campaign
@@ -1171,7 +1183,8 @@ baker ads linkedin bid-pricing --account-id 503001492 \
 **`analytics`** — the 3-axis workhorse:
 - `--level account` (override: `campaign-group|campaign|creative`)
 - `--intent baseline` field bundle. Intents: `baseline | revenue | funnel | engagement | video | lead-gen | inmail | document | ranking | identity`. List with `--list-intents`.
-- `--pivot none`. Pivots: `none | campaign | campaign-group | creative | company | account | conversion | job-title | job-function | seniority | industry | company-size | country | region | device | placement | serving-location | card-index | objective | conversation-node | conversation-node-button`. List with `--list-pivots`.
+- `--pivot none`. Pivots: `none | campaign | campaign-group | creative | company | account | conversion | job-title | job-function | seniority | industry | company-size | country | region | dma | device | placement | serving-location | card-index | objective | conversation-node | conversation-node-button`. List with `--list-pivots`.
+- `--pivot dma` — US Nielsen Designated Market Areas, with region names resolved. LinkedIn's terms: any report built from it writes "DMA®" each time and carries "DMA® is a registered service mark of The Nielsen Company." — the `DMA_ATTRIBUTION_REQUIRED` warning repeats this on every call.
 - `--granularity DAILY`. Auto-forced to `ALL` when pivoting on a `MEMBER_*` dim (LinkedIn rejects DAILY + demographic) — surfaced in stderr + `warnings`.
 - `--last-days 7` unless you pass `--start`/`--end`.
 - Sort: `costInUsd` descending. `--no-sort` to disable.
@@ -1277,6 +1290,8 @@ baker ads linkedin campaigns exclude-companies 123456 --segment urn:li:dmpSegmen
 # Conversions with playbook-default windows
 baker ads linkedin conversions create --name "Demo booked" --type LEAD --method INSIGHT_TAG \
   --post-click-window 30 --view-window 7
+# Windows are 1|7|30|90 days; 180 and 365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD,
+# SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION — refused at stage time otherwise
 
 # Safe duplication — stage-time read of the source → staged DRAFT create ("Duplicate ad", never "Link to original")
 baker ads linkedin campaigns duplicate 123456 --name "New variant"

package/dist/cli.js

@@ -23868,11 +23868,11 @@ var LINKEDIN_LIMITS = {
   },
   conversion: {
     nameMax: 255,
-    // 365 is accepted only for the types in
-    // `CONVERSION_TYPES_ALLOWING_365_DAY_WINDOW`; enforced cross-field in
+    // 180 and 365 are accepted only for the types in
+    // `CONVERSION_TYPES_ALLOWING_LONG_WINDOWS`; enforced cross-field in
     // `conversionCreateSchema`, since the enum alone cannot express it.
-    postClickWindows: [1, 7, 30, 90, 365],
-    viewThroughWindows: [1, 7, 30, 90, 365]
+    postClickWindows: [1, 7, 30, 90, 180, 365],
+    viewThroughWindows: [1, 7, 30, 90, 180, 365]
   },
   leadForm: {
     nameMax: 256,
@@ -24006,12 +24006,14 @@ var CONVERSION_TYPES = [
   "VIEW_CONTENT",
   "VIEW_VIDEO"
 ];
-var CONVERSION_TYPES_ALLOWING_365_DAY_WINDOW = [
+var CONVERSION_TYPES_ALLOWING_LONG_WINDOWS = [
   "SUBMIT_APPLICATION",
   "PURCHASE",
   "ADD_TO_CART",
   "QUALIFIED_LEAD",
-  "LEAD"
+  "LEAD",
+  "MARKETING_QUALIFIED_LEAD",
+  "SALES_QUALIFIED_LEAD"
 ];
 var CONVERSION_METHODS = ["INSIGHT_TAG", "CONVERSIONS_API"];
 var ATTRIBUTION_TYPES = ["LAST_TOUCH_BY_CAMPAIGN", "LAST_TOUCH_BY_CONVERSION"];
@@ -24610,13 +24612,14 @@ var conversionCreateSchema = z7.object({
   urlMatchRuleExpression: z7.array(z7.array(z7.record(z7.string(), z7.string()))).optional(),
   associateAllCampaigns: z7.boolean().optional()
 }).superRefine((p, ctx) => {
-  const allowed365 = CONVERSION_TYPES_ALLOWING_365_DAY_WINDOW.includes(p.type);
+  const allowsLong = CONVERSION_TYPES_ALLOWING_LONG_WINDOWS.includes(p.type);
   for (const field of ["postClickAttributionWindowSize", "viewThroughAttributionWindowSize"]) {
-    if (p[field] === 365 && !allowed365) {
+    const days = p[field];
+    if (days !== void 0 && days > 90 && !allowsLong) {
       ctx.addIssue({
         code: "custom",
         path: [field],
-        message: `a 365-day window is only available for ${CONVERSION_TYPES_ALLOWING_365_DAY_WINDOW.join(", ")} \u2014 ${p.type} caps at 90`
+        message: `a ${days}-day window is only available for ${CONVERSION_TYPES_ALLOWING_LONG_WINDOWS.join(", ")} \u2014 ${p.type} caps at 90`
       });
     }
   }
@@ -24891,7 +24894,13 @@ var GOOGLE_ADS_LIMITS = {
     /** `campaign.url_custom_parameters` — Google caps a single entity at 8 `{_name}` parameters. */
     urlCustomParametersMax: 8,
     urlCustomParameterKeyMax: 16,
-    urlCustomParameterValueMax: 250
+    urlCustomParameterValueMax: 250,
+    /** `campaign.text_guidelines.term_exclusions` — words AI Max and Performance Max must never write. */
+    termExclusionsMax: 25,
+    termExclusionMax: 30,
+    /** `campaign.text_guidelines.messaging_restrictions` — freeform rules for generated text. */
+    messagingRestrictionsMax: 40,
+    messagingRestrictionMax: 300
   },
   adGroup: {
     nameMax: 255
@@ -25873,6 +25882,49 @@ var geoTargetTypeSettingSchema = z9.strictObject({
   (p) => p.positiveGeoTargetType !== void 0 || p.negativeGeoTargetType !== void 0,
   "geoTargetTypeSetting needs positiveGeoTargetType and/or negativeGeoTargetType"
 );
+var textGuidelinesSchema = z9.strictObject({
+  termExclusions: z9.array(z9.string().trim().min(1).max(GOOGLE_ADS_LIMITS.campaign.termExclusionMax)).max(GOOGLE_ADS_LIMITS.campaign.termExclusionsMax).optional(),
+  messagingRestrictions: z9.array(z9.string().trim().min(1).max(GOOGLE_ADS_LIMITS.campaign.messagingRestrictionMax)).max(GOOGLE_ADS_LIMITS.campaign.messagingRestrictionsMax).refine(
+    (rules) => new Set(rules.map((rule) => rule.toLowerCase())).size === rules.length,
+    "each messaging restriction must be unique"
+  ).optional()
+}).refine(
+  (p) => p.termExclusions !== void 0 || p.messagingRestrictions !== void 0,
+  "textGuidelines needs termExclusions and/or messagingRestrictions"
+);
+var AI_MAX_TEXT_NEEDS_AI_MAX_MESSAGE = "AI Max text customization only works with AI Max on: also turn AI Max on, or leave text customization off.";
+var AI_MAX_URL_NEEDS_TEXT_MESSAGE = "AI Max final URL expansion only works with text customization on: also turn text customization on, or leave URL expansion off.";
+var aiMaxSchema = z9.strictObject({
+  enabled: z9.boolean().optional(),
+  textCustomization: z9.boolean().optional(),
+  finalUrlExpansion: z9.boolean().optional()
+}).superRefine((p, ctx) => {
+  if (p.enabled === void 0 && p.textCustomization === void 0 && p.finalUrlExpansion === void 0) {
+    ctx.addIssue({ code: "custom", message: "aiMax needs enabled, textCustomization and/or finalUrlExpansion" });
+  }
+  if (p.enabled === false && p.textCustomization === true) {
+    ctx.addIssue({ code: "custom", path: ["textCustomization"], message: AI_MAX_TEXT_NEEDS_AI_MAX_MESSAGE });
+  }
+  if (p.textCustomization === false && p.finalUrlExpansion === true) {
+    ctx.addIssue({ code: "custom", path: ["finalUrlExpansion"], message: AI_MAX_URL_NEEDS_TEXT_MESSAGE });
+  }
+});
+var AI_MAX_SEARCH_ONLY_MESSAGE = "AI Max exists only on Search campaigns.";
+function aiMaxCreateRefusal(channelType, aiMax) {
+  if (!aiMax) {
+    return void 0;
+  }
+  if (channelType !== "SEARCH") {
+    return AI_MAX_SEARCH_ONLY_MESSAGE;
+  }
+  if (aiMax.enabled !== true && aiMax.textCustomization === true) {
+    return AI_MAX_TEXT_NEEDS_AI_MAX_MESSAGE;
+  }
+  if (aiMax.textCustomization !== true && aiMax.finalUrlExpansion === true) {
+    return AI_MAX_URL_NEEDS_TEXT_MESSAGE;
+  }
+  return void 0;
+}
 var campaignCreateSchema2 = z9.strictObject({
   name: z9.string().min(1).max(GOOGLE_ADS_LIMITS.campaign.nameMax),
   channelType: z9.enum(ADVERTISING_CHANNEL_TYPES),
@@ -25902,6 +25954,8 @@ var campaignCreateSchema2 = z9.strictObject({
    * every campaign create (FieldError.REQUIRED without it); omitted means it does not.
    */
   euPoliticalAds: z9.boolean().optional(),
+  /** AI Max for Search. A new campaign has it off unless this turns it on. */
+  aiMax: aiMaxSchema.optional(),
   status: stageableStatusSchema2.default("PAUSED")
 }).superRefine((p, ctx) => {
   if (!p.bidding && !p.biddingStrategy) {
@@ -25928,6 +25982,10 @@ var campaignCreateSchema2 = z9.strictObject({
   if (p.startDate && p.endDate && p.endDate <= p.startDate) {
     ctx.addIssue({ code: "custom", path: ["endDate"], message: "endDate must be after startDate" });
   }
+  const aiMaxRefusal = aiMaxCreateRefusal(p.channelType, p.aiMax);
+  if (aiMaxRefusal) {
+    ctx.addIssue({ code: "custom", path: ["aiMax"], message: aiMaxRefusal });
+  }
 });
 var campaignUpdateSchema2 = z9.strictObject({
   name: z9.string().min(1).max(GOOGLE_ADS_LIMITS.campaign.nameMax).optional(),
@@ -25946,6 +26004,10 @@ var campaignUpdateSchema2 = z9.strictObject({
   urlCustomParameters: urlCustomParametersSchema.optional(),
   /** Corrects the campaign's EU political advertising declaration (true = contains, false = does not). */
   euPoliticalAds: z9.boolean().optional(),
+  /** AI Max / Performance Max text guidelines. Google refuses them on a Search campaign without AI Max. */
+  textGuidelines: textGuidelinesSchema.optional(),
+  /** Turns AI Max or its features on or off. Search campaigns only (checked against the live channel). */
+  aiMax: aiMaxSchema.optional(),
   status: z9.enum(["ENABLED", "PAUSED", "REMOVED"]).optional()
 }).refine((p) => Object.values(p).some((v) => v !== void 0), "update needs at least one field");
 var adGroupCreateSchema = z9.strictObject({
@@ -49037,6 +49099,74 @@ function urlCustomParametersFromFlags(args8, rawArgs) {
     return { key: entry.slice(0, split), value: entry.slice(split + 1) };
   });
 }
+var aiMaxArgs = {
+  "ai-max": {
+    type: "boolean",
+    description: "AI Max for Search: --ai-max turns it on (Google then matches searches beyond your keywords), --ai-max=false turns it off along with its text customization and URL expansion. Search campaigns only."
+  },
+  "ai-max-text": {
+    type: "boolean",
+    description: "AI Max text customization: --ai-max-text lets Google write ad text from your landing page and ads (needs AI Max on); --ai-max-text=false stops it. Required before text guidelines."
+  },
+  "ai-max-url-expansion": {
+    type: "boolean",
+    description: "AI Max final URL expansion: --ai-max-url-expansion lets Google send clicks to the most relevant page of your site (needs text customization on); --ai-max-url-expansion=false keeps every click on your final URLs."
+  }
+};
+function aiMaxFromFlags(args8) {
+  const flag2 = (name) => typeof args8[name] === "boolean" ? args8[name] : void 0;
+  const aiMax = {
+    enabled: flag2("ai-max"),
+    textCustomization: flag2("ai-max-text"),
+    finalUrlExpansion: flag2("ai-max-url-expansion")
+  };
+  const stated = Object.entries(aiMax).filter(([, v]) => v !== void 0);
+  return stated.length > 0 ? Object.fromEntries(stated) : void 0;
+}
+var textGuidelinesArgs = {
+  "term-exclusion": {
+    type: "string",
+    description: `Text guidelines (AI Max Search and Performance Max): a word or phrase Google's generated ad text must never use, up to 30 characters (e.g. --term-exclusion "cheap"). Repeat for several; Google allows 25. REPLACES the campaign's whole list.`
+  },
+  "messaging-restriction": {
+    type: "string",
+    description: `Text guidelines (AI Max Search and Performance Max): a plain-language rule for Google's generated ad text, up to 300 characters (e.g. --messaging-restriction "Never promise a delivery date"). Repeat for several; Google allows 40. REPLACES the campaign's whole list.`
+  },
+  "clear-term-exclusions": {
+    type: "boolean",
+    description: "Remove every term exclusion from this campaign's text guidelines."
+  },
+  "clear-messaging-restrictions": {
+    type: "boolean",
+    description: "Remove every messaging restriction from this campaign's text guidelines."
+  }
+};
+function guidelineListFromFlags(args8, rawArgs, flag2, clearFlag) {
+  const values = repeatedValues(rawArgs, flag2, args8[flag2]).filter((v) => v.length > 0);
+  if (values.length === 0) {
+    return args8[clearFlag] === true ? [] : void 0;
+  }
+  if (args8[clearFlag] === true) {
+    failWriteValidation2(`--${clearFlag} removes the whole list \u2014 pass it OR --${flag2}, not both`);
+  }
+  return values;
+}
+function textGuidelinesFromFlags(args8, rawArgs) {
+  const termExclusions = guidelineListFromFlags(args8, rawArgs, "term-exclusion", "clear-term-exclusions");
+  const messagingRestrictions = guidelineListFromFlags(
+    args8,
+    rawArgs,
+    "messaging-restriction",
+    "clear-messaging-restrictions"
+  );
+  if (termExclusions === void 0 && messagingRestrictions === void 0) {
+    return void 0;
+  }
+  return {
+    ...termExclusions !== void 0 ? { termExclusions } : {},
+    ...messagingRestrictions !== void 0 ? { messagingRestrictions } : {}
+  };
+}
 var geoTargetTypeArgs = {
   "geo-target-type": {
     type: "string",
@@ -49188,6 +49318,7 @@ var campaignsCommand3 = defineCommand57({
         ...urlOptionsArgs,
         ...geoTargetTypeArgs,
         ...networksArg,
+        ...aiMaxArgs,
         objective: { type: "string", description: "Advisory UI objective (SALES, LEADS, \u2026)" },
         "start-date": { type: "string", description: "YYYY-MM-DD" },
         "end-date": { type: "string", description: "YYYY-MM-DD" },
@@ -49214,6 +49345,7 @@ var campaignsCommand3 = defineCommand57({
           startDate: args8["start-date"],
           endDate: args8["end-date"],
           euPoliticalAds: args8["eu-political-ads"],
+          aiMax: aiMaxFromFlags(args8),
           status: args8.status
         });
         await stageCreate("google.campaign.create", customerId, payload, [
@@ -49225,7 +49357,7 @@ var campaignsCommand3 = defineCommand57({
     update: defineCommand57({
       meta: {
         name: "update",
-        description: `Stage a change to an existing campaign's name, budget, bidding or settings. ${STAGED_WRITE}`
+        description: `Stage a change to an existing campaign's name, budget, bidding, settings, AI Max switches or text guidelines (what AI Max and Performance Max ad text must avoid). ${STAGED_WRITE}`
       },
       args: {
         ...customerIdArg,
@@ -49253,6 +49385,8 @@ var campaignsCommand3 = defineCommand57({
         ...urlOptionsArgs,
         ...geoTargetTypeArgs,
         ...networksArg,
+        ...textGuidelinesArgs,
+        ...aiMaxArgs,
         "eu-political-ads": {
           type: "boolean",
           description: "Corrects the campaign's EU political advertising declaration: --eu-political-ads if it contains EU political ads, --eu-political-ads=false if it does not. Existing campaigns without a declaration block location-targeting changes until one is set."
@@ -49283,6 +49417,8 @@ var campaignsCommand3 = defineCommand57({
           trackingUrlTemplate: args8["tracking-template"],
           urlCustomParameters: urlCustomParametersFromFlags(args8, rawArgs),
           euPoliticalAds: args8["eu-political-ads"],
+          textGuidelines: textGuidelinesFromFlags(args8, rawArgs),
+          aiMax: aiMaxFromFlags(args8),
           status: args8.status
         });
         await stageUpdate("google.campaign.update", customerId, target2, payload);
@@ -51079,6 +51215,7 @@ registerSchema({
         "company-size",
         "country",
         "region",
+        "dma",
         "device",
         "placement",
         "serving-location",
@@ -51720,8 +51857,16 @@ registerSchema({
       required: true
     },
     method: { type: "string", description: "INSIGHT_TAG|CONVERSIONS_API", required: true },
-    "post-click-window": { type: "string", description: "1|7|30|90 days", required: false },
-    "view-window": { type: "string", description: "1|7|30 days", required: false },
+    "post-click-window": {
+      type: "string",
+      description: "1|7|30|90 days; 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION",
+      required: false
+    },
+    "view-window": {
+      type: "string",
+      description: "1|7|30|90 days; 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION",
+      required: false
+    },
     "attribution-type": {
       type: "string",
       description: "LAST_TOUCH_BY_CAMPAIGN|LAST_TOUCH_BY_CONVERSION",
@@ -51742,8 +51887,16 @@ registerSchema({
     id: { type: "positional", description: "Conversion rule id or URN", required: true },
     ...writeAccountArgs,
     name: { type: "string", description: "New name", required: false },
-    "post-click-window": { type: "string", description: "1|7|30|90 days", required: false },
-    "view-window": { type: "string", description: "1|7|30 days", required: false },
+    "post-click-window": {
+      type: "string",
+      description: "1|7|30|90 days; 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION",
+      required: false
+    },
+    "view-window": {
+      type: "string",
+      description: "1|7|30|90 days; 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION",
+      required: false
+    },
     "attribution-type": { type: "string", description: "New attribution type", required: false },
     enabled: { type: "string", description: "on|off", required: false },
     file: { type: "string", description: "JSON file with fields to change", required: false }
@@ -52588,8 +52741,14 @@ Example: baker ads linkedin conversions create --name "Demo booked" --type LEAD
       description: "Conversion type. Common: LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, SIGN_UP, DOWNLOAD, PURCHASE, KEY_PAGE_VIEW, ADD_TO_CART, BOOK_APPOINTMENT, SUBMIT_APPLICATION, OTHER \u2014 `baker schema ads.linkedin.conversions.create` lists all 34"
     },
     method: { type: "string", description: "INSIGHT_TAG|CONVERSIONS_API" },
-    "post-click-window": { type: "string", description: "1|7|30|90 days (playbook default 30)" },
-    "view-window": { type: "string", description: "1|7|30 days (playbook default 7)" },
+    "post-click-window": {
+      type: "string",
+      description: "1|7|30|90 days (playbook default 30); 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION"
+    },
+    "view-window": {
+      type: "string",
+      description: "1|7|30|90 days (playbook default 7); 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION"
+    },
     "attribution-type": { type: "string", description: "LAST_TOUCH_BY_CAMPAIGN|LAST_TOUCH_BY_CONVERSION" },
     "associate-all-campaigns": { type: "boolean", description: "Auto-associate with active campaigns" },
     file: { type: "string", description: "JSON file with the full payload (e.g. urlMatchRuleExpression)" }
@@ -52618,8 +52777,14 @@ Example: baker ads linkedin conversions update 104988516 --post-click-window 30
     id: { type: "positional", description: "Conversion rule id or URN", required: true },
     ...accountArgs,
     name: { type: "string", description: "New name" },
-    "post-click-window": { type: "string", description: "1|7|30|90 days" },
-    "view-window": { type: "string", description: "1|7|30 days" },
+    "post-click-window": {
+      type: "string",
+      description: "1|7|30|90 days; 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION"
+    },
+    "view-window": {
+      type: "string",
+      description: "1|7|30|90 days; 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION"
+    },
     "attribution-type": { type: "string", description: "LAST_TOUCH_BY_CAMPAIGN|LAST_TOUCH_BY_CONVERSION" },
     enabled: { type: "string", description: "on|off" },
     file: { type: "string", description: "JSON file with fields to change" }
@@ -52965,7 +53130,8 @@ var MEMBER_PIVOTS = /* @__PURE__ */ new Set([
   "industry",
   "company-size",
   "country",
-  "region"
+  "region",
+  "dma"
 ]);
 var ALL_PIVOTS = [
   "none",
@@ -52982,6 +53148,7 @@ var ALL_PIVOTS = [
   "company-size",
   "country",
   "region",
+  "dma",
   "device",
   "placement",
   "serving-location",
@@ -53119,7 +53286,7 @@ var analyticsCommand = defineCommand62({
 Three-axis design (LinkedIn's superpower over Meta/Google):
   --level   account | campaign-group | campaign | creative
   --intent  baseline | revenue | funnel | engagement | video | lead-gen | inmail | document | ranking | identity
-  --pivot   none | job-title | company | industry | seniority | function | company-size | country | region
+  --pivot   none | job-title | company | industry | seniority | function | company-size | country | region | dma
             | device | placement | serving-location | card-index | objective
             | conversation-node | conversation-node-button
 
@@ -53127,6 +53294,8 @@ Smart defaults:
   --level account, --intent baseline, --pivot none, --granularity DAILY, last 7 days
   Pivot on a MEMBER_* dim \u2192 granularity auto-forced to ALL (LinkedIn rejects DAILY+demographic)
   Demographic data delayed 12-24h with \u22653-event privacy floor \u2014 the CLI flags this in warnings.
+  --pivot dma \u2192 US Nielsen DMA\xAE regions, names resolved. Any report built from it must write "DMA\xAE"
+  and carry Nielsen's notice (returned as the DMA_ATTRIBUTION_REQUIRED warning).
   Derived metrics injected client-side: ctr, cpc, cpm, frequency, leadCompletionRate
 
 Examples \u2014 common AI questions: