Skip to main content

Уключыць дадатковыя вымярэнні

Мы ганарымся тым, што маем адзін з самых лёгкіх фрагментаў 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 запускае прагляд старонкі пры першай загрузцы. Ён таксама далучае слухачоў да History 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>
<!-- вызначыць функцыю `праўдападобна` для ўручную запуску падзей -->
<script>window.plausible = window.plausible || функцыя() { (window.plausible.q = window.plausible.q || []).push(аргументы) }</script>
<!-- запускаць прагляды старонак у навігацыі па турбаспасылках -->
<скрыпт>
document.addEventListener("turbo:load", function() {
  праўдападобны ('прагляд старонкі')
})
</script>

Пры выкарыстанні turbolinks вы павінны пераканацца, што скрыпт 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.