@adkit/cli 1.12.19 → 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,7 +1831,7 @@ 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", "resource", "campaign", "ad-group"];
 var KEYWORD_RESEARCH_FLAGS = ["url", "location", "language", "limit", "min-volume"];
@@ -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) {
@@ -4047,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
@@ -4670,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):
@@ -5098,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
 
@@ -5121,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
@@ -5577,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
 
@@ -5599,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(),
@@ -5617,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}
@@ -6106,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.19",
+  "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",