@adsuploader/cli 0.1.4 → 0.1.7

package/SKILL.md

@@ -308,6 +308,34 @@ Top-level CTA applies to all ads (overridden by per-ad CTA):
 }
 ```
 
+### URL Split-Test (LP A/B)
+
+Provide 2–5 destination URLs under `texts.urlVariants` and every generated ad set is duplicated once per URL so Meta optimizes each ad+LP combination independently (Barry Hott's method — don't split traffic inside one ad).
+
+```json
+{
+  "texts": {
+    "common": { "headlines": ["Hero"], "bodies": ["Copy"] },
+    "urlVariants": [
+      { "link": "https://example.com/homepage", "label": "homepage" },
+      { "link": "https://example.com/quiz", "label": "quiz-v2" }
+    ]
+  }
+}
+```
+
+- `label` is optional; when omitted, the last URL path slug is used (`/quiz-v2` → `quiz-v2`), falling back to hostname for root URLs.
+- Naming depends on ad set mode:
+  - `single`: each variant's label becomes the full ad set name.
+  - `perUpload` / `autoGroup`: each duplicated ad set name is `{base}-{label}`, or substitutes a `{destination}` token if present in the pattern.
+  - Explicit `adSet.groups[]`: use `{group}` (aliases: `{name}`, `{base}`, `{adset}`) in `adSet.namePattern` to reference `groups[i].name`.
+  - Variation grouping: use `{variation}` in `adSet.namePattern` to reference the filename prefix before `variationIdentifier`.
+- The `{date}` token resolves to today's date in labels (`launch-{date}` → `launch-2026-04-27`).
+- Each destination URL must be distinct. Trailing-slash and case variants of the same URL collapse to one — supply at least 2 truly different destinations.
+- Your ad set budget is multiplied by the number of variants.
+- Not compatible with per-ad `link` overrides — the variant URL wins when both are set.
+- Rejected with a 400 ConfigError if the source ad (preset or `copyFromAd`) targets a special destination (lead form, Messenger, WhatsApp, Instagram DM, Call) — those formats don't route via `cta.link`.
+
 **Standard CTA types:** `LEARN_MORE`, `SHOP_NOW`, `SIGN_UP`, `SUBSCRIBE`, `GET_OFFER`, `CONTACT_US`, `DOWNLOAD`, `ORDER_NOW`, `BUY_NOW`, `BOOK_NOW`, `APPLY_NOW`, `GET_QUOTE`, `GET_IN_TOUCH`, `WATCH_MORE`
 
 **Objective-specific CTAs** (inherited from template ad — do not set manually):
@@ -338,7 +366,7 @@ When cherry-picking features, only list ones relevant to the media type. `video_
 
 ### Carousel Ads
 
-Group uploaded files into carousel ads with per-card text:
+Group uploaded files into carousel ads with per-card text and optional overall carousel text. `cardTexts` controls individual cards. Overall carousel text can be colocated on the carousel object or set in `texts.perAd` using the carousel `name`; colocated fields win when both are present.
 
 ```json
 {
@@ -346,6 +374,12 @@ Group uploaded files into carousel ads with per-card text:
     {
       "name": "My Carousel",
       "cards": ["slide1.jpg", "slide2.jpg", "slide3.jpg"],
+      "headlines": ["Overall Carousel Headline"],
+      "bodies": ["Overall primary text"],
+      "descriptions": ["Overall description"],
+      "cta": "SHOP_NOW",
+      "link": "https://example.com/carousel",
+      "urlTags": "utm_content=my_carousel",
       "cardTexts": [
         { "headline": "Slide 1", "description": "First card", "link": "https://example.com/1" },
         { "headline": "Slide 2", "description": "Second card", "link": "https://example.com/2" }
@@ -355,6 +389,31 @@ Group uploaded files into carousel ads with per-card text:
 }
 ```
 
+Alternative overall-text shape:
+
+```json
+{
+  "texts": {
+    "perAd": {
+      "My Carousel": {
+        "headlines": ["Overall Carousel Headline"],
+        "bodies": ["Overall primary text"],
+        "descriptions": ["Overall description"],
+        "cta": "SHOP_NOW",
+        "link": "https://example.com/carousel",
+        "urlTags": "utm_content=my_carousel"
+      }
+    }
+  },
+  "carousel": [
+    {
+      "name": "My Carousel",
+      "cards": ["slide1.jpg", "slide2.jpg", "slide3.jpg"]
+    }
+  ]
+}
+```
+
 Cards must reference filenames from the upload batch. Minimum 2 cards per carousel. Files claimed by a carousel are removed from the standard ad list.
 
 ### Flexible Ads
@@ -374,13 +433,39 @@ Group multiple assets into a single flexible ad (Meta picks the best asset per p
 
 Minimum 2 assets per group. Files claimed by a flexible group are removed from the standard ad list.
 
+### Multi Media Ads
+
+Group 2-10 uploaded images or videos into a Meta Multi Media ad:
+
+```json
+{
+  "multimedia": [
+    {
+      "name": "Mixed Media Ad",
+      "assets": ["hero.jpg", "promo.mp4", "banner.jpg"],
+      "assetTexts": [
+        {
+          "headline": "Hero headline",
+          "primaryText": "Hero primary text",
+          "description": "Hero description",
+          "link": "https://example.com/hero",
+          "displayUrl": "example.com/hero"
+        }
+      ]
+    }
+  ]
+}
+```
+
+Assets must reference filenames from the upload batch. `assetTexts` is optional and lines up with `assets` by index; each field is a single override for that asset and blank fields fall back to the ad's main text and URLs. The primary rendered asset uses the ad's main text and URL, and any primary asset text override becomes the first main text option. Videos need a cached public thumbnail URL from upload processing. Files claimed by a Multi Media group are removed from the standard ad list.
+
 ### Ad Naming
 
 ```json
 { "adNamePattern": "{filename} - {date}" }
 ```
 
-Placeholders: `{filename}`, `{index:01}`, `{variation}`, `{campaign}`, `{date}`, `{date:short}`, `{timestamp}`
+Placeholders: `{filename}`, `{index:01}`, `{variation}`, `{group}`, `{adset}`, `{campaign}`, `{date}`, `{date:short}`, `{timestamp}`
 
 ### Options
 

package/dist/cli.cjs

@@ -5002,6 +5002,7 @@ async function stageFiles(paths, opts) {
       uploadedFiles.push({
         name: file.name,
         type: file.type,
+        size: file.size,
         fileKey: r2Info.fileKey
       });
     } catch (err) {
@@ -5030,6 +5031,7 @@ async function processAndPrint(client, batchId, uploadedFiles, jsonMode) {
       const result = await client.uploads.process(batchId, {
         name: file.name,
         type: file.type,
+        size: file.size,
         fileKey: file.fileKey
       });
       results.push(result);
@@ -5331,7 +5333,7 @@ async function executeCreate(body, opts, { preview = false, test = false } = {})
         statusStr += import_picocolors11.default.dim(` (${levelLabel})`);
       }
       let enhLabel = "";
-      if (result.enhancements === "metaDefaults") enhLabel = import_picocolors11.default.dim("Meta Defaults");
+      if (result.enhancements === "metaDefaults") enhLabel = import_picocolors11.default.dim("All Off");
       else if (result.enhancements === "all") enhLabel = import_picocolors11.default.dim("All On");
       else if (result.enhancements === "none") enhLabel = import_picocolors11.default.dim("All Off");
       else if (Array.isArray(result.enhancements)) enhLabel = import_picocolors11.default.dim(`${result.enhancements.length} custom`);
@@ -5386,18 +5388,29 @@ async function executeCreate(body, opts, { preview = false, test = false } = {})
         const sharedCta = allCtas.length > 0 && allCtas.every((c) => c === allCtas[0]) ? allCtas[0] : null;
         const maxText = 80;
         const trunc = (s) => s.length > maxText ? s.slice(0, maxText - 1) + "\u2026" : s;
+        let lastDetailAdSet = null;
+        const distinctAdSets = new Set(result.ads.map((a) => a.adSetName).filter(Boolean));
+        const showAdSetHeaders = distinctAdSets.size > 1;
         for (const ad of result.ads) {
+          if (showAdSetHeaders && ad.adSetName && ad.adSetName !== lastDetailAdSet) {
+            if (lastDetailAdSet !== null) console.log("");
+            console.log(`  ${import_picocolors11.default.dim("\u25B8 Ad Set:")} ${import_picocolors11.default.bold(ad.adSetName)}`);
+            lastDetailAdSet = ad.adSetName;
+          }
           const typeLabel = ad.mediaType ? import_picocolors11.default.dim(` [${ad.mediaType}]`) : "";
-          console.log(`  ${import_picocolors11.default.bold(import_picocolors11.default.blue(ad.name))}${typeLabel}`);
+          const indent = showAdSetHeaders ? "    " : "  ";
+          const fieldIndent = showAdSetHeaders ? "      " : "    ";
+          const fieldIndentLen = fieldIndent.length;
+          console.log(`${indent}${import_picocolors11.default.bold(import_picocolors11.default.blue(ad.name))}${typeLabel}`);
           const headline = (ad.headline || []).join(" | ");
           const primary = (ad.primaryText || []).join(" | ");
           const desc = (ad.description || []).join(" | ");
-          if (headline) console.log(`    ${import_picocolors11.default.dim("Headline:")}      ${trunc(headline)}`);
-          if (primary) console.log(`    ${import_picocolors11.default.dim("Primary Text:")}  ${trunc(primary)}`);
-          if (desc) console.log(`    ${import_picocolors11.default.dim("Description:")}   ${trunc(desc)}`);
-          if (ad.cta && !sharedCta) console.log(`    ${import_picocolors11.default.dim("CTA:")}           ${ad.cta}`);
-          if (ad.link && !sharedLink) console.log(`    ${import_picocolors11.default.dim("Link:")}          ${wrapLine(ad.link, 4)}`);
-          if (ad.urlTags && !sharedUrlTags) console.log(`    ${import_picocolors11.default.dim("URL Tags:")}     ${wrapLine(ad.urlTags, 4)}`);
+          if (headline) console.log(`${fieldIndent}${import_picocolors11.default.dim("Headline:")}      ${trunc(headline)}`);
+          if (primary) console.log(`${fieldIndent}${import_picocolors11.default.dim("Primary Text:")}  ${trunc(primary)}`);
+          if (desc) console.log(`${fieldIndent}${import_picocolors11.default.dim("Description:")}   ${trunc(desc)}`);
+          if (ad.cta && !sharedCta) console.log(`${fieldIndent}${import_picocolors11.default.dim("CTA:")}           ${ad.cta}`);
+          if (ad.link && !sharedLink) console.log(`${fieldIndent}${import_picocolors11.default.dim("Link:")}          ${wrapLine(ad.link, fieldIndentLen)}`);
+          if (ad.urlTags && !sharedUrlTags) console.log(`${fieldIndent}${import_picocolors11.default.dim("URL Tags:")}     ${wrapLine(ad.urlTags, fieldIndentLen)}`);
           console.log("");
         }
         const valCol = 18;
@@ -5797,14 +5810,12 @@ async function interactiveCreate(client) {
   const enhancementsChoice = await ve({
     message: "Creative enhancements",
     options: [
-      { value: "meta", label: "Use Meta Defaults (recommended)" },
-      { value: "none", label: "No enhancements" }
+      { value: "none", label: "No enhancements (recommended)" },
+      { value: "all", label: "All enhancements" }
     ]
   });
   if (pD(enhancementsChoice)) process.exit(0);
-  if (enhancementsChoice !== "meta") {
-    body.creativeEnhancements = "none";
-  }
+  body.creativeEnhancements = enhancementsChoice;
   const status = await ve({
     message: "Launch status",
     options: [
@@ -5929,7 +5940,7 @@ function statusLabel(status) {
 }
 
 // src/cli.js
-var VERSION = true ? "0.1.4" : "0.0.0";
+var VERSION = true ? "0.1.7" : "0.0.0";
 var apiUrl = process.env.ADS_API_URL || getBaseUrl();
 if (apiUrl && (apiUrl.includes("localhost") || apiUrl.includes("127.0.0.1"))) {
   process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adsuploader/cli",
-  "version": "0.1.4",
+  "version": "0.1.7",
   "description": "Create Facebook ads from the command line — bulk upload media, preview configurations, and launch ads at scale",
   "author": "Ads Uploader <support@adsuploader.com> (https://adsuploader.com)",
   "license": "UNLICENSED",