Impression Share Analysis

IMPRESSION SHARE analysis — for Search campaigns, your impression share, top-of-page and absolute-top share, exact-match share, and whether the loss is due to BUDGET or RANK (bid/quality) + DISAPPROVED (blocked) ads.

level: 'campaign' (default) | 'ad_group' | 'keyword' — where the share is measured. level='ad_group' or 'keyword' shows EXACTLY which ad groups/keywords lose the auction on rank; lost_to_budget only exists at campaign level (budget is a campaign setting), so it is omitted at the finer levels.

COMPETITOR-LEVEL AUCTION INSIGHTS ARE NOT AVAILABLE: which rival domains outrank you (overlap rate, position above rate, outranking share per competitor) is NOT retrievable through the Google Ads API — those fields exist in the schema but Google marks them 'not publicly available' and rejects the query with METRIC_ACCESS_DENIED for every third-party app, this one included. Competitor auction insights are not available to third-party apps in the Google Ads API; they are in the Google Ads UI → Campaigns → Insights → Auction insights (exportable as CSV). This tool returns the account's own share and where it is lost; competitor_ads (Google Ads Transparency Center) returns rivals' live ad copy. Every share and disapproved-ad record is retained in the single `rows` collection (`record_type` distinguishes them): `limit` controls only this response page and `page_token=next_page_token` reads the cached continuation without another Google Ads query or credit. Read-only.