Google Search Console Integration
Import organic search performance data from Google Search Console (GSC) into Convultra. This integration pulls search queries, clicks, impressions, CTR, average position, and device/country breakdowns into your Convultra dashboard so you can see organic search performance alongside your paid conversion data.
This integration is read-only. Convultra imports data from GSC but does not modify anything in your Search Console account.
Requirements
| Requirement | Details |
|---|---|
| Google Search Console account | With at least one verified property. |
| Verified property | The site you want to import data for must be verified in GSC. Unverified properties will not appear in the selection step. |
| Google account access | The Google account used for OAuth must have access to the GSC property (Owner, Full, or Restricted user). |
Setup
Navigate to Integrations
Go to Dashboard → Integrations and click Connect on the Google Search Console card.
Complete OAuth Flow
A Google sign-in window opens. Sign in with the Google account that has access to your Search Console properties. Convultra requests the following OAuth 2.0 scope:
https://www.googleapis.com/auth/webmasters.readonly— read-only access to your Search Console data
OAuth tokens are stored encrypted and refresh automatically in the background.
If you manage multiple Google accounts, make sure you sign in with the one that has access to the Search Console property you want to connect.
Select Verified Property
After authentication, Convultra lists all GSC properties accessible to the authenticated user. Select the property that matches your website.
Both Domain properties (e.g., sc-domain:example.com) and URL prefix properties (e.g., https://www.example.com/) are supported.
Only verified properties appear in the list. If your property is not shown, verify it in Google Search Console first. See Google's verification guide (opens in a new tab) for instructions.
Data Imports Automatically
Once connected, Convultra begins importing your search performance data. No additional configuration is needed.
The initial import pulls the most recent available data. After that, new data is imported automatically on a daily schedule.
Imported Data
Convultra imports the following data from the GSC Search Analytics API:
| Metric | Description |
|---|---|
| Search queries | The search terms users typed to find your site. |
| Clicks | Number of times users clicked through to your site from search results. |
| Impressions | Number of times your site appeared in search results. |
| CTR | Click-through rate (clicks / impressions). |
| Average position | Average ranking position in search results for each query. |
Breakdowns
Data is available with the following dimensions:
| Dimension | Description |
|---|---|
| Query | Individual search terms. |
| Page | Landing page URLs that received organic traffic. |
| Device | Desktop, mobile, or tablet. |
| Country | Country where the search originated. |
| Date | Daily granularity. |
Data Availability
GSC data has an inherent 3-day delay. This is a limitation of the Google Search Console API, not Convultra. The most recent data available will always be approximately 3 days old.
| Detail | Value |
|---|---|
| Data delay | ~3 days (GSC API limitation) |
| Import frequency | Daily (automatic) |
| Historical data | Up to 16 months (GSC API maximum) |
| Data location in dashboard | Dashboard → Organic Search (/dashboard/organic) |
Viewing the Data
Imported GSC data is displayed on the Organic Search page in your Convultra dashboard, accessible at /dashboard/organic. This page provides:
- Top queries — Search terms driving the most clicks and impressions.
- Top pages — Landing pages receiving the most organic traffic.
- Position tracking — Average position trends over time.
- Device breakdown — Organic traffic split by desktop, mobile, and tablet.
- Country breakdown — Geographic distribution of your organic search traffic.
This allows you to see organic search performance alongside your paid conversion data in a single dashboard, without needing to switch between tools.
Property Access
Convultra can only access GSC properties that the authenticated Google account has permission to view. If a property is not appearing:
- Verify the property exists in Google Search Console (opens in a new tab).
- Confirm the Google account used for OAuth has Owner, Full, or Restricted access to the property.
- If you recently added a new property, it may take a few minutes to appear.
To connect a different property, disconnect the current integration and reconnect with the appropriate Google account.
Troubleshooting
| Problem | Solution |
|---|---|
| No properties in dropdown | Verify that the Google account used for OAuth has access to at least one verified GSC property. |
| Property not showing | The property must be verified in GSC. Unverified properties are not returned by the API. |
| Data not appearing in dashboard | Initial import can take a few minutes. If data still does not appear after 15 minutes, disconnect and reconnect. |
| Data is 3+ days old | This is expected. The GSC API has a ~3 day data processing delay. |
| OAuth token errors | Disconnect and reconnect the integration from Dashboard → Integrations. Tokens refresh automatically, but manual revocation in Google account settings will break the connection. |
| Incomplete data for recent dates | GSC may update data for recent dates over several days as it processes. This is normal GSC behavior. |