@adkit/cli 1.12.27 → 1.12.29

package/dist/cli.js

@@ -2999,9 +2999,12 @@ function buildTikTokAdCreative(flags) {
   if (isSparkAd && flags["media-id"] !== void 0) throw new CliError("INVALID_VALUE", "Use --existing-post-id or --media-id, not both", "Spark Ads promote an existing post; drop --media-id, or drop --existing-post-id to upload a video");
   const hasCreativeFlag = ["media-id", "ad-text", "url", "cta", "display-name", "identity-id", "identity-type", "tracking-pixel"].some((key) => flags[key] !== void 0);
   if (!hasCreativeFlag && !isSparkAd) return void 0;
-  const creative = {
-    url: requireFlag(flags, "url", "Provide the destination URL for the ad")
-  };
+  const creative = {};
+  if (isSparkAd) {
+    if (typeof flags.url === "string" && flags.url.trim()) creative.url = flags.url.trim();
+  } else {
+    creative.url = requireFlag(flags, "url", "Provide the destination URL for the ad");
+  }
   if (isSparkAd) {
     if (typeof flags["ad-text"] === "string") creative.adText = flags["ad-text"];
   } else {
@@ -4570,7 +4573,7 @@ Flags:
   --from <date>       Start date, YYYY-MM-DD
   --to <date>         End date, YYYY-MM-DD
   --fields <list>     Normalized fields, e.g. spend, impressions, clicks, conversionEvents, etc
-  --conversion-event-keys <list> purchase,lead or all
+  --conversion-event-keys <list> purchase,lead,messaging_conversation_started or all
   --attribution-window <w>  1d_click, 7d_click, 1d_view, 7d_click_1d_view, 28d_click_1d_view
   --breakdowns <list> day, week, month, age, gender, country, region, device_platform, publisher_platform, platform_position, impression_device
   --confirm           Required with --period maximum plus any breakdown
@@ -4593,6 +4596,8 @@ Examples:
   adkit manage meta results ads --period maximum --breakdowns country --confirm
   # Conversion data for a campaign
   adkit manage meta results --campaign-ids 123 --conversion-event-keys purchase,lead
+  # Messenger conversations for click-to-Messenger campaigns
+  adkit manage meta results --campaign-ids 123 --conversion-event-keys messaging_conversation_started
   # Raw API response with custom metrics
   adkit manage meta results --campaign-ids 123 --raw --fields spend,impressions,conversionEvents`.trim();
 var CREATIVE_HELP = `adkit manage meta creatives \u2014 Meta ad creatives
@@ -5617,14 +5622,14 @@ ${FLAG.data}
   --media-id <id>     TikTok video ID from tiktok media upload
   --existing-post-id <id> Spark Ad: promote an existing organic post instead of an uploaded video (needs a BC_AUTH_TT identity)
   --ad-text <text>    Ad text
-  --url <url>         Destination URL
+  --url <url>         Destination URL (required with --media-id; optional with --existing-post-id)
   --cta <type>        learn_more, shop_now, sign_up, download, contact_us, apply_now, book_now
   --identity-id <id>  TikTok profile/identity ID (falls back to account default)
   --identity-type <t> TikTok identity type
 
 Examples:
   adkit manage tiktok ads create --ad-group 1770 --name "Hero video" --media-id v123 --ad-text "Try it today" --url https://example.com --cta learn_more
-  adkit manage tiktok ads create --ad-group 1770 --name "Spark Ad" --existing-post-id 7412 --url https://example.com --cta learn_more
+  adkit manage tiktok ads create --ad-group 1770 --name "Spark Ad" --existing-post-id 7412
   adkit manage tiktok ads update 1770000000000000000 --status paused --publish`.trim(),
   "tiktok results": `adkit manage tiktok results \u2014 TikTok performance reporting
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adkit/cli",
-  "version": "1.12.27",
+  "version": "1.12.29",
   "description": "The Ads CLI for AI agents — manage Meta & Google ad campaigns, browse the ad library, and generate creatives from your terminal.",
   "keywords": [
     "ads cli",