Lens

Google Search Console Source

Pull organic search clicks, impressions, CTR and average position from Google Search Console into a Lens table, per day, broken down by query, page, country, device or search appearance.

Before you start

  • The Search Console property, exactly as Search Console names it. A URL-prefix property looks like https://www.example.com/; a Domain property looks like sc-domain:example.com. They are different properties, so use the one you report on.
  • A Google service account connection under Security & Access. Add a connection, choose Service Account, set Provider to Google, paste the JSON key into Service Account Key (JSON) and click Save Connection.
  • Access on the property. In Search Console, open Settings > Users and permissions and add the service account's email address as a user on that exact property.
Why a service account

The Google sign-in connection asks Google for Analytics, Tag Manager and Ads access, not Search Console. A service account that has been added to the property is the dependable choice.

If you leave Google Connection on None (use default service account), Lens uses the shared TagPipes service account. That only works once its email address has been added to your property; ask TagPipes support for the address.

Create the table

  1. Go to Configure > Data Tables, click + New Table, and choose Google Search Console.
  2. Enter a Table Name, such as "Organic Search Performance".
  3. Pick your service account under Google Connection.
  4. Enter the Property (Site URL), or click Browse to list the properties the connection can see and pick one.
  5. Click Test. Lens checks that the connection can read Search Analytics data for that property, not only see it.

Choose what to pull

SettingOptionsDefaultNotes
Search TypeWeb, Image, Video, News, Discover, Google NewsWebOne search type per table
Data StateFinal (only finalized), All (incl. fresh)FinalFinal is recommended
AggregationAuto, By Property, By PageAutoCounts differ by aggregation. Domain properties usually use By Property

Under Dimensions, tick any of Query, Page, Country, Device and Search Appearance. Date is always included, so leaving every box clear gives one row per day.

Search Appearance cannot be combined with any other dimension; Search Console does not allow it. Put it on its own table.

Metrics

The metrics are fixed and always included: Clicks, Impressions, CTR and Average Position. Lens stores clicks and impressions as counts and works out CTR and average position when a board adds rows up, so totals across days, pages or queries stay correct instead of averaging per-row rates.

Query rows do not add up to site totals

Search Console hides low-volume queries for privacy. A table that includes Query will total less than your site's real clicks and impressions. For trustworthy totals, use a table with date only, or date and page.

Set the date range and sync mode

SettingDefaultNotes
Backfill PeriodLast 90 daysUp to Last 16 months (max), which is roughly what Search Console keeps
Sync ModeIncrementalIncremental re-pulls a trailing window and adds new days. Full Refresh reloads the whole backfill period
Incremental Refresh Window10 daysDays re-read on every sync, so days that were still settling are replaced once final
Sync ScheduleDaily

Click Create Table.

Search Console finalizes data about two to three days late, so every sync stops three days before today. The newest day on your board is three days ago, and that is expected.

Check it worked

When the table is active, open Search Console's Performance report for the same property, search type and date, and compare clicks and impressions for one day at least three days old. Compare a table with no Query dimension; a table with Query will read lower.

Troubleshooting

What you seeWhat to do
Test says the identity does not have access to the propertyAdd the connection's service account email as a user on that exact property. Check you used the right property type: https://www.example.com/ and sc-domain:example.com are separate properties
Test says the identity can see the property but cannot query itThe user's permission is not enough, or not verified yet. Make it a Full or Restricted user on the property in Search Console, then test again
The sync fails saying no finalized data is available yetThe backfill or refresh window is too short to reach a finalized day. Use a longer Backfill Period
The sync stops at the row capThe table is too detailed. Remove a dimension (Query and Page together grow fastest) or shorten the backfill
Totals are lower than Search ConsoleThe table includes Query. See the warning above