Google Search Console

Note:

• Google Search Console data isn't available in the real-time API.

• For the data to be available, set up the Google Search Console integration in Menu > Analytics > Settings > Integrations.

Metrics

Here’s a list of metrics that are available in Piwik PRO when you use Google Search Console integration.

search_engine_average_position

NameAverage position (search engine)
ScopesGoogle Search Console
AvailabilityQuery API
Typefloat

search_engine_clicks

NameClicks (search engine)
ScopesGoogle Search Console
AvailabilityQuery API
Typeint

search_engine_ctr

NameCTR (search engine)
ScopesGoogle Search Console
AvailabilityQuery API
Typefloat

search_engine_impressions

NameImpressions (search engine)
ScopesGoogle Search Console
AvailabilityQuery API
Typeint

Dimensions

Here’s a list of dimensions that are available in Piwik PRO when you use Google Search Console integration.

device_type

NameDevice type
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Type[int, str]
Database typeuint8
Nullabletrue
Notesdevice_type.json

location_continent_iso_code

NameContinent
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Type[str, str]
Database typestring(2)
Nullabletrue
Noteslocation_continent_iso_code.json

location_country_name

NameCountry
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Type[str, str]
Database typestring
Nullabletrue
NotesISO 3166-2 codes (e.g. “PL”)

medium

NameMedium
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Typestr_nocase
Database typestring
Nullablefalse

referrer_type

NameChannel
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Type[int, str]
Database typeuint8
Nullablefalse
Notesreferrer_type.json

referrer_url

NameReferrer URL
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Typestr
Database typestring
Nullablefalse

search_engine_keyword

NameSearch engine keyword
ScopesGoogle Search Console
AvailabilityQuery API
Typestr
Database typestring
Nullablefalse

session_entry_url

NameSession entry URL
Scopesevent, product, session
AvailabilityQuery API, Raw data API
Typestr
Database typestring
Nullablefalse

source

NameSource
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Typestr_nocase
Database typestring
Nullablefalse

source_medium

NameSource / medium
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Typestr_nocase
Database typestring
Nullablefalse

timestamp

NameDate
Scopesevent, product, session
AvailabilityReal-time, Query API
Typedate
Database typenot applicable
Nullablefalse
Notesserver time in the website’s time zone

website_name

NameSite or app name
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Type[str, str]
Database typenot applicable
Nullablefalse
Noteswebsite UUID

Note:

The Database type column displays the source type associated with each dimension. For the enum dimensions, it displays the ID type. For the not applicable source type, this column represents a dynamic dimension.

Mixed queries

You can request both internal analytics and Google Search Console metrics in a single query, for example Sessions and Clicks (search engine). However, only the common dimensions listed below can be used in these queries.

Here’s a list of the dimensions that you can use.

device_type

NameDevice type
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Type[int, str]
Database typeuint8
Nullabletrue
Notesdevice_type.json

location_continent_iso_code

NameContinent
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Type[str, str]
Database typestring(2)
Nullabletrue
Noteslocation_continent_iso_code.json

location_country_name

NameCountry
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Type[str, str]
Database typestring
Nullabletrue
NotesISO 3166-2 codes (e.g. “PL”)

medium

NameMedium
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Typestr_nocase
Database typestring
Nullablefalse

referrer_type

NameChannel
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Type[int, str]
Database typeuint8
Nullablefalse
Notesreferrer_type.json

referrer_url

NameReferrer URL
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Typestr
Database typestring
Nullablefalse

session_entry_url

NameSession entry URL
Scopesevent, product, session
AvailabilityQuery API, Raw data API
Typestr
Database typestring
Nullablefalse

source

NameSource
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Typestr_nocase
Database typestring
Nullablefalse

source_medium

NameSource / medium
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Typestr_nocase
Database typestring
Nullablefalse

timestamp

NameDate
Scopesevent, product, session
AvailabilityReal-time, Query API
Typedate
Database typenot applicable
Nullablefalse
Notesserver time in the website’s time zone

website_name

NameSite or app name
Scopesevent, product, session
AvailabilityReal-time, Query API, Raw data API
Type[str, str]
Database typenot applicable
Nullablefalse
Noteswebsite UUID

Note:

• The Database type column displays the source type associated with each dimension. For the enum dimensions, it displays the ID type. For the not applicable source type, this column represents a dynamic dimension.

• Using dimensions not listed in the table above as query columns or filters will result in a Bad Request response.