Import Yandex search keywords into Matomo

To import your Yandex Search Keywords in Matomo (Piwik), 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 Service name such as Matomo Import

yandex_step_1

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

Yandex_step_2

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

yandex_step_3

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

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

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.

Previous FAQ: Import Bing and Yahoo! search keywords into Matomo