Как отправлять события

После подключения Finteza JavaScript Client вы можете отправлять события о действиях пользователей на сайте в Finteza. Для этого добавьте на страницу сайта JavaScript-код следующего вида:

fz( "event""{EVENT_NAME}" );

Вместо {EVENT_NAME}, укажите название события, например "Registration".

Проверьте работу кода, выполнив его через консоль браузера. В случае успеха вы увидите соответствующую запись в отчете "События" по вашему сайту в панели Finteza.

Успешно зарегистрированное событие в панели Finteza

Дополнительные данные в параметрах событий #

В событиях, отправляемых в Finteza, можно указывать дополнительную информацию в виде параметров. Например, вид приобретенного товара, сумму покупки, валюту и т.д.

fz( "event", {
  name:  "{EVENT_NAME}",
  unit:  "{UNIT}",
  value: {VALUE}
});

В качестве {EVENT_NAME} укажите название события. Далее указываются параметры:

Параметр

Тип

Описание

unit

string

Единицы измерения параметра. Например, USD, штуки и т.д. Максимальная длина 32 символа.

value

number

Значение параметра. Максимальная длина 64 символа.

Пример:

fz( "event", {
  name:  "Purchase",
  unit:  "USD",
  value: 100
});

Варианты отправки событий со страницы #

В зависимости от того, какое событие вы отслеживаете, трекинг-код следует вставлять в определенные теги страницы.

Отправка события при заполнении формы:

<form action="" method="get" onsubmit="fz('event', 'Form+Order+Submit'); return true;">
    ...
</form>

Отправка события при нажатии на кнопку:

<form action="">
    ...
    <input type="button" onclick="fz('event', 'Form+Order+Submit'); return true;" value="Order" />
</form>

Отправка события по клику по ссылке:

<a href="https://www.example.com/" onclick="fz('event', 'Click+Link'); return true;">www.example.com</a>

Отправка события при загрузке страницы:

<body>
...
<script type="text/javascript">
  fz("event","Page+Order+Load");
</script>
...
</body>

Автоматическая обработка кликов по ссылкам #

Добавьте в ссылки на своем сайте атрибуты data-fz-event и укажите в них названия событий, которые нужно отправлять в Finteza при нажатии. Finteza JavaScript Client автоматически находит и обрабатывает переходы по всем подобным ссылкам на странице.

<a data-fz-event="Click+Link" href="https://www.example.com/">www.example.com</a>

Этот вариант можно использовать вместо добавления в ссылки атрибутов onclick с полным описанием вызова fz().  Он проще и удобнее.

Аналогичным образом вместе с событиями вы можете передавать дополнительные параметры unit и value. Для этого используйте атрибуты data-fz-unit и data-fz-value:

<a data-fz-event="Click+Link" data-fz-unit="USD" data-fz-value="100" href="https://www.example.com/buy">Buy Product</a>

Для моментальных страниц Google AMP, где используется своя версия трекинг-кода, существует дополнительное требование к именованию атрибутов — они должны начинаться с префикса "data-vars". Поэтому для автоматической обработки кликов по ссылкам на таких страницах добавляйте в них атрибуты data-vars-fz:

<a data-vars-fz="Click+Link" href="https://www.example.com/">www.example.com</a>

Чтобы не запутаться в именовании, вы можете везде использовать атрибуты data-vars-fz . Они поддерживаются не только на страницах Google AMP, но и на обычных, где установлен стандартный трекинг-код.


Обратный вызов #

Если вам необходимо обработать событие отправки, укажите в коде события функцию обратного вызова. Измените второй аргумент вызова следующим образом:

fz( "event", {
  name:  "Your Event Name",
  unit:  "USD",
  value: 100,
  callback: function() {
...
    // event sending completed
  }
} );

Он будет представлять собой объект, в котором указаны имя события и ссылка на функцию-обработчик.