Import Google Search keywords to Matomo Cloud – Quick Connect (recommended)
Importing your Google Search keyword data is easy with our Quick Connect configuration for Matomo Cloud. This setup securely connects your Google Search Console account and imports your search keyword and performance data into Matomo for analysis.
Before you start
Google Search Console is a free service offered by Google that helps you monitor and maintain your site’s presence in Google Search results.
To import your Google Search Keywords in Matomo, you need to set up Google Search Console and verify your website. Read more on how to set up Google Search Console.
Connect Google Search Console
- Log in to Matomo as a superuser and navigate to Administration
> System > Search Performance. - Choose Quick Connect with Google (recommended).
- Click Connect with Google.
- Select the Google account associated with your Google Search Console property.
- Review the requested permissions and click Continue.
- Once connected, Matomo will begin importing your available Google search engine keywords automatically.
Add website configurations
The Add Configuration button allows you to connect additional Matomo websites to Google Search Console properties. This is useful when managing multiple websites in Matomo and you want to import Google Search keyword data for several domains or subdomains.
Different Matomo websites use different Google Search Console properties. Each configuration links a Matomo website, a Google account, and a Google Search Console property.
When adding a configuration and the website does not appear in the available list, this usually means the property has not been verified in Google Search Console or the selected Google account does not have permission to access the property.
Troubleshooting
If you experience issues connecting Google Search Console to Matomo, check the website has been verified in Google Search Console and the correct Google account was selected.
Google OAuth redirect returns a 404 error:
If the Google authentication process fails or redirects to a 404 page containing ?.profile, this is usually caused by a web server configuration issue. The Search Keywords Performance feature uses a Google OAuth redirect flow that requires the web server to correctly handle URLs containing .profile.
For example, a URL such as https://example.com/matomo/?.profile returning a 404 error indicates the server is not processing the request correctly. Review your web server rewrite rules and routing configuration to ensure these requests are handled properly.