reachGoal

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

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

ym(XXXXXX, 'reachGoal', target[, params[, callback[, ctx]]]);

Параметр

Значение по умолчанию

Тип

Описание

target *

String

Идентификатор цели. Задается на странице редактирования счетчика при создании или изменении цели типа «JavaScript-событие».

callback

Function

Callback-функция, вызываемая после отправки данных о просмотре.

ctx

Object

Контекст, доступный в callback-функции по ключевому слову this.

params

Object

Параметры визита

* Обязательный параметр.

Используйте метод reachGoal, если вам необходимо зафиксировать достижение цели в произвольный момент:

  1. На странице редактирования счетчика создайте цель типа «JavaScript-событие» и присвойте ей идентификатор.

  2. Вызовите функцию, когда цель достигнута:

    ym(XXXXXX, 'reachGoal', 'TARGET_NAME');

    где:

    • XXXXXX — номер вашего счетчика;
    • TARGET_NAME — идентификатор цели.
Внимание.

Значение идентификатора (TARGET_NAME) не должно содержаться в URL страниц сайта. Иначе будет собираться некорректная статистика, учитывающая посещения страниц, содержащих в адресе значение, выбранное при создании цели.

При задании идентификатора цели не используйте следующие символы: /, &, #, ?, =.

Примеры

Варианты установки цели в исходном коде вашей страницы:

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

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

Решение 1
<script type="text/javascript">
    window.onload = function() {
        ym(XXXXXX, 'reachGoal', 'TARGET_NAME')
    }
</script>
Решение 2 (для jQuery)
<script type="text/javascript">
    $(window).load(function() {
        ym(XXXXXX, 'reachGoal', 'TARGET_NAME')
    });
</script>

Цена (ценность) цели

Цену цели можно передавать, даже если сайт не является интернет-магазином. Указанная сумма будет передаваться при каждом достижении цели. Это поможет учитывать ее коммерческую эффективность.

Например, конверсия вашей email-рассылки составляет 10%. А сумма заказа какой-либо услуги или товара — 10 000 руб. Тогда в качестве ценности цели можно указать значение 1 000. Также вы можете использовать условные единицы для обозначения ценности: 1 — низкая, 10 — высокая.

Эта информация будет доступна в отчетах, если в интерфейсе Метрики добавить целевую метрику Доход. Подробно см. раздел Как сделать отчет по цели.

Параметр

Значение по умолчанию

Тип

Описание

order_price

Double

Цена цели

currency

String

Трехбуквенный код валюты по ISO 4217.

Если передается иная валюта, будут отправлены нулевые значения вместо валюты и суммы.

...
var goalParams =
{
   order_price: 1000.35,
   currency: "RUB"
}
...

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

...
<script type="text/javascript">
    var goalParams =
    {
       order_price: 1000.35,
       currency: "RUB"
    }
</script>
<form action="" method="get" onsubmit="ym(XXXXXX, 'reachGoal', 'TARGET_NAME', goalParams); return true;">
    ...
</form>
...