Увімкніть додаткові вимірювання
Ми пишаємося тим, що маємо один із найпростіших фрагментів JavaScript у галузі аналітики.
Ми досягаємо цього, радикально обмежуючи кількість параметрів у типовому сценарії. Натомість ми пропонуємо розширені вимірювання як додаткові розширення сценаріїв, адаптовані до того, як ви хочете використовувати Histat. Цей підхід гарантує, що ви завантажуєте лише той код, який фактично використовуватиметься на вашому веб-сайті.
Ви можете ввімкнути ці додаткові вимірювання під час додавання нового сайту до свого облікового запису Histat або в області «Встановлення сайту» розділу «Загальні» в параметрах сайту.
Зауважте, що фрагмент відстеження, який потрібно вставити на свій сайт, змінюється залежно від вибраного вами розширеного вимірювання. Вносячи зміни до додаткових вимірювань, обов’язково вставте найновіший фрагмент на свій сайт, щоб усе відстеження працювало належним чином
Ось список наших додаткових вимірювань:
| Додаткове вимірювання | Пояснення |
|--------------------------|-------------------- -------------------------------------------------- ----------------------------|
| Вихідні посилання | Автоматично відстежувати кліки вихідних посилань |
| Завантаження файлів | Автоматично відстежувати завантаження файлів |
| 404 сторінки помилок | Автоматично відстежувати сторінки з помилками 404 |
| Хешовані шляхи сторінок | Автоматично відстежувати шляхи сторінок, які використовують # в URL-адресі на основі хеш-маршрутизації |
| Спеціальні події | Дозволяє «відстежувати спеціальні події», такі як клацання посилань, надсилання форм та клацання будь-яких інших елементів HTML |
| Спеціальні властивості | Дозволяє додавати спеціальні властивості (також відомі як спеціальні параметри в Google Analytics) під час надсилання перегляду сторінки або спеціальної події для створення спеціальних показників |
| Дохід від електронної комерції | Дозволяє призначати динамічні грошові значення користувацьким подіям і відстежувати віднесення доходу |
Розширені параметри відстеження
На додаток до наведеного вище списку (script.outbound-links.js, script.file-downloads.js, script.hash.js, script.tagged-events.js, script.pageview- props.js і script.revenue.js), ми також маємо деякі розширеніші параметри відстеження. Зверніть увагу, що вони не включені до списку реєстрації сайту, тому вам потрібно буде вставити їх у свій фрагмент відстеження вручну.
| Розширення | Пояснення |
|--------------------------|-------------------- -------------------------------------------------- ----------------------------|
| script.compat.js | Режим сумісності для «відстеження користувачів в Internet Explorer» (≥IE11) |
| script.local.js | Дозволити аналітиці також відстежувати локальний хост, що корисно в гібридних програмах |
| script.manual.js | Не ініціювати перегляди сторінок автоматично. Також дозволяє вказати користувацькі місця, щоб редагувати URL-адреси з ідентифікаторами. Ви також можете використовувати його для відстеження спеціальних параметрів запиту|
Як вручну змінити фрагмент відстеження
Наприклад, назва сценарію за умовчанням у нашому фрагменті — script.js. Якщо ваш веб-сайт розміщено на локальному хості, і ви хочете відстежувати ці відвідування, у вас є можливість завантажити сценарій з іншим розширенням: script.local.js.
У цьому випадку фрагмент коду, який потрібно вставити на свій сайт, має такий вигляд (обов’язково змініть атрибут data-domain на домен, який ви додали до Histat):
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.local.js"></script>
Ви можете поєднувати та комбінувати ці розширення як завгодно. Наприклад, якщо ви хочете використовувати як нашу маршрутизацію на основі хешу, так і наше відстеження кліків вихідних посилань, ви можете поєднати їх таким чином: script.hash.outbound-links.js.
У цьому випадку фрагмент коду, який потрібно вставити на свій сайт, має такий вигляд (обов’язково змініть атрибут data-domain на домен, який ви додали до Histat):
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.hash.outbound-links.js"></script>
Або скажімо, ви хочете використовувати наше розширення script.revenue.js для відстеження доходу від електронної комерції та наше розширення script.local.js для відстеження трафіку локального хосту, ваш фрагмент має виглядати так:
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.revenue.local.js"></script>
І вам потрібно лише вставити цей фрагмент на свій сайт, більше нічого не потрібно.
script.compat.js
Сценарій Histat за умовчанням не працюватиме в Internet Explorer, оскільки він використовує document.currentScript API для читання параметрів конфігурації. Ви можете запустити Histat у режимі сумісності, включивши розширення script.compat.js і визначивши id="plausible" у тегу сценарію, щоб він міг знайти себе. Зверніть увагу, що це працює лише на ≥ IE11. Ось як це має виглядати:
<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></script>
script.manual.js
За замовчуванням сценарій Histat ініціює перегляд сторінки під час першого завантаження. Він також приєднує слухачів до API історії та автоматично запускає перегляди сторінок, коли ви використовуєте history.pushState. Це корисно для більшості веб-сайтів, але ми також пропонуємо ручний режим, якщо ви хочете повністю контролювати, коли на вашому веб-сайті запускаються перегляди сторінок.
Одним із варіантів використання цього є використання Turbo (раніше Turbolinks). У цьому випадку ви хочете вручну активувати перегляди сторінки Histat у події браузера turbo:load або turbolinks:load залежно від того, яку бібліотеку ви використовуєте. Ось як ви можете це зробити:
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.manual.js"></script>
<!-- визначте функцію `plausible` для ручного запуску подій -->
<script>window.plausible = window.plausible || функція() { (window.plausible.q = window.plausible.q || []).push(аргументи) }</script>
<!-- ініціювати перегляди сторінок у навігації Turbolinks -->
<script>
document.addEventListener("turbo:load", function() {
plausible('pageview')
})
</script>
Використовуючи турболінки, ви повинні переконатися, що сценарій Histat не завантажується та не виконується під час турбо-навігації. Можливо, вам знадобиться перемістити сценарій у розділ <head> вашого веб-сайту або використати для цього атрибут data-turbo-eval="false".
Під час використання manual.js кожен виклик сценарію з 'pageview' призводить до того, що зараховується окремий перегляд сторінки, навіть якщо він викликається на тій самій сторінці
Укажіть спеціальні місця для URL-адрес вашої сторінки
Крім того, ручне розширення сценарію дозволяє вам надавати спеціальну опцію під назвою u для ваших подій. Це дозволяє вказати URL-адресу сторінки та може використовуватися для визначення власних розташувань.
Особливо корисно редагувати та об’єднувати кілька сторінок, URL-адреси яких містять ідентифікатори, які є специфічними для користувачів.
Відстежуйте користувацькі параметри запиту для повних URL-адрес сторінок
За замовчуванням Histat видаляє всі параметри запиту з міркувань конфіденційності ref, source, utm_source, utm_medium, utm_campaign, utm_content і utm_term.
Це означає, що такі сторінки, як yoursite.com/blog/index.php?article=some_article&page=11, повідомлятимуться як yoursite.com/blog/index.php у звіті "Найпопулярніші сторінки" вашого Інформаційна панель Histat.