reachGoal

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

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

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

Параметр

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

 Тип

Описание
target * —

String

Название цели. Задается на странице редактирования счетчика при создании или изменении цели типа Событие JavaScript
callback —

Function

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

ctx —

Object

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

params —

Object

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

Параметр

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

 Тип

Описание
target * —

String

Название цели. Задается на странице редактирования счетчика при создании или изменении цели типа Событие JavaScript
callback —

Function

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

ctx —

Object

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

params —

Object

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

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

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

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

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

    yaCounterXXXXXX.reachGoal('TARGET_NAME');

    где:

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

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

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

Примеры

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

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

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

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

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

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

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

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

Параметр

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

 Тип

Описание
order_price —

Double

Цена цели
currency —

String

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

Список поддерживаемых валют
  • RUB — российский рубль;
  • UAH — украинская гривна;
  • BYN — белорусский рубль;
  • EUR — евро;
  • USD — доллар США;
  • GBP — фунт стерлингов;
  • TRY — турецкая лира;
  • AUD — австралийский доллар;
  • CAD — канадский доллар;
  • CNY — китайский юань;
  • KZT — казахстанский тенге;
  • TMT — туркменский манат;
  • LVL — латвийский лат;
  • MDL — молдавский лей;
  • CHF — швейцарский франк;
  • THB — тайский бат;
  • YND — условные единицы.

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

Параметр

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

 Тип

Описание
order_price —

Double

Цена цели
currency —

String

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

Список поддерживаемых валют
  • RUB — российский рубль;
  • UAH — украинская гривна;
  • BYN — белорусский рубль;
  • EUR — евро;
  • USD — доллар США;
  • GBP — фунт стерлингов;
  • TRY — турецкая лира;
  • AUD — австралийский доллар;
  • CAD — канадский доллар;
  • CNY — китайский юань;
  • KZT — казахстанский тенге;
  • TMT — туркменский манат;
  • LVL — латвийский лат;
  • MDL — молдавский лей;
  • CHF — швейцарский франк;
  • THB — тайский бат;
  • YND — условные единицы.

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

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