Google Search Console: Setup guide#
This guide explains how to collect data from Google Search Console.
Limitations#
Collecting data from Google Search Console comes with the following limitations:
Google Search Console keeps data for the last 16 months. You cannot fetch older data.
Data is available in Google Search Console approximately 48 hours after it is collected by Google Search Console.
The
searchAppearance
dimension, cannot be used with any other dimensions.The
hour
dimension retrieves data for up to 10 latest days with an hourly breakdown. No data can be retrieved for dates beyond the 10 day lookback window.
Creating a datastream to collect data from Google Search Console#
The basics of creating a datastream to collect data from any data source are explained in our guide to Collecting data in Adverity. This guide contains information about the specific steps to create a datastream to fetch data from Google Search Console.
Configuration: Choose the data you want to collect from Google Search Console#
To choose what data to collect and customize the Google Search Console datastream configuration, follow these steps:
(Optional) Rename your datastream.
In Report type, select the type of data to collect from Google Search Console.
In Site URLs, select the websites for which to collect data. If you do not select any items in a drop-down list, Adverity collects data for all items in the drop-down list.
In Dimensions, change the list of fields that you want to see in your data extract.
Note
For information on configuring other Google Search Console fields, see Advanced Google Search Console tips.
What’s next?#
Apply Data Mapping to your collected data to harmonize data collected from different sources in Adverity.
Transform your data to meet your needs by creating and applying transformations to your datastream.
Load your data into Explore & Present to visualize your data in Adverity.
Load your data into an external destination of your choice.
Advanced Google Search Console tips#
Configuring data collection from Google Search Console#
In the Settings tab of your Google Search Console datastream overview, you can configure a number of additional settings:
- Search type
Select the Google search type for which to collect data. This option only has an effect if you select Search Analytics in the Report type field.
- Aggregation type
To specify how Adverity aggregates the collected data, select one of the following options:
(Default) Select Auto (Let the service decide) to let Google Search Console decide the appropriate aggregation type.
Select Aggregate values by URI to aggregate data by page.
Select Aggregate values by property to aggregate data by property.
For more information on aggregating Google Search Console data, see the Google documentation.
- Filters
To include only specific dimension values in the data extract, specify dimension filters in JSON format. You can use the operators
contains
,equals
,notContains
,notEquals
. For more information, see the Google documentation.An example is shown below.
[ { "dimension": "column1", "operator": "notContains", "expression": "value1" }, { "dimension": "column1", "operator": "notContains", "expression": "value2" }, { "dimension": "column2", "operator": "contains", "expression": "value3" } ]
- Include preliminary data
Select this checkbox to collect the most recent data which has not yet been confirmed. This is usually data from the last three days. For more information, see the Google documentation.
- Include fresh data (not finalized yet)
Select this checkbox to include fresh (not finalized) data. This setting is ignored when the
hour
dimension is selected, as hourly data may be partial.
Discrepancies between totals#
When you specify dimensions in your data collection from Google Search Console and later aggregate the values, the totals might be different from the totals you would see if you collected data without specifying dimensions. For more information, see the Google documentation.