Метрика

reachGoal

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

Передача інформації про досягнення цілі.

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

Параметр

Значення за замовчуванням

Тип

Опис

target *
[no-highlight[

* Обов‘язковий параметр.

]no-highlight]

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>

Ціна (цінність) цілі

Ціну цілі можна передавати, навіть якщо сайт не є інтернет-магазином. Зазначена сума буде передаватися при кожному досягненні цілі. Це допоможе враховувати її комерційну ефективність.

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

Ця інформація буде доступна у звітах, якщо в інтерфейсі Метрики додати цільову метрику
[no-highlight[

Числова величина, яка розраховується на основі атрибута цільового візиту. Ця величина може бути загальною або середньою. Наприклад, досягнення цілі розраховуються як сума значень, досягнення на відвідувача — як середнє значення.

]no-highlight]
Дохід. Докладніше див. розділ Використання цілей у звітах.

Параметр

Значення за замовчуванням

Тип

Опис

order_price

Double

Ціна цілі

currency

String

Трилітерний код валюти за ISO 4217.

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

Якщо передається інша валюта, буде надіслано нульові значення замість валюти і суми.

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