Acquisition

Some years ago most search engines decided to hide keywords from the referrer urls, which made it impossible for web analytics tools to report reliable keyword statistics. Using this feature you can now get back powerful insights into how your audience searches on Google, Bing and Yahoo!

Which queries caused your website to appear in search results? Which queries result in more traffic to your website than others? The plugin adds new reports to your Matomo (Piwik) which give you the exact list of all keywords searched by users on these search engines. You can finally go beyond the “keyword not defined” issue and get deep SEO insights in Matomo.

Search Engine Keywords Performance is a premium feature which is included in all our Cloud-hosted plans or you can purchase it on the Matomo Marketplace if you self host Matomo On-Premise. Learn more about all its benefits and features.

Once you have configured the Google and/or Bing+Yahoo! Search Keywords imports for a website in Matomo, two new reports will be available:

Viewing Search Keywords Reports

Combined Keywords

The Combined keywords report gives you all keywords searched by your users across all search engines. For each keyword, you get the number of clicks, the number of impressions, the ClickThrough rate and the search result position of your website for this website.

Keywords for Google Search, Google Images and Google Videos

Keywords for Google Search, Google Images and Google Videos will be imported for your websites once you configure Google Search Console in Matomo.

Keywords for Bing and Yahoo! Search will be imported in your Matomo once you configure Bing Webmaster Tools in Matomo.

Keywords for Yandex Search will be imported in your Matomo once you configure Yandex Webmaster Tools in Matomo.

Keywords position in search engine over time

Using Row Evolution on a particular Keyword, you can visualise each of your keywords ranking position in search results over time.

Viewing Search Bots Crawl Overview reports

For Search Engines to list your websites in the search results page, they send search robots to look at your website and index your pages. The Search Crawling Overview report allows you to view robots crawl related information such as errors encountered when visiting a page, items blocked by your robots.txt file and URLs potentially affected by malware.

To view the Crawling overview, proceed to setup Bing and Yahoo! search keywords import (click to see instructions below) into Matomo, then the search crawling reports will be imported along with your Bing and Yahoo! keywords.

How to import Google Search keywords in Matomo

  1. Follow instructions in How to set up Google Search Console and verify your website.

  2. Follow instructions in How to set up Google OAuth Client config to get your OAuth config.

  3. Login to Matomo as Super User, click on “Administration (cog icon)” on the top right, and click on “Search Performance” under “System”. If you are using Matomo for WordPress, you first need to go to “WP Admin Dashboard -> Matomo Analytics -> Reporting” before completing these steps.

  4. Below Google Search Console, click Setup Configuration.

  5. Below Connect Google Account(s), click Start oAuth process.

  6. Now you can configure your websites to import Keywords for. Below Configure websites click the Add configuration.

Congratulations! You’re all set and your Google keywords will be imported in the new Matomo Search Keywords report.

How to set up Google Search Console and verify your website

To import your Google Search Keywords in Matomo, you need to sign in to the Google Search Console and check your website is verified. Follow the steps below:

  1. Sign in to Google Search Console (you may need to create an account). Google Search Console is a free service offered by Google that helps you monitor and maintain your site’s presence in Google Search results.

  2. In the Search Console home page, click the Add a property button and type the URL of the site for which you want keyword data.

  3. Click Continue to open the Site verification page. Select a verification method to prove that you own the site and follow the verification instructions on the page.

Once your website is verified: congratulations! You can now proceed to setting up the Google Search Keywords import in Matomo

How to set up Google OAuth Client config

Important note before we start: At no point during these steps will you be required to submit your ‘app’ to Google for verification. If you are prompted to submit your ‘app’ and do not have the option to click no or cancel, then please review the steps in this guide again to ensure that you have not missed an important step, or added additional information where not necessary.

If at any time you need to make changes to the OAuth Configuration, you will need to download the new OAuth Client credentials and upload them to Matomo in order for the changes to work.

Follow these steps to get your OAuth Client Config and use the Matomo Google Search Integration:

  1. Sign in to the Google API Console

  2. Click Select a project in the menu.

  3. To create a new project click the “New Project” button in the overlay:

  4. Give your new Project a useful name (for example Matomo Search Integration).

  5. After your project has been created, select it manually in the project list and click “open”.

  6. Click on Library in the menu on the left, then search for Google Search Console API, and click on the item Google Search Console API. Then on the description page of this API, click the Enable button.

  7. Next we need to setup the OAuth Consent Screen. Click on the Google logo at the top to get back to the dashboard, afterwards click on OAuth Consent Screen in the left menu. Select External and then click Create.

  8. Choose a name for your app, then click Add Domain and add the top level domain of your matomo instance e.g. matomo.cloud

  9. Select your email address from the drop down menu under User support email, and fill in your email address for Developer contact information
    Important note: Do not upload an App logo here, doing so will require you to submit your ‘app’ to Google for verification which can take several months to complete.

  10. Click Save and Continue and then click Add or Remove Scopes

  11. Select the “Google Search Console API” scope with the readonly property and click Update then click Save and Continue

  12. Next, we need to add Test Users in order to allow access to the Google Search Console API Scope.
    Click Add Users and enter the email address you will be using to access the Google Search Console Data.


  13. Click Back to Dashboard

  14. Go to the Credentials tab on the left menu

  15. Click Create Credentials

  16. Select OAuth Client ID

  17. Select Web Application as the Application Type

  18. Set a name for the application, for example Matomo at https://matomo.my-website.example

  19. Click on Add URI under Authorized JavaScript origins and set it to your Matomo URL domain for example: https://matomo.my-website.example
    Note: This needs to be a domain. If you have installed Matomo into a subdirectory, you need to enter the domain without the path. (so https://my-website.example in case of https://my-website.example/matomo/)

  20. Click on Add URI under Authorized redirect URIs. This needs to be set to your Matomo URL with this special URL/query /index.php?module=SearchEngineKeywordsPerformance&action=processAuthCode added at the end. For example: https://matomo.my-website.com/index.php?module=SearchEngineKeywordsPerformance&action=processAuthCode
    Note: the URLs above are HTTPS: we highly recommend you run your Matomo instance over SSL. If your Matomo doesn’t support https yet, you can replace the URL and use http.
    If you are using Matomo for WordPress: the URL must begin with the entire path to Matomo’s admin page, eg, http://mysite.com/wp-content/plugins/matomo/app/index.php?module=SearchEngineKeywordsPerformance&action=processAuthCode
    Note: that the URL for Matomo does not have to have a subdomain, that is just an example.

  21. Once you have entered the two URIs, click Create to finish creating the OAuth Client Credentials

  22. You will now be presented with the OAuth credentials that were just created, you can click Ok to close this dialog, and then download your OAuth client credentials by clicking the download icon on the credentials overview page. (Note: if you change any settings above at a later point for example to fix a typo in one of the values, you will need to download the OAuth client credentials again and re-upload it in Matomo.)

The steps in creating your OAuth Client Configuration are now complete. The ‘app’ that has been created during this process can remain as a ‘Testing’ or ‘Test Phase’ app without any need to submit it for review.
At no point during these steps would you have been required to submit your ‘app’ to Google for verification. If were prompted to submit your ‘app’ and did not have the option to click no or cancel, then please review the steps in this guide again to ensure that you have not missed an important step, or added additional information where not necessary.

You may still receive a warning from Google when completing the OAuth process saying “Google hasn’t verified this app”.
In this case, you can safely continue by clicking on “Advanced”, and then “Go to matomo.cloud (unsafe)” or “Go to yourdomain.com (unsafe)”

Congratulations! You can now proceed to setting up the Google Search Keywords import in Matomo

How to import Bing and Yahoo! search keywords into Matomo?

To import your Bing and Yahoo! Search Keywords in Matomo, you need to sign in to the Bing Webmaster Tools and check your website is verified. Follow the steps below:

  1. Sign in at Bing Webmaster Tools.

  2. Click Add a site in Bing Webmaster Tools and enter your site URL

  3. Bing will then invite you to Verify your site ownership.

  4. Once you have verified your site ownership, go to Webmaster tools.

  5. Click on the Settings icon (top right), and click “API access”. Then click on “API Key -> View API Key”.

  6. Click “Copy” to copy the Bing Webmaster API key.

  7. Login to Matomo as Super User, click on “Administration (cog icon)” on the top right, and click on “Search Performance” under “System”.

  8. Below Bing Webmaster API, click Setup Configuration. Enter your Bing API key.

Congratulations! You’re all set and your Bing and Yahoo! keywords will be imported in the new Matomo Search Keywords report.

How to import Yandex search keywords into Matomo?

To import your Yandex Search Keywords in Matomo, you need to sign in to the Yandex Webmaster and check your website is verified. Follow the steps below:

  1. Sign in at Yandex Webmaster.

  2. Click Add a site in Yandex Webmaster and enter your site URL

  3. Yandex will then invite you to Verify your site ownership.

  4. Once you have verified your site ownership, go to Yandex OAuth to create a new client.

  5. Provide a useful App name and description if you like:

  6. Choose Web services under Platforms and set the Callback URI. This needs to be set to your Matomo URL with this special URL/query /index.php?module=SearchEngineKeywordsPerformance&action=processYandexAuthCode added at the end. For example: https://matomo.my-website.com/index.php?module=SearchEngineKeywordsPerformance&action=processYandexAuthCode

  7. Select the Permissions that are required for the import:

    Yandex.Passport API requires Access to user avatar and Access to username, first name and surname, gender

    Yandex.Webmaster API requires Adding sites to Yandex.Webmaster and receiving indexing status information and Obtaining information about external links to site

  8. Click the Create app button. The following page will show you a summary of the choosen permissions together with the client ID and password.

  9. Use the Client ID and password to set up the client configuration within Matomo.

  10. You can now start connecting your account(s) and setting up import for specific websites.

Congratulations! You’re all set and your Yandex keywords will be imported in the new Matomo Search Keywords report.

FAQ

We compile a list of most frequently asked questions in the Search Engine Keywords Performance Monitor FAQ.