Import Yandex search keywords into Matomo

To import your Yandex Search Keywords in Matomo, follow the steps below to sign in to the Yandex Webmaster, verify your website, and set up the client app.

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 e.g., Matomo Import.
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. 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
8. Provide an email address to receive notifications about changes to this configuration.
   
9. 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. Open Matomo settings > 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.

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