@adkit/cli 1.13.12 → 1.13.13

package/dist/cli.js

@@ -6096,22 +6096,34 @@ ${FLAG.data}
   --campaign-ids <ids> Comma-separated campaign IDs for filtered reads
   --campaign <id>     Parent campaign ID (create only)
   --name <name>       Ad group name
-  --status <s>        active, paused
+  --status <s>        active, paused (create default: paused)
   --budget-daily <n>  Daily budget in account currency
   --budget-lifetime <n> Lifetime budget in account currency
   --start-date <value> Optional TikTok schedule datetime; omit to start now
   --end-date <value>   Optional TikTok schedule datetime; required with lifetime budget
   --billing-event <s> cpc, cpm, ocpm
   --bid-strategy <s>  bid_type_no_bid, bid_type_custom, bid_type_max_conversion
-  --optimization <s>  click, convert, lead_generation, video_view, reach
+  --optimization <s>  click, convert, lead_generation, video_view, reach, value
   --bid-amount <n>    Custom bid in account currency; conversion/OCPM maps to cost per conversion
   --event-type <s>    purchase, add_to_cart, view_content, complete_registration, lead, submit_form
   --pixel <id>        Pixel ID; falls back to account default pixel when conversion is used
   --placement <ids>   Override TikTok placement IDs (publish default: PLACEMENT_TIKTOK)
 
+Value Optimization (website):
+  --optimization value bids on purchase value. It needs --event-type purchase plus a pixel (--pixel, or the account default), and rejects --bid-strategy, --bid-amount, and any --billing-event other than ocpm.
+  targetRoas has no flag \u2014 send it with --data. targetRoas set = Minimum ROAS (0.01-1000, where 1.5 = 150%); targetRoas omitted = Highest Value.
+  update only retunes targetRoas on an ad group that already uses Value Optimization. TikTok cannot move an ordinary ad group onto it \u2014 create a new ad group instead.
+  TikTok checks account and pixel eligibility, so a valid payload can still be rejected at publish.
+
 Examples:
   adkit manage tiktok ad-groups create --campaign 1770 --name "US Broad" --budget-daily 50 --billing-event cpc --optimization click
-  adkit manage tiktok ad-groups create --data '{"adGroups":[{"campaignId":"1770","name":"Purchase","budget":{"daily":50},"startDate":"2026-05-15 12:00:00","bidAmount":80,"conversion":{"eventType":"purchase"},"targeting":{"geoLocations":{"include":[{"type":"country","country":"US"}]}}}]}'`.trim(),
+  adkit manage tiktok ad-groups create --data '{"adGroups":[{"campaignId":"1770","name":"Purchase","budget":{"daily":50},"startDate":"2026-05-15 12:00:00","bidAmount":80,"conversion":{"eventType":"purchase"},"targeting":{"geoLocations":{"include":[{"type":"country","country":"US"}]}}}]}'
+  # Highest Value
+  adkit manage tiktok ad-groups create --campaign 1770 --name "Highest value" --budget-daily 50 --optimization value --event-type purchase
+  # Minimum ROAS 1.5x
+  adkit manage tiktok ad-groups create --data '{"adGroups":[{"campaignId":"1770","name":"Min ROAS 1.5x","budget":{"daily":50},"optimization":"value","targetRoas":1.5,"conversion":{"eventType":"purchase"}}]}'
+  # Retune the ROAS target on an existing Value Optimization ad group
+  adkit manage tiktok ad-groups update 1770000000000000000 --data '{"targetRoas":2}'`.trim(),
   "tiktok ads": `adkit manage tiktok ads \u2014 TikTok video ads
 
   list                List ads

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adkit/cli",
-  "version": "1.13.12",
+  "version": "1.13.13",
   "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",