Field reference

Search Console: four metrics, every angle.

The Search Console dataset is small and unforgiving: four metrics, a handful of dimensions, and everything a keyword ranking report can say comes from crossing them.

Fields
18
Data source
Google Search Console
Names
Standard API

See them live in the Google Search Console Dashboard for Data Studio.

Metrics

FieldAPI nameTypeWhat it measures
ClicksclicksmetricCount of clicks from Google search results that landed on the property.
ImpressionsimpressionsmetricHow many times a result from the property appeared in search results a user viewed.
CTRctrmetricClicks divided by impressions, per row of whatever dimension you group by.
PositionpositionmetricAverage topmost position of the property for the row, across every impression.

Dimensions

FieldAPI nameTypeWhat it measures
QueryquerydimensionThe search terms users typed. Some rare queries are omitted for privacy.
PagepagedimensionThe URL that appeared in results (the canonical URL, as Google resolves it).
CountrycountrydimensionCountry the search was made from, as an ISO code.
DevicedevicedimensionDesktop, mobile or tablet.
DatedatedimensionDay of the impression, in the property’s local time (Pacific).
Search appearancesearchAppearancedimensionRich-result type the listing appeared as (e.g. review snippet, FAQ) when applicable.
Search typetypedimensionWeb, image, video or news search; reports default to web.

Computed in the template

FieldAPI nameTypeWhat it measures
Brand vs genericbrand_genericdimensionEach query classified as brand (contains your brand terms) or generic, so brand demand is never mistaken for SEO growth.
Keyword length typekeyword_lengthdimensionShort tail (1 to 3 words) or long tail (4 or more), with the word count as its own breakdown.
Search intentsearch_intentdimensionInformational, navigational, commercial or transactional, inferred from the query wording.
Keyword clusterkeyword_clusterdimensionQueries grouped by the topic they belong to, so a topic can be tracked as one line instead of a hundred queries.
Position bucketposition_bucketdimensionTop 3, positions 4 to 10, 11 to 20, or 21 and beyond: the distribution that moves before total clicks do.
Keywords countkeywords_countmetricDistinct queries with at least one impression in the period (unique keywords).
Impression shareimpression_sharemetricA country’s impressions as a share of the total, on the location page.

Reading the four together

The four metrics only speak when crossed with a dimension: clicks by query shows what earns traffic, impressions by page shows what earns visibility, and position by date shows movement. The classic diagnostic is CTR against position: a query ranking well with a weak CTR has a snippet problem, and that reading needs both metrics on the same row, which is exactly what a report table gives you and the Search Console interface makes you assemble by hand.