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
Avg Position	Avg Position	The average position of your property in Google Search results for the selected time period. This is an aggregated metric derived from the ‘position’ data.	metric
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 URL of the landing page where users arrived from a Google search.	dimension
Month	Month	The month of the year when the search performance data was recorded. This is derived from the ‘date’ dimension.	metric
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
Sum Clicks	Sum Clicks	The total number of clicks for the selected time period. This is an aggregated metric derived from the ‘clicks’ data.	metric
Sum Impressions	Sum Impressions	The total number of impressions for the selected time period. This is an aggregated metric derived from the ‘impressions’ data.	metric
Week	Week	The week of the year when the search performance data was recorded. This is derived from the ‘date’ dimension.	metric
Year	Year	The year when the search performance data was recorded. This is derived from the ‘date’ dimension.	metric
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 sum of clicks for a given period or dimension. This is an aggregated metric derived from the ‘clicks’ data.	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_code3	country_code3	The ISO 3166-1 alpha-3 country code for the country from which the search query originated. This is a dimension available in Search Analytics queries.	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
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
device_category	device_category	The category of device used by the user, such as mobile, desktop, or tablet.	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 sum of impressions for a given period or dimension. This is an aggregated metric derived from the ‘impressions’ data.	metric
indexStatusResult.coverageState	indexStatusResult.coverageState	The indexing status of the URL, indicating whether it’s indexed and any issues preventing it from being indexed. Part of the URL Inspection results.	dimension
indexStatusResult.crawledAs	indexStatusResult.crawledAs	The user agent type (e.g., desktop, mobile) that Google last used to crawl the URL. Part of the URL Inspection results.	dimension
indexStatusResult.googleCanonical	indexStatusResult.googleCanonical	The canonical URL chosen by Google for this page. Part of the URL Inspection results.	dimension
indexStatusResult.indexingState	indexStatusResult.indexingState	The overall state of indexing for the URL (e.g., ‘indexed’, ‘notIndexed’). Part of the URL Inspection results.	dimension
indexStatusResult.lastCrawlTime	indexStatusResult.lastCrawlTime	The timestamp of when the URL was last crawled by Google. Part of the URL Inspection results.	dimension
indexStatusResult.pageFetchState	indexStatusResult.pageFetchState	The result of the page fetch attempt by Google (e.g., ‘SUCCESSFUL’, ‘SOFT_404’). Part of the URL Inspection results.	dimension
indexStatusResult.referringUrls.{NUM}	indexStatusResult.referringUrls.{NUM}	A list of URLs that link to the inspected URL, which Google found. Part of the URL Inspection results.	dimension
indexStatusResult.robotsTxtState	indexStatusResult.robotsTxtState	The status of the robots.txt file that applies to the URL (e.g., ‘ALLOWED’, ‘BLOCKED’). Part of the URL Inspection results.	dimension
indexStatusResult.sitemap.{NUM}	indexStatusResult.sitemap.{NUM}	A list of sitemaps that refer to the inspected URL, or were used by Google to discover it. Part of the URL Inspection results.	dimension
indexStatusResult.userCanonical	indexStatusResult.userCanonical	The canonical URL declared by the user for this page, if any. Part of the URL Inspection results.	dimension
indexStatusResult.verdict	indexStatusResult.verdict	The overall verdict of the URL’s indexing status, summarizing its coverage and any issues. Part of the URL Inspection results.	dimension
inspectionResultLink	inspectionResultLink	A link to the full URL Inspection report in Google Search Console for the inspected URL.	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 inspected URL (e.g., ‘USABLE’, ‘NOT_USABLE’). Part of the URL Inspection results.	dimension
page	page	The URL of the page that appeared in Google Search results. This is a dimension available in Search Analytics queries.	dimension
page_url	page_url	The full URL of the specific page on your website that appeared in or was clicked from Google search results.	dimension
path	path	The relative path of the sitemap file or an internal URL path.	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}.issues.{NUM}.issueMessage	richResultsResult.detectedItems.{NUM}.items.{NUM}.issues.{NUM}.issueMessage	A detailed message describing an issue found within a specific rich result item on the inspected URL. Part of the URL Inspection results.	dimension
richResultsResult.detectedItems.{NUM}.items.{NUM}.issues.{NUM}.severity	richResultsResult.detectedItems.{NUM}.items.{NUM}.issues.{NUM}.severity	The severity level of an issue found within a rich result item (e.g., ‘ERROR’, ‘WARNING’). Part of the URL Inspection results.	dimension
richResultsResult.detectedItems.{NUM}.items.{NUM}.name	richResultsResult.detectedItems.{NUM}.items.{NUM}.name	The name of a specific rich result item detected on the inspected URL. Part of the URL Inspection results.	dimension
richResultsResult.detectedItems.{NUM}.richResultType	richResultsResult.detectedItems.{NUM}.richResultType	The type of rich result detected on the inspected URL (e.g., ‘Event’, ‘Product’). Part of the URL Inspection results.	dimension
richResultsResult.verdict	richResultsResult.verdict	The overall verdict on the rich results status of the inspected URL (e.g., ‘VALID’, ‘VALID_WITH_WARNINGS’, ‘INVALID’). Part of the URL Inspection results.	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
site_url	site_url	The base URL of the website property, as recognized by Google Search Console. Similar to ‘Site URL’.	dimension
submitted	submitted	The timestamp when the sitemap was first submitted to Google Search Console.	metric
timestamp	timestamp	The specific date and time when the search event occurred.	dimension
total_clicks_gsc	total_clicks_gsc	The total number of clicks from a Google search result to your website for the given dimensions.	metric
total_ctr_gsc	total_ctr_gsc	The Click-Through Rate (CTR) for the given dimensions, calculated as clicks divided by impressions. Values range from 0.0 to 1.0.	metric
total_impressions_gsc	total_impressions_gsc	The total number of times your website appeared in Google search results for the given dimensions.	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
website_url	website_url	The URL of the website property as defined and verified in Google Search Console.	dimension