Connecting Integrations

SearchVector becomes significantly more powerful when connected to your existing accounts. Each integration brings in real data that fuels your SEO and advertising analytics.

Available Integrations

Integration	What It Unlocks	Auth Method
Google Search Console	Search queries, clicks, impressions, index coverage	Google OAuth
Google Ads	Campaign performance, ROAS, keyword spend data	Google OAuth
Apple Search Ads	App Store campaign analytics, keyword conversions	Apple OAuth

Google Search Console

GSC is the most impactful integration — it connects your real search performance data directly to SearchVector.

Prerequisites

• A verified property in Google Search Console
• The Google account you use for SearchVector must have access to the GSC property (Owner, Full User, or Restricted User)

How to Connect

1. Navigate to Settings → Integrations (or click "Connect GSC" in your project dashboard)
2. Click "Connect Google Search Console"
3. A Google OAuth popup appears — select the account that has GSC access
4. Grant SearchVector permission to view your Search Console data
5. Select the property (domain or URL prefix) you want to connect
6. Click "Connect"

What Data Gets Synced

Once connected, SearchVector pulls:

• Search Queries — what people searched to find your site
• Pages — which pages received clicks and impressions
• Countries — geographic breakdown of your search traffic
• Devices — desktop vs. mobile vs. tablet performance
• Dates — up to 16 months of historical data
• Index Coverage — which pages are indexed, have errors, or are excluded
• Sitemaps — status of your submitted sitemaps

Sync Frequency

GSC data syncs automatically every few hours. Historical data (up to 16 months) is imported on first connection, which may take a few minutes for large properties.

Permissions Explained

SearchVector requests read-only access to your Search Console data. We cannot:

• Modify your GSC settings
• Submit or remove URLs
• Change your sitemap
• Add or remove users

Connecting Multiple Properties

If you manage multiple websites:

1. Create a separate project for each website in SearchVector
2. Connect the matching GSC property to each project
3. Switch between projects from the dashboard to view each site's data

Google Ads

Connect Google Ads to track campaign performance, analyze spend, and optimize ROAS from within SearchVector.

Prerequisites

• An active Google Ads account
• The Google account used for SearchVector must have access to the Ads account (Admin, Standard, or Read-only)

How to Connect

1. Navigate to Settings → Integrations → Google Ads
2. Click "Connect Google Ads"
3. Authorize via Google OAuth
4. Select the Google Ads account (or manager account for agencies)
5. Click "Connect"

What Data Gets Synced

• Campaigns — all active and paused campaigns with status
• Impressions & Clicks — traffic metrics in real-time
• Conversions — goal completions and conversion values
• ROAS — return on ad spend across campaigns
• Cost Data — spend by campaign, ad group, and keyword
• Quality Scores — keyword quality metrics
• Device & Location — performance breakdowns

Multi-Account Management

For agencies or businesses with multiple brands:

1. Connect a Google Ads Manager Account (MCC) to access all sub-accounts
2. Switch between ad accounts from the SearchVector dashboard
3. View aggregate or individual account performance

tip

Connecting a manager account is more efficient than connecting individual accounts one by one. You get access to all sub-accounts in one authorization.

Apple Search Ads

Track your App Store advertising campaigns with deeper analytics than Apple's native dashboard provides.

Prerequisites

• An active Apple Search Ads account
• Admin or Account Read Only role in Apple Search Ads

How to Connect

1. Navigate to Settings → Integrations → Apple Search Ads
2. Click "Connect Account"
3. Authorize via Apple's OAuth flow
4. Select the organization and campaigns to track
5. Click "Connect"

What Data Gets Synced

• Keyword-level conversions — what Apple's dashboard doesn't show
• Historical data — stored permanently (vs. Apple's 90-day limit)
• Campaign performance — impressions, taps, installs, spend
• Ad placement data — Search Results, Today Tab, Search Tab, Product Pages
• Cost per install — true CPI by keyword (not just cost per tap)

Why Use SearchVector Over Apple's Dashboard?

Capability	Apple Dashboard	SearchVector
Keyword-level conversion tracking	Limited	Full tracking
Historical data retention	90 days	Unlimited
Competitor keyword insights	Not available	Available
Automated performance reports	Not available	Daily/weekly
True cost-per-install by keyword	Cost-per-tap only	Full CPI data

Managing Your Integrations

Viewing Connection Status

Go to Settings → Integrations to see all your connections:

• Connected (green) — integration is active and syncing
• Error (red) — connection issue, re-authentication needed
• Not Connected (gray) — integration available but not set up

Re-authenticating

If an integration shows an error:

1. Click "Reconnect" next to the integration
2. Go through the OAuth flow again
3. Data syncing will resume automatically

Common reasons for disconnection:

• Google/Apple password changed
• OAuth permissions revoked from the provider's side
• Account access was removed by an admin

Disconnecting an Integration

1. Go to Settings → Integrations
2. Click "Disconnect" next to the service
3. Confirm the action

warning

Disconnecting an integration stops data syncing. Your historical data in SearchVector is preserved, but no new data will be imported until you reconnect.

Security & Privacy

Data Handling

• All OAuth tokens are encrypted and stored securely
• SearchVector uses read-only access for all integrations
• No credentials (passwords) are ever stored
• You can revoke access at any time from your Google/Apple account settings

Revoking Access Externally

To fully remove SearchVector's access from outside the platform:

Google (GSC & Ads):

1. Go to myaccount.google.com/permissions
2. Find SearchVector and click "Remove Access"

Apple (Search Ads):

1. Go to Apple ID settings at appleid.apple.com
2. Navigate to Sign in with Apple or Apps & Websites
3. Remove SearchVector's access

Troubleshooting

OAuth popup doesn't appear

• Allow popups for searchvector.io in your browser settings
• Disable ad blockers temporarily
• Try a different browser

"No properties found" after connecting GSC

• Make sure you're authorizing with the Google account that owns the GSC property
• Verify the property exists in Google Search Console
• Check that you have at least "Restricted User" access

Google Ads data not showing

• Ensure campaigns exist in the connected account
• Check that you have read access to the Ads account
• Data may take a few minutes to sync after first connection

Apple Search Ads connection fails

• Verify you have Admin or Account Read Only role
• Ensure your Apple ID has an active Search Ads organization
• Try signing out of all Apple accounts and reconnecting

FAQ

Do I need to connect all integrations?

No. Each integration is optional. You can use SearchVector's standalone tools (keyword research, sitemap analyzer, etc.) without any integrations.

Can different team members connect different accounts?

Yes. Each team member can connect their own Google/Apple accounts. The data flows into the shared project.

Will connecting GSC affect my actual Search Console?

No. SearchVector only reads data. It cannot modify anything in your Google Search Console.

How much data history is imported?

GSC imports up to 16 months of historical data. Google Ads imports based on your account history. Apple Search Ads stores data permanently once connected.