Włącz opcjonalne pomiary
Jesteśmy dumni, że mamy jeden z najlżejszych fragmentów kodu JavaScript w branży analitycznej.
Uzyskujemy to poprzez radykalne ograniczenie liczby opcji w domyślnym skrypcie. Zamiast tego oferujemy ulepszone pomiary jako opcjonalne rozszerzenia skryptu dostosowane do sposobu, w jaki chcesz używać Histat. To podejście zapewnia, że ładujesz tylko kod, który faktycznie będzie używany w Twojej witrynie.
Możesz włączyć te opcjonalne pomiary podczas dodawania nowej witryny do konta Histát lub w obszarze „Instalacja witryny” sekcji „Ogólne” w swoich ustawieniach witryny
Należy pamiętać, że fragment kodu śledzenia, który należy wstawić do witryny, zmienia się w zależności od wybranych ulepszonych pomiarów. Podczas wprowadzania zmian w opcjonalnych pomiarach należy upewnić się, że wstawiono najnowszy fragment kodu do witryny, aby wszystkie funkcje śledzenia działały zgodnie z oczekiwaniami
Oto lista naszych opcjonalnych pomiarów:
| Opcjonalny pomiar | Wyjaśnienie |
|---|---|
| Linki wychodzące | Automatyczne śledzenie kliknięć w linki wychodzące |
| Pobieranie plików | Automatyczne śledzenie pobierania plików |
| Strony błędów 404 | Automatyczne śledzenie stron błędów 404 |
| Ścieżki stron z haszowaniem | Automatyczne śledzenie ścieżek stron, które używają # w adresie URL trasowanie oparte na haszowaniu |
| Zdarzenia niestandardowe | Umożliwia śledzenie zdarzeń niestandardowych, takich jak kliknięcia linków, przesyłanie formularzy i kliknięcia dowolnych innych elementów HTML |
| Właściwości niestandardowe | Umożliwia dołączanie właściwości niestandardowych (znanych również jako wymiary niestandardowe w Google Analytics) podczas wysyłania wyświetlenia strony lub zdarzenia niestandardowego w celu utworzenia niestandardowych metryk |
| Przychody z handlu elektronicznego | Umożliwia przypisywanie dynamicznych wartości pieniężnych do zdarzeń niestandardowych i śledzenie atrybucji przychodów |
Zaawansowane opcje śledzenia
Oprócz powyższej listy (script.outbound-links.js, script.file-downloads.js, script.hash.js, script.tagged-events.js, script.pageview-props.js i script.revenue.js), mamy również kilka bardziej zaawansowanych opcji śledzenia. Należy pamiętać, że nie są one uwzględnione na liście powitalnej witryny, więc trzeba je będzie ręcznie wstawić do fragmentu kodu śledzenia.
| Rozszerzenie | Wyjaśnienie |
|---|---|
| script.compat.js | Tryb zgodności dla śledzenia użytkowników w przeglądarce Internet Explorer (≥IE11) |
| script.local.js | Zezwalaj na śledzenie analityki również na hoście lokalnym, co jest przydatne w aplikacjach hybrydowych |
| script.manual.js | Nie wyzwalaj automatycznie odsłon stron . Pozwala również na określenie niestandardowych lokalizacji w celu redagowania adresów URL z identyfikatorami. Można go również użyć do śledzenia niestandardowych parametrów zapytania |
Jak ręcznie zmienić fragment kodu śledzenia
Na przykład domyślna nazwa skryptu w naszym fragmencie kodu to script.js. Jeśli Twoja witryna znajduje się na hoście lokalnym i chcesz śledzić te wizyty, masz możliwość załadowania skryptu z innym rozszerzeniem: script.local.js.
W tym przypadku fragment, który musisz wstawić do swojej witryny, wygląda następująco (pamiętaj o zmianie atrybutu data-domain na domenę, którą dodałeś do Histatu):
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.local.js"></script>
Możesz dowolnie mieszać i dopasowywać te rozszerzenia. Na przykład, jeśli chcesz używać zarówno naszego routingu opartego na haszu, jak i śledzenia kliknięć w linki wychodzące, możesz je połączyć w następujący sposób: script.hash.outbound-links.js.
W tym przypadku fragment, który musisz wstawić do swojej witryny, wygląda następująco (pamiętaj o zmianie atrybutu data-domain na domenę, którą dodałeś do Histatu):
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.hash.outbound-links.js"></script>
Albo powiedzmy, że chcesz użyć naszego rozszerzenia script.revenue.js do śledzenia przychodów z handlu elektronicznego i naszego rozszerzenia script.local.js do śledzenia ruchu lokalnego, Twój fragment powinien wyglądać następująco:
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.revenue.local.js"></script>
I wystarczy, że wstawisz tylko ten jeden fragment do swojej witryny, nie potrzebujesz niczego więcej.
script.compat.js
Domyślny skrypt Histata nie będzie działał w przeglądarce Internet Explorer, ponieważ używa interfejsu API document.currentScript do odczytywania opcji konfiguracji. Możesz uruchomić Histata w trybie zgodności, dołączając rozszerzenie script.compat.js i definiując id="plausible" w znaczniku skryptu, aby mógł się odnaleźć. Należy pamiętać, że działa to tylko w wersjach ≥ IE11. Oto, jak powinno to wyglądać:
<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></script>
script.manual.js
Domyślnie skrypt Histata wyzwala wyświetlenie strony po pierwszym załadowaniu. Dołącza również słuchaczy do History API i automatycznie wyzwala wyświetlenia stron, gdy używasz history.pushState. Jest to przydatne w przypadku większości witryn, ale oferujemy również tryb ręczny, jeśli chcesz mieć pełną kontrolę nad tym, kiedy wyświetlenia stron są wyzwalane w Twojej witrynie.
Jednym z przypadków użycia jest użycie Turbo (dawniej Turbolinks). W takim przypadku chcesz ręcznie wyzwalać wyświetlenia stron Histatu w zdarzeniu przeglądarki turbo:load lub turbolinks:load, w zależności od używanej biblioteki. Oto jak możesz to zrobić:
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.manual.js"></script>
<!-- zdefiniuj funkcję `plausible`, aby ręcznie wyzwalać zdarzenia -->
<script>window.plausible = window.plausible || function() { (window.plausible.q = window.plausible.q || []).push(arguments) </script>
<!-- wyzwalaj wyświetlenia stron w nawigacji turbolinks -->
<script>
document.addEventListener("turbo:load", function() {
plausible('pageview')
})
</script>
Podczas korzystania z turbolinks należy upewnić się, że skrypt Histatu nie jest ładowany i wykonywany podczas nawigacji turbo. Może być konieczne przeniesienie skryptu do sekcji <head> swojej witryny lub użycie atrybutu data-turbo-eval="false", aby to zrobić.
Podczas korzystania z manual.js każde wywołanie skryptu z 'pageview' powoduje zliczenie osobnej odsłony strony, nawet jeśli zostanie wywołane na tej samej stronie
Określ niestandardowe lokalizacje dla adresów URL stron
Ponadto rozszerzenie skryptu manual pozwala na podanie specjalnej opcji o nazwie u wraz z wydarzeniami. Pozwala to na określenie adresu URL strony i może być używane do określania niestandardowych lokalizacji.
Szczególnie pomocne jest redagowanie i agregowanie wielu stron, których adresy URL zawierają identyfikatory specyficzne dla użytkowników.
Śledź niestandardowe parametry zapytania dla całych adresów URL stron
Domyślnie Histát usuwa wszystkie parametry zapytania ze względów prywatności ref, source, utm_source, utm_medium, utm_campaign, utm_content i utm_term.
Oznacza to, że strony takie jak yoursite.com/blog/index.php?article=some_article&page=11 będą zgłaszane jako yoursite.com/blog/index.php w raporcie „Najpopularniejsze strony” na pulpicie nawigacyjnym Histát.