@adkit/cli 1.12.18 → 1.12.20

package/dist/cli.js

@@ -1815,8 +1815,8 @@ var ASSET_CREATE_FLAGS = ["type", "text", "sitelink", "header", "value", "descri
 var ASSET_LINK_FLAGS = ["type", "scope", "scope-id", "status"];
 var MEDIA_UPLOAD_FLAGS = ["file", "url", "base64", "adkit-media", "filename", "content-type", "name"];
 var CAMPAIGN_LIST_FLAGS = ["status", "limit", "offset"];
-var CAMPAIGN_CREATE_FLAGS = ["name", "status", "budget-daily", "campaign-type", "bid-strategy", "search-partners", "display-network", "tracking-url-suffix", "countries"];
-var CAMPAIGN_UPDATE_FLAGS = ["name", "status", "budget-daily", "bid-strategy", "search-partners", "display-network", "tracking-url-suffix", "countries"];
+var CAMPAIGN_CREATE_FLAGS = ["name", "status", "budget-daily", "campaign-type", "bid-strategy", "target-cpa", "target-roas", "search-partners", "display-network", "tracking-url-suffix", "countries"];
+var CAMPAIGN_UPDATE_FLAGS = ["name", "status", "budget-daily", "bid-strategy", "target-cpa", "target-roas", "search-partners", "display-network", "tracking-url-suffix", "countries"];
 var AD_GROUP_LIST_FLAGS = ["campaign", "status", "limit", "offset"];
 var AD_GROUP_FLAGS = ["campaign", "name", "status", "cpc-bid"];
 var AD_LIST_FLAGS = ["ad-group", "status", "policy-status", "limit", "offset"];
@@ -1831,9 +1831,9 @@ var NEGATIVE_LIST_LIST_FLAGS = ["status", "limit", "offset"];
 var NEGATIVE_LIST_ATTACH_FLAGS = ["campaign"];
 var SEARCH_TERMS_FLAGS = ["campaign", "ad-group", "keyword", "keyword-match-type", "period", "from", "to", "min-impressions", "sort", "limit", "raw"];
 var PLACEMENT_REPORT_FLAGS = ["campaign", "ad-group", "period", "from", "to", "sort", "limit", "raw"];
-var GOOGLE_RESULTS_FLAGS = ["campaign", "ad-group", "period", "from", "to", "sort", "limit", "status", "breakdown", "fields", "raw"];
+var GOOGLE_RESULTS_FLAGS = ["campaign", "ad-group", "period", "from", "to", "sort", "limit", "status", "breakdown", "fields", "conversion-actions", "raw"];
 var GOOGLE_KEYWORD_RESULTS_FLAGS = ["campaign", "ad-group", "period", "from", "to", "sort", "limit", "status", "fields", "raw"];
-var CHANGE_HISTORY_FLAGS = ["account", "period", "from", "to", "limit"];
+var CHANGE_HISTORY_FLAGS = ["account", "period", "from", "to", "limit", "resource", "campaign", "ad-group"];
 var KEYWORD_RESEARCH_FLAGS = ["url", "location", "language", "limit", "min-volume"];
 var TARGETING_RESEARCH_FLAGS = ["limit"];
 function generateCampaignName2() {
@@ -1975,6 +1975,8 @@ function buildCampaignPayload2(flags) {
   if (typeof flags["campaign-type"] === "string") payload.campaignType = flags["campaign-type"];
   if (typeof flags["budget-daily"] === "string") payload.budget = { daily: Number.parseFloat(flags["budget-daily"]) };
   if (typeof flags["bid-strategy"] === "string") payload.bidStrategy = flags["bid-strategy"];
+  if (typeof flags["target-cpa"] === "string") payload.targetCpa = Number.parseFloat(flags["target-cpa"]);
+  if (typeof flags["target-roas"] === "string") payload.targetRoas = Number.parseFloat(flags["target-roas"]);
   if (flags["search-partners"] === true) payload.searchPartners = true;
   if (flags["display-network"] === true) payload.displayNetwork = true;
   if (typeof flags["tracking-url-suffix"] === "string") payload.trackingUrlSuffix = flags["tracking-url-suffix"];
@@ -1992,6 +1994,8 @@ function buildCampaignUpdatePayloadFromFlags(flags) {
   if (typeof flags.status === "string") payload.status = flags.status;
   if (typeof flags["budget-daily"] === "string") payload.budget = { daily: Number.parseFloat(flags["budget-daily"]) };
   if (typeof flags["bid-strategy"] === "string") payload.bidStrategy = flags["bid-strategy"];
+  if (typeof flags["target-cpa"] === "string") payload.targetCpa = Number.parseFloat(flags["target-cpa"]);
+  if (typeof flags["target-roas"] === "string") payload.targetRoas = Number.parseFloat(flags["target-roas"]);
   if (flags["search-partners"] === true) payload.searchPartners = true;
   if (flags["display-network"] === true) payload.displayNetwork = true;
   if (typeof flags["tracking-url-suffix"] === "string") payload.trackingUrlSuffix = flags["tracking-url-suffix"];
@@ -2623,8 +2627,9 @@ async function listGoogleResults(client, args, flags) {
   const fieldsFlag = typeof flags.fields === "string" ? flags.fields.trim() : "";
   const fields = fieldsFlag ? fieldsFlag : void 0;
   if (typeof flags.fields === "string") delete flags.fields;
+  const conversionActions = flags["conversion-actions"] === true ? "true" : void 0;
   const raw = flags.raw === true ? "true" : void 0;
-  const qs = queryString({ accountId, level, campaignId, adGroupId, period, from, to, sort, limit, status: status2, breakdown, fields, raw });
+  const qs = queryString({ accountId, level, campaignId, adGroupId, period, from, to, sort, limit, status: status2, breakdown, fields, conversionActions, raw });
   return client.get(`/manage/google/results${qs}`);
 }
 function buildSearchTermsQuery(flags) {
@@ -2670,7 +2675,10 @@ async function listGoogleChangeHistory(client, _args, flags) {
   const period = typeof flags.period === "string" ? flags.period : void 0;
   const from = typeof flags.from === "string" ? flags.from : void 0;
   const to = typeof flags.to === "string" ? flags.to : void 0;
-  const qs = buildGoogleListQuery(flags, { period, from, to });
+  const resource = typeof flags.resource === "string" ? flags.resource : void 0;
+  const campaignId = typeof flags.campaign === "string" ? flags.campaign : void 0;
+  const adGroupId = typeof flags["ad-group"] === "string" ? flags["ad-group"] : void 0;
+  const qs = buildGoogleListQuery(flags, { period, from, to, resource, campaignId, adGroupId });
   const path3 = `/manage/google/change-history${qs}`;
   return client.get(path3);
 }
@@ -4044,6 +4052,10 @@ var FLAG = {
   budgetDaily: "  --budget-daily <n>  Daily budget in account currency",
   cta: "  --cta <type>        sign_up, learn_more, shop_now, download, get_offer, contact_us, subscribe, get_quote, book_now, apply_now"
 };
+var RAW_PLATFORM_LABELS = { google: "Google", meta: "Meta", reddit: "Reddit", tiktok: "TikTok" };
+function rawPlatformCommandLine(platform2) {
+  return `Raw ${RAW_PLATFORM_LABELS[platform2] ?? platform2} API calls use the shared command: adkit manage platform-api-requests --platform ${platform2} ...`;
+}
 var CAMPAIGN_HELP = `adkit manage meta campaigns \u2014 Meta ad campaigns
 
   list                List campaigns
@@ -4667,12 +4679,16 @@ Flags (create):
   --budget-daily <n>  Daily budget in account currency
   --campaign-type <type>    search, display, performance_max (performance_max needs --data for asset groups)
   --bid-strategy <s>  manual_cpc, manual_cpm, maximize_clicks, maximize_conversions, maximize_conversion_value, target_spend, target_impression_share
+  --target-cpa <n>    Target CPA in account currency (with --bid-strategy maximize_conversions)
+  --target-roas <n>   Target ROAS ratio, e.g. 3.5 = 350% (with --bid-strategy maximize_conversion_value)
 
 Flags (update):
   --name <name>       Campaign name
   --status <s>        enabled, paused
   --budget-daily <n>  Daily budget in account currency
   --bid-strategy <s>  Change bidding strategy
+  --target-cpa <n>    Target CPA in account currency. Send alone to retune the existing maximize_conversions target
+  --target-roas <n>   Target ROAS ratio (3.5 = 350%). Send alone to retune the existing target, incl. Performance Max
   --countries <codes> Replace included countries, e.g. US,CA
 
 Flags (list):
@@ -5095,6 +5111,8 @@ Flags:
   --status <s>        Filter: enabled, paused, all
   --breakdown <b>     Split rows by: day, device, network, hour, geo. Hour/geo support account, campaigns, ad-groups.
   --fields <list>     Response fields, e.g. cost,clicks,searchImpressionShare. Omit for default advertiser metrics; use all for every supported field.
+  --conversion-actions
+                      Add conversionEvents per row, grouped by Google conversion action. Costs one extra Google read call.
   --raw               Return raw Google API response
   --account <id>      Optional if one Google Ads account is connected
 
@@ -5118,6 +5136,7 @@ Examples:
   adkit manage google results --campaign 123 --period 7d
   adkit manage google results --campaign 123 --period 7d --breakdown day
   adkit manage google results --campaign 123 --period 7d --breakdown device
+  adkit manage google results campaigns --period 30d --conversion-actions
   adkit manage google results campaigns --period 7d --breakdown hour
   adkit manage google results campaigns --period 30d --breakdown geo
   adkit manage google results placements --campaign 123 --period 30d
@@ -5137,6 +5156,9 @@ Flags:
   --from <date>       Start date (YYYY-MM-DD, requires --to). Window must be <= 30 days and within the last 30 days.
   --to <date>         End date (YYYY-MM-DD, requires --from)
   --limit <n>         Max changes (default: 50, max: 10000)
+  --resource <type>   campaign | ad-group | ad | keyword
+  --campaign <id>     Filter to changes affecting one campaign
+  --ad-group <id>     Filter to changes affecting one ad group
 
 Each record:
   time, resourceType, resourceName, operation (create | update | remove),
@@ -5148,6 +5170,8 @@ Note:
 
 Examples:
   adkit manage google change-history list --period 7d
+  adkit manage google change-history list --period 7d --resource campaign
+  adkit manage google change-history list --period 7d --campaign 123456789
   adkit manage google change-history list --period 30d --limit 200
   adkit manage google change-history list --from 2026-06-01 --to 2026-06-15`;
 var GOOGLE_RESULTS_PLACEMENTS_HELP = `adkit manage google results placements \u2014 Google placement report
@@ -5569,6 +5593,7 @@ ${FLAG.publish}
 ${FLAG.data}
 
 Mutations are draft-first by default. Use --publish to publish immediately.
+${rawPlatformCommandLine("meta")}
 Run adkit manage meta <group> --help for details.`.trim(),
   google: `adkit manage google \u2014 Google Ads management
 
@@ -5591,6 +5616,7 @@ ${FLAG.publish}
 ${FLAG.data}
 
 Mutations are draft-first by default. Use --publish to publish immediately.
+${rawPlatformCommandLine("google")}
 Display path: research topics/interests, upload images with google media, create campaigns --campaign-type display, create ad-groups with targeting, then create ads with type:"responsive_display".
 Google Display Ads is in beta \u2014 some first-class normalized Display features may not be available yet.
 Run adkit manage google <group> --help for details.`.trim(),
@@ -5609,14 +5635,14 @@ ${FLAG.account}
 ${FLAG.publish}
 ${FLAG.data}
 
+${rawPlatformCommandLine("tiktok")}
 Run adkit manage tiktok <group> --help for details.`.trim(),
   reddit: `adkit manage reddit \u2014 Reddit Ads management
 
 Entity groups:
   accounts            List and connect Reddit ad accounts
 
-Raw Reddit Ads API access is available through:
-  adkit manage platform-api-requests --platform reddit ...
+${rawPlatformCommandLine("reddit")}
 
 General flags:
 ${FLAG.account}
@@ -6098,9 +6124,12 @@ ${titleParts.join(" \xB7 ")}`);
         const parts = [];
         const count = num(val, "count");
         const cost = num(val, "costPerResult") ?? num(val, "cost");
+        const label = str(val, "label") ?? humanizeAction(key);
         if (count !== void 0) parts.push(fmtNum(count));
         if (cost !== void 0) parts.push(`${fmtCurrency(cost, currency)} each`);
-        if (parts.length > 0) console.log(`  ${humanizeAction(key).padEnd(14)}${parts.join(" \xB7 ")}`);
+        const labelColumn = label.padEnd(14);
+        const metricText = parts.join(" \xB7 ");
+        if (parts.length > 0) console.log(`  ${labelColumn}${metricText}`);
       }
     }
     const aq = nested(row, "ad_quality");

package/package.json

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