What Margly reads from Search Console#
Margly calls the Google Search Console API and saves to the database daily:
- Keywords (query) — which phrase brought visitors from Google search
- Pages (page) — to which URL of your website Google sends visitors
- Devices (device) — mobile, desktop, tablet
- Date of each record
For each combination of keyword × page × day and the breakdown by device × day, four metrics are stored:
- Impressions — how many times your page appeared in search results
- Clicks — how many times someone clicked on it from the results
- CTR (click-through rate)
- Average position in search results
On the first connection Margly pulls the last 480 days (approx. 16 months) so the AI Advisor has enough history to evaluate trends. The pull runs in 90-day batches, so a large website handles it without time-limit errors.
Shared Google OAuth#
Margly uses a single login for Google Ads, GA4, and Search Console. If you have already authorized a Google account for any of these sources, Search Console just needs to be activated by picking a property — no new OAuth window opens.
Connection procedure#
Have verified property in Search Console
Before connecting, your e-shop must be in Google Search Console as a verified property. If you don't have it there yet, go through Google's guide.
Connect Google account (if not yet)
In Margly Integrations → Google click Connect Google account. Approve 4 permissions for reading data from Google Analytics, Google Ads, Search Console, and email for identifying the connected account.
Select Search Console property
Margly shows a list of verified properties your Google account has access to. Pick the one that belongs to your e-shop.
Domain property covers all subdomains of your website at once. URL property covers only the specific address it was created for.
Margly pulls historical data
The first load takes time depending on the website size — a small e-shop a few minutes, a large catalog with tens of thousands of URLs even longer. Loading runs in the background.
Where you'll see the data in Margly#
Search Console data is displayed in the Advertising section (dashboard sidebar). After loading you'll see here:
-
Period summary — total number of clicks, total number of impressions, average CTR and average position, all compared with the previous period (green/red percentage difference for clicks and impressions).
-
Top 20 keywords — phrases with the most clicks for the chosen period; for each word you see clicks, impressions, CTR, and average position.
-
Top 20 pages — URLs that get the most clicks from Google, with the same metrics.
-
Improvement opportunities (top 10) — words that meet all these conditions:
- at least 100 impressions for the period,
- CTR below 5 %,
- average position ≤ 20 (= first two pages of Google).
These are words where Google is already showing you, but people click on the result little — typically it's enough to rewrite the title and meta description so the result is more enticing. Margly also computes an estimate of potential additional clicks if your CTR reached the standard 5 % threshold.
-
Daily trend — chart of clicks and impressions over time.
-
Breakdown by device — clicks, impressions, CTR, and average position separately for mobile, desktop, and tablet.
Common errors#
- "Property not available" — the Google account you logged into Margly with doesn't have access to this property in Search Console. In Search Console → Settings → Users and permissions add yourself (or have the property owner add permission).
- Data missing for the last 1–2 days — Search Console has a two-day delay at Google. It's not a Margly bug.
- "0 clicks, 0 impressions" — either the e-shop is very new (Google doesn't yet index it, or it hasn't yet made it into the search results), or the property in Search Console points to the wrong URL (e.g.,
https://vs.http://vs. domain × URL property). Check that the property matches the exact address of your e-shop.
What's next#
- Connecting Google Ads — paid traffic from Google
- Connecting Google Analytics 4 — traffic, customer behavior, conversion rate
- AI Advisor — uses Search Console data in analyses