ИнтеграцииПодключение

Как подключить скрипт для отслеживания

Подключить скрипт для отслеживания просто — достаточно вставить небольшой код на страницы вашего сайта.  Откройте ваш сайт в панели Finteza и перейдите в раздел "Настройки":

Получите трекинг-код для вашего сайта

Скопируйте трекинг-код и вставьте его на все страницы сайта внутри тегов <head></head>.

Если вы еще не регистрировали сайт в Finteza, нажмите "Добавить" в разделе "Сайты". Укажите название и адрес сайта, и вы сразу получите трекинг-код.


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


Пример кода #

Код подключения выглядит следующим образом:

<script type="text/javascript">
  (function(a,e,f,g,b,c,d){a[b]||(a.FintezaCoreObject=b,a[b]=a[b]||function(){(a[b].q=a[b].q||[]).push(arguments)},a[b].l=1*new Date,c=e.createElement(f),d=e.getElementsByTagName(f)[0],
   c.async=!0,c.defer=!0,c.src=g,d&&d.parentNode&&d.parentNode.insertBefore(c,d))})
  (window,document,"script","{SCRIPT_URL}","fz");
  fz("register","website","{WEBSITE_ID}");
</script>

В скопированном коде {SCRIPT_URL} будет заменен на URL-адрес основного скрипта отслеживания, загружаемого с сервера Finteza. {WEBSITE_ID} будет заменен на идентификатор вашего веб-сайта в панели Finteza.

После подключения кода в главном контексте страниц появится функция fz(). Чтобы проверить ее доступность, выполните в консоли window.fz. С помощью этой функции вызываются методы взаимодействия с Finteza. Например, регистрация веб-сайта:

fz("register","website","{WEBSITE_ID}");

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

(window,document,"script","{SCRIPT_URL}","fz-your-name");
fz-your-name("register","website","{WEBSITE_ID}");

Основной скрипт отслеживания (загружаемый с сервера Finteza) подключается к странице асинхронно — независимо от других элементов. Таким образом, он не будет замедлять загрузку основной страницы.

Параметры регистрации веб-сайта #

Код подключения включает в себя вызов функции fz("register", ...), которая отправляет в Finteza события посещения сайта. Эта функция поддерживает несколько дополнительных параметров:

Параметр

Тип

Описание

trackHash

boolean

Включает отслеживание изменения хэша (якоря) страницы.
 
По умолчанию переходы по якорным ссылкам внутри страницы не отслеживаются. Просмотром страницы считается только первый заход на нее. Для сайтов, где весь контент располагается на одной длинной странице (одностраничное приложение/single page application), такой подход может быть неприемлем.

 

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

trackLinks

boolean

Включает отслеживание переходов по внешним ссылкам, размещенным на странице вашего сайта.

 

Если вы используете множество внешних ссылок на сайте, например, сотрудничаете с рекламной сетью, этот параметр позволит точно определять, каким именно путем пользователи покидают сайт.

 

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

timeOnPage

boolean

Включает точный подсчет времени, проведенного пользователем на странице.

 

По умолчанию система рассчитывает продолжительность нахождения на странице как разницу между временем захода на нее и временем перехода на следующую страницу сайта. Однако для последней посещенной страницы такой расчет невозможен, поскольку переход на следующую страницу отсутствует.

 

Если включить этот параметр, то каждые 15 секунд JavaScript Client будет отправлять в Finteza специальное событие, что пользователь все еще находится на странице. Таким образом вы сможете более точно отследить время нахождения даже для одиночных просмотров.

 

События отправляются только в первые две минуты нахождения пользователя на странице.

Пример включения дополнительных параметров:

fz( "register""website", {
    "id":"cacgfaknbbubiozaeidyvhoisrajbdvjqg",
    "trackHash"true,
    "trackLinks"true,
    "accurateBounceRate"true,
    "timeOnPage"true
} );

Если вы используете Content Security Policy #

Стандарт Content Security Policy предназначен для предотвращения некоторых видов атак на сайт, связанных с внедрением вредоносного кода в его страницы. Если вы используете эту политику безопасности, то в заголовок каждой страницы в строку с соответствующим объявлением добавьте исключение для сайта, с которого загружается трекинг-скрипт Finteza. Например:

Content-Security-Policy: script-src 'self' content.mql5.com;

В ином случае браузеры будут блокировать загрузку core.js, и статистика сайта собираться не будет.

Ускорение загрузки через X-DNS-Prefetch-Control #

Для ускорения загрузки скрипта отслеживания рекомендуем добавить в заголовок всех страниц сайта инструкцию X-DNS-Prefetch-Control:

<meta http-equiv='x-dns-prefetch-control' content='on'>
<link rel='dns-prefetch' href='https://content.mql5.com'>

Она указывает браузеру расположение скрипта, чтобы он мог выполнить резолвинг адреса сразу (при загрузке страницы) и не тратить на это время в момент непосредственной загрузки скрипта.

Проксирование загрузки скрипта через ваш сайт #

Чтобы избежать блокировки загрузки скрипта Finteza, рекомендуем проксировать ее через свои сайты.