Obiekty śledzące (zwane też „modułami śledzenia”) to obiekty, które mogą zbierać i przechowywać dane oraz wysyłać je do Google Analytics.
Podczas tworzenia nowego modułu do śledzenia musisz podać identyfikator śledzenia (taki sam jak identyfikator usługi odpowiadający jednej z Twoich usług w Google Analytics), a także domenę pliku cookie, która określa sposób przechowywania plików cookie. (Zalecana wartość 'auto' określa automatyczną konfigurację domeny plików cookie).
Jeśli dla określonej domeny nie istnieje plik cookie, generowany jest identyfikator klienta i jest w nim przechowywany, a użytkownik zostaje identyfikowany jako nowy. Jeśli plik cookie zawiera wartość identyfikatora klienta, identyfikator klienta jest ustawiany w module śledzenia, a użytkownik jest identyfikowany jako powracający.
Po utworzeniu obiekty śledzące gromadzą również informacje o bieżącym kontekście przeglądania, np. tytuł i adres URL strony, oraz dane o urządzeniu, takie jak rozdzielczość ekranu, rozmiar widocznego obszaru i kodowanie dokumentu. W chwili wysłania danych do Google Analytics wysyłane są wszystkie informacje przechowywane obecnie w trackerze.
Metoda tworzenia
Biblioteka analytics.js udostępnia różne sposoby tworzenia skryptów śledzenia, ale najpowszechniejszym z nich jest użycie polecenia create i przekazanie pól identyfikatora śledzenia oraz domeny pliku cookie jako drugiego i trzeciego parametru:
ga('create', 'UA-XXXXX-Y', 'auto');
Śledzenie nazw
Opcjonalnie możesz też nazwać moduł śledzenia, przekazując pole name jako czwarty argument w poleceniu create. Nadanie nazwy elementowi śledzącemu jest konieczne w przypadku, gdy trzeba utworzyć więcej niż jeden element śledzący dla tej samej strony. Szczegółowe informacje o tym, dlaczego jest to konieczne, znajdziesz w sekcji poniżej poświęconej pracy z wieloma trackerami.
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');
Utworzenie skryptu śledzenia bez ustawienia w polu name jest nazywane tworzeniem „domyślnego” modułu śledzenia. Domyślny tracker otrzymuje wewnętrznie nazwę „t0”.
Określanie pól podczas tworzenia
Możesz też przekazać opcjonalny obiekt Fields, który pozwoli ustawić dowolne z pól analytics.js w momencie utworzenia. Będzie on przechowywany w module śledzenia i będzie stosowany do wszystkich wysyłanych działań.
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker', {
userId: '12345'
});
Tak jak w przypadku wszystkich wywołań funkcji ga(), obiekt Fields może też służyć do określenia wszystkich pól razem:
ga('create', {
trackingId: 'UA-XXXXX-Y',
cookieDomain: 'auto',
name: 'myTracker',
userId: '12345'
});
Więcej informacji znajdziesz w dokumentacji metody create.
Praca z wieloma trackerami
W niektórych przypadkach możesz chcieć wysyłać dane do wielu usług z jednej strony. Jest to przydatne w przypadku witryn, które mają kilku właścicieli nadzorujących sekcje witryny, ponieważ każdy z nich może wyświetlić własną usługę.
Aby śledzić dane dla 2 osobnych usług, musisz utworzyć 2 osobne elementy śledzące i przynajmniej jeden z nich musi być nazwanym modułem śledzącym. Poniższe dwa polecenia tworzą domyślny tracker i tracker o nazwie „clientTracker”:
ga('create', 'UA-XXXXX-Y', 'auto');
ga('create', 'UA-XXXXX-Z', 'auto', 'clientTracker');
Uruchamianie poleceń dla konkretnego trackera
Aby uruchomić polecenia analytics.js dla określonego modułu śledzącego, należy poprzedzić jego nazwę nazwą skryptu śledzenia, po której następuje kropka. Jeśli nie określisz nazwy modułu do śledzenia, polecenie będzie uruchamiane w domyślnym module śledzącym.
Aby wysłać odsłony z dwóch powyższych skryptów śledzenia, uruchom następujące dwa polecenia:
ga('send', 'pageview');
ga('clientTracker.send', 'pageview');
W kolejnych przewodnikach znajdziesz bardziej szczegółowe informacje o składni uruchamiania konkretnych poleceń. Pełną składnię wszystkich poleceń analytics.js znajdziesz w dokumentacji kolejki poleceń.
Dalsze kroki
Po utworzeniu modułu śledzenia może być konieczne uzyskanie dostępu do danych przechowywanych w obiekcie. W następnym przewodniku wyjaśniamy, jak uzyskać i ustawić dane trackera.