reachGoal

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

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

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

Параметр

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

Тип

Опис

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>

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

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

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

Ця інформація буде доступна у звітах, якщо в інтерфейсі Метрики додати цільову метрику Дохід. Докладніше див. розділ Використання цілей у звітах.

Параметр

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

Тип

Опис

order_price

Double

Ціна цілі

currency

String

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

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

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