Tworzenie trackerów

Obiekty śledzące (nazywane też „modułami do śledzenia”) to obiekty, które mogą zbierać i przechowywać dane, a następnie wysyłać je do Google Analytics.

Podczas tworzenia nowego modułu do śledzenia musisz określić identyfikator śledzenia (taki sam jak identyfikator usługi, który odpowiada jednej z Twoich usług w Google Analytics) oraz 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 plik cookie nie istnieje dla określonej domeny, generowany jest identyfikator klienta i jest w nim przechowywany, a użytkownik jest identyfikowany jako nowy. Jeśli plik cookie zawiera wartość identyfikatora klienta, identyfikator klienta jest ustawiany w tagu śledzenia, a użytkownik jest identyfikowany jako powracający.

Po utworzeniu obiekty śledzące zbierają również informacje o bieżącym kontekście przeglądania, takie jak tytuł i adres URL strony, oraz dane o urządzeniu, takie jak rozdzielczość ekranu, rozmiar widocznego obszaru i kodowanie dokumentu. W momencie wysłania danych do Google Analytics wysyłane są wszystkie informacje zapisane w narzędziu śledzącym.

Metoda tworzenia

Biblioteka analytics.js udostępnia różne sposoby tworzenia skryptów śledzenia, ale najpopularniejszym z nich jest użycie polecenia create oraz przekazanie pól identyfikatora śledzenia i domeny pliku cookie jako drugiego i trzeciego parametru:

ga('create', 'UA-XXXXX-Y', 'auto');

Śledzenie nazw

Opcjonalnie możesz też nazwać moduł śledzenia, przesyłając pole name jako czwarty argument w poleceniu create. Nadanie nazwy lokalizatorowi jest konieczne w sytuacji, gdy musisz utworzyć więcej niż jeden tracker dla tej samej strony. Szczegółowe informacje o tym, dlaczego może być to konieczne, znajdziesz w sekcji poświęconej pracy z wieloma trackerami poniżej.

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');

Utworzenie lokalizatora bez skonfigurowania pola name jest nazywane tworzeniem „domyślnego” tagu śledzenia. Domyślny tracker ma wewnętrznie nazwę „t0”.

Określanie pól podczas tworzenia

Można też przekazać opcjonalny obiekt pól, który pozwala skonfigurować dowolne pola analytics.js podczas tworzenia. Będą one przechowywane w module śledzenia i będą stosowane do wszystkich wysyłanych działań.

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker', {
  userId: '12345'
});

Podobnie jak w przypadku wszystkich wywołań funkcji ga(), obiektu Fields może też służyć do określenia wszystkich tych 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órych sekcjami zarządza kilku właścicieli, a każdy z nich może zobaczyć własną usługę.

Aby śledzić dane dla 2 osobnych usług, musisz utworzyć 2 osobne moduły śledzące, z których co najmniej 1 musi być nazwanym trackerem. 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, przed jego nazwą musisz umieścić kropkę i jej nazwę. Jeśli nie określisz nazwy modułu do śledzenia, polecenie zostanie uruchomione na domyślnym urządzeniu śledzącym.

Aby wysłać odsłony z dwóch powyższych elementów śledzących, 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ę poleceń dla wszystkich poleceń analytics.js znajdziesz w dokumentacji kolejki poleceń.

Dalsze kroki

Po utworzeniu trackera może być konieczne uzyskanie dostępu do danych przechowywanych w obiekcie trackera. W następnym przewodniku wyjaśniamy, jak uzyskać i skonfigurować dane trackera.