@adkit/cli 1.12.12 → 1.12.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/cli.js +15 -10
  2. package/package.json +1 -1
package/dist/cli.js CHANGED
@@ -5030,14 +5030,18 @@ Flags:
5030
5030
  --limit <n> Max results
5031
5031
  --status <s> Filter: enabled, paused, all
5032
5032
  --breakdown <b> Split rows by: day, device, network (For placements, use "results placements")
5033
- --fields <list> Response fields, e.g. cost,clicks,searchImpressionShare. Competitive metrics are opt-in.
5033
+ --fields <list> Response fields, e.g. cost,clicks,searchImpressionShare. Omit for default advertiser metrics; use all for every supported field.
5034
5034
  --raw Return raw Google API response
5035
5035
  --account <id> Optional if one Google Ads account is connected
5036
5036
 
5037
- Competitive metrics (opt-in via --fields):
5037
+ Default metrics include:
5038
+ Cost/clicks/conversions, CPA, CVR, ROAS, all conversions, view-through conversions,
5039
+ top-position rates, search impression share where Google supports it, and serving/learning status.
5040
+
5041
+ Visibility fields:
5038
5042
  Search: searchImpressionShare, searchRankLostImpressionShare, searchBudgetLostImpressionShare,
5039
- searchTopImpressionShare, searchAbsoluteTopImpressionShare, searchClickShare
5040
- Content: contentImpressionShare, contentRankLostImpressionShare, contentBudgetLostImpressionShare
5043
+ searchTopImpressionShare, searchAbsoluteTopImpressionShare, searchClickShare (default where supported)
5044
+ Content: contentImpressionShare, contentRankLostImpressionShare, contentBudgetLostImpressionShare (use --fields all)
5041
5045
  Note: search fields available at all levels except ads. Content fields not available at keywords or ads.
5042
5046
 
5043
5047
  Examples:
@@ -5049,7 +5053,7 @@ Examples:
5049
5053
  adkit manage google results placements --campaign 123 --period 30d
5050
5054
  adkit manage google results --period this_month --sort clicks --limit 20
5051
5055
  adkit manage google results search-terms --campaign 123 --period 30d
5052
- adkit manage google results --campaign 123 --fields default,searchImpressionShare,searchBudgetLostImpressionShare`;
5056
+ adkit manage google results --campaign 123 --fields all`;
5053
5057
  var GOOGLE_RESULTS_PLACEMENTS_HELP = `adkit manage google results placements \u2014 Google placement report
5054
5058
 
5055
5059
  Shows each website, app, or YouTube placement where ads appeared.
@@ -5112,12 +5116,13 @@ Flags:
5112
5116
  --sort <field> Sort by: cost (default), clicks, impressions, conversions, ctr, cpc
5113
5117
  --status <s> Filter: enabled, paused, all (default: all)
5114
5118
  --limit <n> Max results
5115
- --fields <list> Response fields, e.g. cost,clicks,qualityScore,searchImpressionShare
5119
+ --fields <list> Response fields, e.g. cost,clicks,qualityScore,searchImpressionShare. Omit for default advertiser metrics.
5116
5120
  --raw Return raw Google API response
5117
5121
 
5118
- Search competitive fields also available at keyword level:
5119
- searchImpressionShare, searchRankLostImpressionShare, searchBudgetLostImpressionShare,
5120
- searchTopImpressionShare, searchAbsoluteTopImpressionShare, searchClickShare
5122
+ Default keyword metrics include CPA, CVR, ROAS, search impression share, search lost impression share,
5123
+ search click share, primary serving/learning status, and Quality Score diagnostics.
5124
+ Extra keyword diagnostics are available with --fields all, including:
5125
+ systemServingStatus, approvalStatus, firstPageCpc, topOfPageCpc, firstPositionCpc
5121
5126
 
5122
5127
  Examples:
5123
5128
  adkit manage google results keywords --account 1234567890 --period 7d
@@ -5125,7 +5130,7 @@ Examples:
5125
5130
  adkit manage google results keywords --account 1234567890 --campaign 987654321 --period this_month
5126
5131
  adkit manage google results keywords --account 1234567890 --period last_month --fields cost,clicks,qualityScore
5127
5132
  adkit manage google results keywords --account 1234567890 --period 7d --fields default,primaryStatus
5128
- adkit manage google results keywords --account 1234567890 --period 30d --fields default,searchImpressionShare`;
5133
+ adkit manage google results keywords --account 1234567890 --period 30d --fields all`;
5129
5134
  var GOOGLE_RESEARCH_HELP = `adkit manage google research \u2014 Google Ads research tools
5130
5135
 
5131
5136
  keywords <query> Get keyword ideas from Google Keyword Planner
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@adkit/cli",
3
- "version": "1.12.12",
3
+ "version": "1.12.13",
4
4
  "description": "The Ads CLI for AI agents — manage Meta & Google ad campaigns, browse the ad library, and generate creatives from your terminal.",
5
5
  "keywords": [
6
6
  "ads cli",