Справочник методов предыдущей версии

В Яндекс.Метрике обновился код счетчика, а также методы JavaScript API. Ниже представлена предыдущая версия методов.

addFileExtension

Отслеживание загрузки файлов с заданными расширениями.

addFileExtension(extensions)

Параметр extensions соответствует параметру новой версии метода.

extLink

Отправка информации о переходе по внешней ссылке.

extLink(url[, options])

Параметры url и options соответствуют параметрам новой версии метода.

file

Отправка информации о загрузке файла.

file(url[, options])

Параметры url и options соответствуют параметрам новой версии метода.

getClientID

Получение идентификатора посетителя сайта, заданного Яндекс.Метрикой.

yaCounterXXXXXX.getClientID()
hit

Отправка данных о просмотре.

hit(url[, options])

Пример:

var yaCounterXXXXXX = new Ya.Metrika({id: XXXXXX});
//...
yaCounterXXXXXX.hit('#!contacts', {
    title: 'Контактная информация',
    referer: 'http://example.com/#!main'
});

Параметры url и options соответствуют параметрам новой версии метода.

notBounce

Передача информации о том, что визит пользователя не является отказом.

notBounce([options])

Параметр options соответствует параметру новой версии метода.

params

Передача произвольных параметров визита.

params(parameters)

Примеры передачи параметров визита:

Статус посетителя
var yaParams = {
    x: 10,
    y: "неавторизованный пользователь"
}

var yaCounterXXXXXX = new Ya.Metrika({id: XXXXXX, params: window.yaParams||{}});
AB-тестирование

Допустим, необходимо определить, как цвет кнопки Купить влияет на конверсию по цели «Переход в корзину».

Если пользователю показывается красная кнопка, определяем параметр:
var yaParams = {ab_test: "красная кнопка"};

Если пользователю показывается зеленая кнопка, определяем параметр:

var yaParams = {ab_test: "зеленая кнопка"};

Передаем этот параметр любым удобным способом. Например, при инициализации счетчика на страницах с товаром или с помощью метода reachGoal, вызываемого при нажатии кнопки Купить.

Передача иерархической структуры данных
var yaParams = {
    "level1":{"level2":["level3_1","level3_2"]}}
...

Параметр parameters соответствует параметру новой версии метода.

reachGoal

Передача информации о достижении цели.

reachGoal(target[, params[, callback[, ctx]]])

Примеры установки цели:

Установка на форму
...
<form action="" method="get" onsubmit="yaCounterXXXXXX.reachGoal('TARGET_NAME'); return true;">
    ...
</form>
...
Установка на кнопку
...
<form action="">
    ...
    <input type="button" onclick="yaCounterXXXXXX.reachGoal('TARGET_NAME'); return true;" value="Заказать" />
</form>
...
Установка на ссылку
...
<a href="/price.zip" onclick="yaCounterXXXXXX.reachGoal('TARGET_NAME'); return true;">Прайс</a>
...
Установка на ссылку с передачей пользовательских параметров
...
<script type="text/javascript">
    var goalParams = {myParam: 123};
    function goalCallback () {
        console.log('запрос в Метрику успешно отправлен');
    }
</script>
<a href="/price.zip" onclick="yaCounterXXXXXX.reachGoal('TARGET_NAME', goalParams, goalCallback); return true;">Прайс</a>
...
Достижение цели при загрузке страницы

Если вы используете асинхронный код счетчика и цель вызывается с помощью элемента script, разместите в любой части страницы следующий код:

Решение 1
<script type="text/javascript">
    window.onload = function() {
        yaCounterXXXXXX.reachGoal('TARGET_NAME')
    }
</script>
Решение 2 (для jQuery)
<script type="text/javascript">
    $(window).load(function() {
        yaCounterXXXXXX.reachGoal('TARGET_NAME')
    });
</script>
Установка ценности цели на форму
...
<script type="text/javascript">
    var goalParams =
    {
       order_price: 1000.35,
       currency: "RUB"
    }
</script>
<form action="" method="get" onsubmit="yaCounterXXXXXX.reachGoal('TARGET_NAME', goalParams); return true;">
    ...
</form>
...

Параметры target, params, callback и ctx соответствуют новой версии метода.

setUserID

Передача идентификатора посетителя сайта, заданного владельцем сайта.

yaCounterXXXXXX.setUserID("12345")
userParams

Передача произвольных параметров посетителей сайта.

userParams(parameters)

Параметр parameters соответствует параметру новой версии метода.