Инициализация счетчика

Совет

Для работы с JavaScript API необходимы навыки работы с HTML и JavaScript. Если вы не обладаете такими навыками, обратитесь к разработчику или вебмастеру вашего сайта.

JavaScript-библиотека, отвечающая за работу счетчика, загружается с URL https://mc.yandex.ru/metrika/tag.js.

Код для подключения библиотеки доступен на странице редактирования счетчика. Библиотека может быть загружена асинхронным (рекомендуется) и синхронным способом, однако, ее функционал при этом остается неизменным.

Для создания и управления счетчиком используется метод ym. Он создается в коде загрузки:

(function(m,e,t,r,i,k,a){m[i]=m[i]||function(){(m[i].a=m[i].a||[]).push(arguments)};
m[i].l=1*new Date();k=e.createElement(t),a=e.getElementsByTagName(t)[0],k.async=1,k.src=r,a.parentNode.insertBefore(k,a)})
(window, document, "script", "https://mc.yandex.ru/metrika/tag.js", "ym");

Обязательные аргументы ym — номер счетчика и имя вызываемой функции. Также в метод могут передаваться аргументы вызываемой функции. Например, для инициализации счетчика нужно передать номер счетчика, имя функции init и массив ее параметров:

ym(XXXXXXXX, "init", {clickmap: true, webvisor: true});

Если вы не хотите передавать в функцию параметры, то инициализация будет выглядеть так:

ym(XXXXXXXX, "init", {});

Часть кода, содержащего основные параметры инициализации, формируется на странице Настройка. Полный список параметров инициализации приведен в таблице.

Функции, которые можно вызвать через метод ym, описаны в справочнике методов.

Параметры инициализации счетчика

Имя	Значение по умолчанию	Тип	Описание
`accurateTrackBounce`	`true`	Boolean \| Number	Точный показатель отказов. Параметр может принимать значения: `true` — включить точный показатель отказов, событие о неотказе засчитывается через 15000 мс (15 с); `false` — не включать точный показатель отказов; `<N>` (целое число) — включить точный показатель отказов, событие о неотказе засчитывается через `<N> мс`
`childIframe`	`false`	Boolean	Признак записи содержимого iframe без счетчика в дочернем окне
`clickmap`	`true`	Boolean	Признак сбора данных для карты кликов
`defer`	`false`	Boolean	Признак отключения автоматической отправки данных при инициализации счетчика
`disableYtm`	`false`	Boolean	Признак работы Яндекс Тег Менеджера. Если установить значение `true`, опция не будет работать на странице
`ecommerce`	`false`	Boolean \| String \| Array	Сбор данных электронной коммерции. `true` — включить сбор данных электронной коммерции. Равносильно значению `dataLayer` (если опция включена в интерфейсе Метрики). Передача данных производится через JavaScript-массив с именем `dataLayer` в глобальном пространстве имен (`window.dataLayer`). `false` — отключить сбор данных электронной коммерции Ecommerce; `<objectName>` (String) — включить сбор данных электронной коммерции Ecommerce. Передача данных производится через JavaScript-массив с именем `<objectName>` в глобальном пространстве имен (`window.<objectName>`); `<array>` (Array) — включить сбор данных электронной коммерции. Передача данных производится через JavaScript-массив `<array>`
`params`	—	Object \| Array	Параметры визита, передаваемые во время инициализации счетчика. Для передачи параметров визита в произвольный момент времени используется метод params
`userParams`	—	Object	Параметры посетителей сайта, передаваемые во время инициализации счетчика. Для передачи параметров посетителей в произвольный момент времени используется метод userParams
`trackHash`	`false`	Boolean	Признак отслеживания изменений хеша в адресной строке браузера
`trackLinks`	`true`	Boolean	Признак отслеживания переходов по внешним ссылкам
`trustedDomains`	—	Array	Признак доверенного домена для записи содержимого дочернего окна iframe. Содержит адрес домена родительского окна
`type`	`0`	Number	Тип счетчика. Для РСЯ равен 1
`webvisor`	`false`	Boolean	Признак использования Вебвизора
`triggerEvent`	`false`	Boolean	Признак проверки готовности счетчика
`sendTitle`	`true`	Boolean	Запись заголовков. Если в заголовках есть приватные данные, при инициализации счетчика укажите значение `false`: `sendTitle: false`
`ssr`	`true`	Boolean	Технический параметр для работы кода вставки

Проверка инициализации счетчика

Определить, готов ли счетчик к работе, можно с помощью специального JavaScript события. При этом необходимо добавить параметр triggerEvent со значением true в код счетчика:

ym(XXXXXXXX, "init", {triggerEvent: true});

Для jQuery можно использовать следующий пример кода до момента инициализации счетчика:

jQuery(document).on('yacounterXXXXXXXXinited', function () {
    console.log('счетчик yaCounterXXXXXXXX можно использовать');
});

Написать в чат

Написать письмо

Обратите внимание: служба поддержки не обзванивает пользователей. Не следуйте указаниям людей, которые вам звонят и представляются службой поддержки Яндекс Метрики.

Полезные ссылки

Онлайн-обучение

Была ли статья полезна?

Статистика по поисковым запросам из браузеров с ограничением third-party cookies

Справочник методов