Quick start

You need a Yandex ID in order to work with Yandex Metrica. If you don't have one, you first need to sign up.

If you are the owner of an advertising campaign in Yandex Direct, or your online store is a Yandex Market partner, we recommend that you log in with the username registered in these services. This allows you to quickly switch between services.

Click Add tag. A page opens with tag settings. For more information, see the section How to create and install a tag.

In the Settings section, go to the Tag tab and click Copy. Then insert this code into the HTML code of all the site's pages. We recommend inserting it as close to the top of the page as possible — the accuracy and completeness of data calculation depends on this. For more information, see the section Installing a tag.

After installation, the tag will be available on the My tags page. The tag immediately starts collecting data.

Familiarize yourself with the tools that can be connected to your tag and make your work with Yandex Metrica more effective. To do this, go to Settings → Enabling reports.

Making sure the tag is placed on the site and data is collected

You can check whether the tag snippet is installed correctly and whether statistics are collected.

Checking goal settings

You can check whether the goals are set up correctly using the parameter _ym_debug=1. For more information, see Checking a goal.

Error when installing code snippet on a site

You’re probably using the Smarty template engine, which incorrectly processes the curly brackets contained within the code snippet.

In order for the JavaScript code to be correctly handled in this template engine, you must enclose the Yandex Metrica code snippet in a special {literal}{/literal} element (see the Smarty documentation) or use the {ldelim}{rdelim} element to escape the curly brackets in the code snippet (see the Smarty documentation).

Getting statistics in a YAN tag

The YAN code snippet is installed automatically on site pages that contain YAN blocks. To get complete statistics, install the Yandex Metrica code snippet on all the site's pages. You can get the code snippet on the Settings page (Tag).

Here you can enable displaying the click map, accurate bounce rate, and other Yandex Metrica features. For more information, see Basic and additional tag settings.

Installing multiple tags on a site's pages

For details, see the section Installing multiple tags on a site.

Installing the same tag on multiple sites

Statistics will be collected for all sites that have the tag installed, even if they are not indicated in the Website address and Additional addresses fields (see the section Basic and additional tag settings). In some reports, such as the Popular report, URLs for these sites are shown in gray.