Включить необязательные измерения

Мы гордимся тем, что имеем один из самых легких фрагментов JavaScript в аналитической отрасли.

Мы достигаем этого, радикально ограничивая количество параметров в скрипте по умолчанию. Вместо этого мы предлагаем расширенные измерения в качестве дополнительных расширений скрипта, адаптированных к тому, как вы хотите использовать Hisstat. Такой подход гарантирует, что вы загружаете только тот код, который фактически будет использоваться на вашем веб-сайте.

Вы можете включить эти дополнительные измерения при добавлении нового сайта в свою учетную запись Hisstat или в области "Установка сайта" раздела "Общие" в ваших настройках сайта

Фрагмент меняется в зависимости от вашего выбора измерений

Обратите внимание, что фрагмент отслеживания, который вам нужно вставить на ваш сайт, меняется в зависимости от вашего выбора расширенных измерений. При внесении изменений в дополнительные измерения обязательно вставьте на ваш сайт самый новый фрагмент, чтобы все отслеживание работало как положено

Вот список наших дополнительных измерений:

Дополнительное измерение	Объяснение
Исходящие ссылки	Автоматически отслеживать клики по исходящим ссылкам
Загрузки файлов	Автоматически отслеживать загрузки файлов
Страницы с ошибками 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 для отслеживания трафика localhost, ваш фрагмент должен выглядеть следующим образом:

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.revenue.local.js"></script>

И вам нужно вставить только этот фрагмент на свой сайт, больше ничего не нужно.

script.compat.js

Скрипт Histat по умолчанию не будет работать в Internet Explorer, поскольку он использует API document.currentScript для чтения параметров конфигурации. Вы можете запустить Histat в режиме совместимости, включив расширение script.compat.js и определив id="plausible" в теге script, чтобы он мог найти себя. Обратите внимание, что это работает только в IE11 и выше. Вот как это должно выглядеть:

<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></script>

script.manual.js

По умолчанию скрипт Histat запускает просмотр страницы при первой загрузке. Он также присоединяет слушателей к History API и автоматически запускает просмотры страниц, когда вы используете history.pushState. Это полезно для большинства веб-сайтов, но мы также предлагаем ручной режим, если вы хотите полностью контролировать, когда на вашем веб-сайте запускаются просмотры страниц.

Один из вариантов использования этого — когда вы используете Turbo (ранее Turbolinks). В этом случае вы хотите вручную запустить просмотры страниц Hisstat на событии браузера 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 || function() { (window.plausible.q = window.plausible.q || []).push(arguments) }</script>
<!-- инициируйте просмотры страниц при навигации turbolinks -->
<script>
document.addEventListener("turbo:load", function() {
plausible('pageview')
})
</script>

При использовании turbolinks следует убедиться, что скрипт Hisstat не загружается и не выполняется во время турбонавигации. Вам может потребоваться переместить скрипт в раздел <head> вашего сайта или использовать атрибут data-turbo-eval="false", чтобы сделать это.

примечание

При использовании manual.js каждый вызов скрипта с 'pageview' приводит к подсчету отдельного просмотра страницы, даже если он вызван на той же странице

Укажите пользовательские местоположения для URL-адресов ваших страниц

Кроме того, расширение скрипта manual позволяет вам предоставлять специальную опцию с именем 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.