Import Yandex search keywords into Matomo

To import your Yandex Search Keywords in Matomo, follow this guide to verify your website and set up the Yandex OAuth client with access to the Yandex Webmaster API.

Yandex provides different types of OAuth apps. A user authorisation app has a limited set of permissions and does not provide the required Yandex Webmaster permissions. For the Matomo and Yandex integration, you will need to create an OAuth client for API access.

Verify your website with Yandex

1. Sign in at Yandex Webmaster.
2. Click Add a site in Yandex Webmaster and enter your site URL.
3. Follow the instructions in Yandex to Verify your site ownership.
4. Once verified, go to Yandex OAuth to create a new OAuth client.

Create an OAuth client for API access

1. Use this OAuth client link: https://oauth.yandex.com/client/new to create the client with API access.
2. Provide a useful Service name, for example, Matomo Import.
3. Under Platforms, choose Web services.
4. Set the Callback URI. This needs to be your Matomo URL with the special URL/query appended to the URL
   /index.php?module=SearchEngineKeywordsPerformance&action=processYandexAuthCode
   For example: https://matomo.my-website.com/index.php?module=SearchEngineKeywordsPerformance&action=processYandexAuthCode
5. Add the Permissions that are required for the import by typing these into the Permission name field:
   • Access to user avatar
   • Access to username, firstname and surname, gender
   • Adding sites to Yandex.Webmaster and receiving indexing status information
   • Obtaining information about external links to sites
6. Provide an email address to receive notifications about changes to this configuration.
7. Click the Create app button. The following page will show you a summary of the chosen permissions together with the client ID and client secret.
   

Configure Matomo

1. Log in to Matomo and go to Administration > System > Search Performance.
2. Enter your Yandex app Client ID and Client secret and click Save.
   .
3. Click on the Start OAuth Process and Matomo will verify and connect. If you receive any permissions errors, open your Yandex app and ensure the webmaster permissions were added.

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

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