@adkit/cli 1.12.12 → 1.12.14

package/dist/cli.js

@@ -1830,8 +1830,8 @@ 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", "raw"];
-var GOOGLE_KEYWORD_RESULTS_FLAGS = ["campaign", "ad-group", "period", "from", "to", "sort", "limit", "status", "raw"];
+var GOOGLE_RESULTS_FLAGS = ["campaign", "ad-group", "period", "from", "to", "sort", "limit", "status", "breakdown", "fields", "raw"];
+var GOOGLE_KEYWORD_RESULTS_FLAGS = ["campaign", "ad-group", "period", "from", "to", "sort", "limit", "status", "fields", "raw"];
 var KEYWORD_RESEARCH_FLAGS = ["url", "location", "language", "limit", "min-volume"];
 var TARGETING_RESEARCH_FLAGS = ["limit"];
 function generateCampaignName2() {
@@ -2560,17 +2560,27 @@ async function detachNegativeList(client, args, flags) {
   const path3 = `/manage/google/keywords/negative-lists/detach${qs}`;
   return client.post(path3, body);
 }
-function inferGoogleResultsLevel(campaignId, adGroupId) {
+function parseGoogleResultsLevelArg(args) {
+  const [rawLevel, ...unexpectedArgs] = args;
+  if (!rawLevel) return void 0;
+  const level = rawLevel.trim().toLowerCase();
+  if (level !== "campaigns" && level !== "ad-groups" && level !== "ads") throw new CliError("UNKNOWN_COMMAND", `Unknown action: google results ${rawLevel}`, "Available: campaigns, ad-groups, ads, keywords, placements, search-terms");
+  if (unexpectedArgs.length > 0) throw new CliError("UNKNOWN_COMMAND", `Unknown argument after google results ${rawLevel}: ${unexpectedArgs.join(" ")}`, `Run: adkit manage google results ${level} --help`);
+  return level;
+}
+function inferGoogleResultsLevel(campaignId, adGroupId, explicitLevel) {
+  if (explicitLevel) return explicitLevel;
   if (adGroupId) return "ad-groups";
   if (campaignId) return "campaigns";
   return void 0;
 }
-async function listGoogleResults(client, _args, flags) {
+async function listGoogleResults(client, args, flags) {
   validateFlags(flags, GOOGLE_RESULTS_FLAGS, "manage google results");
   const accountId = typeof flags.account === "string" ? flags.account : 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 level = inferGoogleResultsLevel(campaignId, adGroupId);
+  const explicitLevel = parseGoogleResultsLevelArg(args);
+  const level = inferGoogleResultsLevel(campaignId, adGroupId, explicitLevel);
   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;
@@ -3952,6 +3962,7 @@ var require2 = createRequire(import.meta.url);
 var CLI_VERSION = require2("../package.json").version;
 var DEFAULT_BASE_URL = "https://app.adkit.so/api/v1";
 var GOOGLE_NUMERIC_ID_PATTERN = /^\d+$/;
+var GOOGLE_RESULTS_LEVEL_ACTIONS = /* @__PURE__ */ new Set(["campaigns", "ad-groups", "ads"]);
 var TIKTOK_NUMERIC_ID_PATTERN = /^\d+$/;
 var USAGE = `
 Usage: adkit <command> [options]
@@ -5016,6 +5027,9 @@ var GOOGLE_NEGATIVE_LIST_HELP_FULL = GOOGLE_NEGATIVE_LIST_HELP;
 var GOOGLE_RESULTS_HELP = `adkit manage google results \u2014 Google Ads performance analytics
 
   [default]           Account-wide or filtered performance metrics
+  campaigns           One row per campaign
+  ad-groups           One row per ad group
+  ads                 One row per ad
   keywords            Keyword-level spend, clicks, impressions per keyword
   placements          Placement report: websites, apps, and YouTube
   search-terms        Search terms that triggered your ads
@@ -5029,19 +5043,26 @@ Flags:
   --sort <field>      Sort by: cost, clicks, impressions, conversions (default: cost)
   --limit <n>         Max results
   --status <s>        Filter: enabled, paused, all
-  --breakdown <b>     Split rows by: day, device, network (For placements, use "results placements")
-  --fields <list>    Response fields, e.g. cost,clicks,searchImpressionShare. Competitive metrics are opt-in.
+  --breakdown <b>     Split rows by: day, device, network. For campaign/ad-group/ad rows, use the level subcommands above.
+  --fields <list>     Response fields, e.g. cost,clicks,searchImpressionShare. Omit for default advertiser metrics; use all for every supported field.
   --raw               Return raw Google API response
   --account <id>      Optional if one Google Ads account is connected
 
-Competitive metrics (opt-in via --fields):
+Default metrics include:
+  Cost/clicks/conversions, CPA, CVR, ROAS, all conversions, view-through conversions,
+  top-position rates, search impression share where Google supports it, and serving/learning status.
+
+Visibility fields:
   Search: searchImpressionShare, searchRankLostImpressionShare, searchBudgetLostImpressionShare,
-          searchTopImpressionShare, searchAbsoluteTopImpressionShare, searchClickShare
-  Content: contentImpressionShare, contentRankLostImpressionShare, contentBudgetLostImpressionShare
+          searchTopImpressionShare, searchAbsoluteTopImpressionShare, searchClickShare (default where supported)
+  Content: contentImpressionShare, contentRankLostImpressionShare, contentBudgetLostImpressionShare (use --fields all)
   Note: search fields available at all levels except ads. Content fields not available at keywords or ads.
 
 Examples:
   adkit manage google results
+  adkit manage google results campaigns --account 1234567890 --period 30d
+  adkit manage google results ad-groups --campaign 123 --period 30d
+  adkit manage google results ads --campaign 123 --period 30d
   adkit manage google results keywords --account 1234567890 --period 7d
   adkit manage google results --campaign 123 --period 7d
   adkit manage google results --campaign 123 --period 7d --breakdown day
@@ -5049,7 +5070,7 @@ Examples:
   adkit manage google results placements --campaign 123 --period 30d
   adkit manage google results --period this_month --sort clicks --limit 20
   adkit manage google results search-terms --campaign 123 --period 30d
-  adkit manage google results --campaign 123 --fields default,searchImpressionShare,searchBudgetLostImpressionShare`;
+  adkit manage google results --campaign 123 --fields all`;
 var GOOGLE_RESULTS_PLACEMENTS_HELP = `adkit manage google results placements \u2014 Google placement report
 
   Shows each website, app, or YouTube placement where ads appeared.
@@ -5112,12 +5133,13 @@ Flags:
   --sort <field>      Sort by: cost (default), clicks, impressions, conversions, ctr, cpc
   --status <s>        Filter: enabled, paused, all (default: all)
   --limit <n>         Max results
-  --fields <list>    Response fields, e.g. cost,clicks,qualityScore,searchImpressionShare
+  --fields <list>    Response fields, e.g. cost,clicks,qualityScore,searchImpressionShare. Omit for default advertiser metrics.
   --raw               Return raw Google API response
 
-  Search competitive fields also available at keyword level:
-    searchImpressionShare, searchRankLostImpressionShare, searchBudgetLostImpressionShare,
-    searchTopImpressionShare, searchAbsoluteTopImpressionShare, searchClickShare
+  Default keyword metrics include CPA, CVR, ROAS, search impression share, search lost impression share,
+  search click share, primary serving/learning status, and Quality Score diagnostics.
+  Extra keyword diagnostics are available with --fields all, including:
+    systemServingStatus, approvalStatus, firstPageCpc, topOfPageCpc, firstPositionCpc
 
 Examples:
   adkit manage google results keywords --account 1234567890 --period 7d
@@ -5125,7 +5147,7 @@ Examples:
   adkit manage google results keywords --account 1234567890 --campaign 987654321 --period this_month
   adkit manage google results keywords --account 1234567890 --period last_month --fields cost,clicks,qualityScore
   adkit manage google results keywords --account 1234567890 --period 7d --fields default,primaryStatus
-  adkit manage google results keywords --account 1234567890 --period 30d --fields default,searchImpressionShare`;
+  adkit manage google results keywords --account 1234567890 --period 30d --fields all`;
 var GOOGLE_RESEARCH_HELP = `adkit manage google research \u2014 Google Ads research tools
 
   keywords <query>    Get keyword ideas from Google Keyword Planner
@@ -7080,7 +7102,10 @@ async function main() {
             } else if (action === "keywords") {
               data = await listGoogleKeywordResults(client, restArgs, flags);
               emptyHint = "No keyword results found. Try a wider date range or check --status.";
-            } else if (action) throw new CliError("UNKNOWN_COMMAND", `Unknown action: google results ${action}`, "Available: keywords, placements, search-terms");
+            } else if (action && GOOGLE_RESULTS_LEVEL_ACTIONS.has(action.toLowerCase())) {
+              data = await listGoogleResults(client, [action, ...restArgs], flags);
+              emptyHint = "No Google results found for the given level. Try a wider date range or remove filters.";
+            } else if (action) throw new CliError("UNKNOWN_COMMAND", `Unknown action: google results ${action}`, "Available: campaigns, ad-groups, ads, keywords, placements, search-terms");
             else data = await listGoogleResults(client, restArgs, flags);
             break;
           }

package/package.json

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