Google Search Console: Most-used fields

Google Search Console: Most-used fields#

The table below gives information about most-used fields that you can import from Google Search Console. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name

Adverity UI name

Description

Use in Adverity

Date

Date

The specific date for which search performance data is reported, in YYYY-MM-DD format. This is a time dimension available in Search Analytics queries.

dimension

End Date

End Date

The end date of the requested date range for data retrieval, in YYYY-MM-DD format. This is a required parameter for Search Analytics queries.

dimension

Landing Page

Landing Page

The specific URL of a page on your website that users landed on after clicking a search result. This corresponds to the ‘page’ dimension in Search Analytics.

dimension

Site URL

Site URL

The URL of the website property as defined in Google Search Console. This is a primary identifier for fetching data from Search Console APIs.

dimension

Start Date

Start Date

The start date of the requested date range for data retrieval, in YYYY-MM-DD format. This is a required parameter for Search Analytics queries.

dimension

clicks

clicks

The number of clicks from a Google Search results page to your property. This is a core metric returned by Search Analytics queries.

metric

clicks_sum

clicks_sum

The total number of clicks from Google Search results for the specified dimension(s) within the selected date range.

metric

country

country

The name of the country from which the search query originated. This is a dimension available in Search Analytics queries.

dimension

country_code

country_code

The country from which the search query originated. Data is grouped by this dimension to show geographic performance.

dimension

ctr

ctr

The click-through rate, calculated as clicks divided by impressions, from a Google Search results page to your property. This is a core metric returned by Search Analytics queries.

metric

day

day

The specific date for which the search performance data is reported. Data can be grouped by date to analyze trends over time.

dimension

device

device

The device type (e.g., desktop, mobile, tablet) used for the search query. This is a dimension available in Search Analytics queries.

dimension

errors

errors

A list of errors detected for a sitemap entry or during URL inspection. For sitemaps, this indicates issues with the sitemap itself or the URLs it contains.

metric

impressions

impressions

The number of times your property appeared in Google Search results. This is a core metric returned by Search Analytics queries.

metric

impressions_sum

impressions_sum

The total number of times your website appeared in Google Search results for the specified dimension(s) within the selected date range.

metric

indexStatusResult.coverageState

indexStatusResult.coverageState

The current indexing status and reasons why a page might or might not be indexed by Google. Examples include ‘Indexed, not submitted in sitemap’ or ‘URL is not on Google’.

dimension

indexStatusResult.crawledAs

indexStatusResult.crawledAs

Indicates the Googlebot user-agent type (e.g., desktop, mobile) that was used to crawl the URL.

dimension

indexStatusResult.googleCanonical

indexStatusResult.googleCanonical

The URL that Google has selected as the canonical version for this page.

dimension

indexStatusResult.indexingState

indexStatusResult.indexingState

The overall indexing status of the URL, indicating whether it’s allowed to be indexed or if there are blocking issues.

dimension

indexStatusResult.lastCrawlTime

indexStatusResult.lastCrawlTime

The date and time when Google last crawled the inspected URL.

dimension

indexStatusResult.pageFetchState

indexStatusResult.pageFetchState

The result of Google’s attempt to fetch the URL, such as ‘SUCCESSFUL’ or ‘SOFT_404’.

dimension

indexStatusResult.referringUrls.{NUM}

indexStatusResult.referringUrls.{NUM}

A list of URLs that link to or refer to the inspected URL.

dimension

indexStatusResult.robotsTxtState

indexStatusResult.robotsTxtState

Indicates whether the URL is allowed or disallowed to be crawled by Googlebot according to the site’s robots.txt file.

dimension

indexStatusResult.userCanonical

indexStatusResult.userCanonical

The URL that the website owner has declared as the canonical version of the page.

dimension

indexStatusResult.verdict

indexStatusResult.verdict

The overall verdict on the URL’s indexing status, such as ‘PASS’ or ‘FAIL’.

dimension

inspectionResultLink

inspectionResultLink

A direct link to the URL Inspection tool in Google Search Console for the inspected URL, providing a detailed report within the UI.

dimension

isPending

isPending

Indicates if a sitemap is currently pending processing by Google.

dimension

isSitemapsIndex

isSitemapsIndex

Indicates if the submitted sitemap is a sitemap index file, which points to other sitemaps.

dimension

lastDownloaded

lastDownloaded

The timestamp when Google last downloaded the sitemap.

dimension

lastSubmitted

lastSubmitted

The timestamp when the sitemap was last submitted to Google Search Console.

dimension

mobileUsabilityResult.verdict

mobileUsabilityResult.verdict

The overall verdict on the mobile usability of the URL, indicating whether it’s ‘PASS’ or ‘FAIL’.

dimension

page

page

The URL of the page that appeared in Google Search results. This is a dimension available in Search Analytics queries.

dimension

path

path

The full URL of a page on your website, as reported by Google Search Console. This field is used as a dimension in search performance reports to analyze metrics like clicks and impressions for individual pages.

dimension

position

position

The average position of your property in Google Search results. This is a core metric returned by Search Analytics queries.

metric

query

query

The actual search query (keywords) entered by the user that resulted in an impression or click for your property. This is a dimension available in Search Analytics queries.

dimension

richResultsResult.detectedItems.{NUM}.items.{NUM}.name

richResultsResult.detectedItems.{NUM}.items.{NUM}.name

The name of a specific rich result item detected on the page (e.g., a product’s name, a recipe’s title).

dimension

richResultsResult.detectedItems.{NUM}.richResultType

richResultsResult.detectedItems.{NUM}.richResultType

The type of rich result detected on the page, such as ‘Product’ or ‘Recipe’, indicating structured data found.

dimension

richResultsResult.verdict

richResultsResult.verdict

The overall verdict on the rich results status for the URL, indicating whether detected rich results are valid (‘PASS’) or have issues (‘FAIL’).

dimension

searchAppearance

searchAppearance

The specific type of rich result or appearance in Google Search results (e.g., ‘AMP_BLUE_BADGE’, ‘JOB_LISTING’). This is a dimension available in Search Analytics queries.

dimension

submitted

submitted

The timestamp when the sitemap was first submitted to Google Search Console.

metric

type

type

The type of the sitemap (e.g., ‘WEB’, ‘VIDEO’, ‘IMAGE’) or the search type (e.g., ‘web’, ‘image’) for Search Analytics queries.

dimension

warnings

warnings

A list of warnings detected for a sitemap entry or during URL inspection, indicating non-critical issues.

metric