Przed rozpoczęciem

Sprawna konfiguracja wymaga przygotowania czterech rzeczy. Warto mieć je pod ręką — pozostałe czynności będą proste:

Element	Znaczenie
Konto w panelu	Aktywne konto użytkownika NowMetrix z dostępem do właściwego trackera.
Identyfikator trackera	Wewnętrzny identyfikator witryny, na przykład `TRACKER_ID`.
Dostęp do witryny	Uprawnienie do dodania skryptu śledzącego NowMetrix do szablonu witryny lub menedżera tagów.
Domena produkcyjna	Docelowa nazwa hosta, która powinna pojawić się w NowMetrix, na przykład `example-news.com`.

1. Logowanie do panelu

Należy otworzyć stronę dash.nowmetrix.com i zalogować się. Zostanie wyświetlony widok danych w czasie rzeczywistym dla ostatnio używanego trackera.

Jeśli organizacja korzysta z logowania jednokrotnego, należy użyć metody logowania udostępnionej przez właściciela konta. W przypadku braku dostępu do trackera po zalogowaniu należy poprosić administratora o dodanie użytkownika do właściwej listy trackerów.

2. Znalezienie trackera

Każda witryna ma własny identyfikator trackera. Można traktować go jako etykietę informującą NowMetrix, do której witryny należy przychodząca odsłona. Tego samego identyfikatora należy używać do śledzenia, żądań API i rozwiązywania problemów.

W przykładach i skryptach testowych należy używać neutralnych identyfikatorów. W środowisku produkcyjnym należy zastąpić TRACKER_ID identyfikatorem trackera przypisanym do witryny.

3. Instalacja śledzenia

Należy dodać skrypt do każdej strony, która ma być widoczna w NowMetrix. W przypadku serwisu informacyjnego będą to zwykle strony artykułów, strony sekcji, strony docelowe i strona główna.

<script src="https://ua.realtimely.io/script.js" data-site="TRACKER_ID" defer></script>

Zalecane umiejscowienie:

Umieścić skrypt we wspólnym szablonie strony, wewnątrz sekcji <head>.
Ładować go tylko raz na stronę.
Pozostawić go aktywnym w wariantach stron na komputery i urządzenia mobilne.
Nie blokować go za pomocą mechanizmu zgody na pliki cookie, chyba że wymagają tego względy prawne.

Kanoniczne adresy URL

Domyślnie NowMetrix używa adresu URL z elementu <link rel="canonical" href="…">, aby grupować warianty strony pod tym samym adresem URL artykułu. Jeśli strona nie zawiera linku kanonicznego, NowMetrix używa faktycznie odwiedzonego adresu URL.

Aby używać odwiedzonego adresu URL, nawet gdy link kanoniczny jest obecny, należy dodać data-canonical="false" do istniejącego skryptu śledzącego. Działa to również w przypadku tagu Custom HTML w Google Tag Manager.

<script
    src="https://ua.realtimely.io/script.js"
    data-site="TRACKER_ID"
    data-canonical="false"
    defer
></script>

Aby ponownie włączyć kanoniczne adresy URL, należy usunąć ten atrybut lub ustawić data-canonical="true". To ustawienie zmienia tylko śledzony adres URL; nie włącza ani nie wyłącza automatycznych odsłon.

Jeśli podczas ręcznego wysyłania odsłony zostanie jawnie przekazany parametr url, wskazany adres URL ma pierwszeństwo przed tym ustawieniem.

Link kanoniczny może wskazywać inną domenę. NowMetrix używa domeny i ścieżki z tego linku. Należy wyłączyć kanoniczne adresy URL, jeśli wizyty mają być przypisywane stronie we własnej witrynie.

Google Tag Manager

W Google Tag Manager należy utworzyć tag Custom HTML i wkleić standardowy skrypt NowMetrix. Należy uruchamiać go na wszystkich stronach, które mają być śledzone.

<script src="https://ua.realtimely.io/script.js" data-site="TRACKER_ID" defer></script>

W przypadku tagu Custom HTML należy włączyć opcję Support document.write. Bez tego ustawienia tracker może nie zostać prawidłowo zainicjalizowany w Google Tag Manager.

Śledzenie ręczne

W przypadku większości witryn właściwym wyborem jest śledzenie automatyczne. W przypadku aplikacji typu single-page lub potrzeby pełnej kontroli nad zmianami tras należy wyłączyć je za pomocą data-auto="false" i samodzielnie wysyłać odsłony.

<script src="https://ua.realtimely.io/script.js" data-site="TRACKER_ID" data-auto="false" defer></script>

Ręczne wysyłanie odsłony

<script>
document.addEventListener("DOMContentLoaded", () => {
    realtimely.trackPageview();
});
</script>

Wysyłanie niestandardowych danych strony

Opcjonalnie można przekazać własny adres URL, tytuł lub stronę odsyłającą. Jest to przydatne w aplikacjach typu single-page, niestandardowym routingu lub na stronach, na których widoczny adres URL należy ujednolicić przed śledzeniem.

<script>
document.addEventListener("DOMContentLoaded", () => {
    realtimely.trackPageview("TRACKER_ID", {
        url: "https://example-news.com/about",
        title: "About our publication",
        referrer: "https://google.com"
    });
});
</script>

4. Weryfikacja przychodzących danych

Teraz można sprawdzić efekt: wystarczy opublikować skrypt, otworzyć działającą stronę i przejść do sekcji Najpopularniejsze strony. Wizyta powinna pojawić się w ciągu kilku sekund.

Kontrola	Oczekiwany wynik
Czytelnicy na żywo	Liczba aktywnych użytkowników rośnie po otwarciu stron.
Najpopularniejsze strony	Otwarta strona pojawia się wraz ze ścieżką, tytułem i liczbą aktywnych użytkowników.
Źródła	Źródła bezpośrednie, odsyłające, wyszukiwarki, społecznościowe i UTM są grupowane w widoku Źródła.
Przegląd	Dla trackera zaczynają być naliczane dzienne odsłony i wizyty.

Model ochrony prywatności

NowMetrix działa bez plików cookie i pamięci lokalnej. Używa anonimowych skrótów przez 24 godziny, dzięki czemu można mierzyć dzienną liczbę unikalnych odwiedzających bez tworzenia długoterminowego profilu odwiedzającego.

Anonimizowane dane użytkowników są przechowywane tylko przez 24 godziny. Następnie usuwane są wartości używane do solenia skrótów, dlatego liczba wizyt miesięcznych jest obliczana na podstawie dziennych sum unikalnych odwiedzających.

5. Konfiguracja pierwszego przepływu pracy

Monitorowanie w panelu

Widoki danych w czasie rzeczywistym i panelu pozwalają monitorować aktywnych użytkowników, najpopularniejsze strony, źródła, urządzenia, kraje i dzisiejszy puls.

Dostęp do API

Administratorzy kont i członkowie zespołu z dostępem do API mogą tworzyć osobiste klucze API w sekcji Ustawienia -> API. Lista endpointów i przykładów znajduje się w dokumentacji REST API.

Dostęp zespołu

Gdy dane zaczną napływać, należy zaprosić osoby, które będą z nich korzystać. Każdej osobie należy przyznać dostęp tylko do potrzebnych trackerów; administratorzy zarządzają ustawieniami konta i mogą przyznawać wybranym redaktorom osobisty dostęp do API.

Jeśli członek zespołu nie widzi trackera, przed zmianą instalacji śledzenia należy sprawdzić przypisaną mu listę trackerów.

Starsza integracja

Śledzenie AMP

Tej integracji należy używać tylko wtedy, gdy witryna nadal udostępnia strony AMP. W przypadku nowych instalacji należy użyć standardowego skryptu JavaScript lub konfiguracji Google Tag Manager opisanej powyżej.

Najpierw należy dodać komponent analityczny AMP:

<script async custom-element="amp-analytics" src="https://cdn.ampproject.org/v0/amp-analytics-0.1.js"></script>

Następnie należy dodać konfigurację NowMetrix AMP:

<amp-analytics config="https://ua.realtimely.io/amp/amp.v1.json" data-credentials="include">
    <script type="application/json">
        {"vars": {"accountId": "TRACKER_ID"}}
    </script>
</amp-analytics>

Jeśli dane się nie pojawiają

Potwierdzić obecność skryptu w wyrenderowanym kodzie HTML działającej strony.
Sprawdzić, czy identyfikator trackera jest zgodny z trackerem wybranym w panelu.
Otworzyć narzędzia deweloperskie przeglądarki i poszukać zablokowanych żądań sieciowych.
Sprawdzić, czy strona nie jest udostępniana z pamięci podręcznej szablonu, w którym brakuje skryptu.
Poprosić pomoc techniczną NowMetrix o sprawdzenie, czy tracker odbiera zdarzenia.

Uruchomienie pierwszej witryny w NowMetrix.