Jak działa kod analytics.js

Korzystając z kolejki poleceń ga(), możesz wykonać prawie wszystko, co musisz mierzyć za pomocą tagu analytics.js. Ten przewodnik wyjaśnia, czym jest kolejka poleceń, jak działa i jak wykonywać polecenia służące do pomiaru interakcji użytkowników.

Kolejka poleceń ga

Tag Google Analytics określa globalną funkcję ga o nazwie "kolejka poleceń&quot. Nazywa się to kolejką poleceń, ponieważ zamiast wykonywać otrzymane polecenia, dodaje je do kolejki opóźnionej do momentu pełnego wczytania biblioteki analytics.js.

W języku JavaScript funkcje są też obiektami, co oznacza, że mogą zawierać właściwości. Tag Google Analytics definiuje właściwość q w obiekcie funkcji ga jako pustą tablicę. Przed wczytaniem biblioteki analytics.js wywołanie funkcji ga() dołącza na końcu tablicy q listę argumentów przekazywanych do funkcji ga().

Jeśli na przykład chcesz uruchomić tag Google Analytics, a następnie natychmiast zarejestrować zawartość ga.q w konsoli, zobaczysz tablicę o długości dwóch elementów zawierającej dwa zestawy argumentów, które zostały już przekazane do funkcji ga():

console.log(ga.q);

// Outputs the following:
// [
//   ['create', 'UA-XXXXX-Y', 'auto'],
//   ['send', 'pageview']
// ]

Po wczytaniu biblioteki analytics.js sprawdza ona zawartość tablicy ga.q i wykonuje po kolei wszystkie polecenia. Po tym czasie funkcja ga() zostaje przedefiniowana, więc wszystkie następne wywołania są wykonywane natychmiast.

Ten wzorzec pozwala deweloperom korzystać z kolejki poleceń ga() bez obawy, że biblioteka analytics.js została wczytana. Ma on prosty, synchroniczny interfejs, który eliminuje większość złożoności kodu asynchronicznego.

Dodawanie poleceń do kolejki

Wszystkie wywołania kolejki poleceń ga() mają wspólny podpis. Pierwszy parametr „"command"” jest ciągiem identyfikującym konkretną metodę analytics.js. Wszelkie dodatkowe parametry to argumenty przekazywane do tej metody.

Metoda, do której odwołuje się dane polecenie, może być metodą globalną, taką jak create, metodą w obiekcie ga lub metodą instancji w obiekcie trackera, np. send. Jeśli kolejka poleceń ga() otrzyma polecenie, którego nie rozpoznaje, po prostu ją zignoruje, przez co wywołania funkcji ga() będą bardzo bezpieczne, ponieważ prawie nigdy nie spowoduje to błędu.

Pełną listę wszystkich poleceń, które można wykonywać w kolejce poleceń, znajdziesz w ga()kolejce poleceń.

Parametry polecenia

Większość poleceń analytics.js (i odpowiadające im metody) akceptuje parametry w wielu różnych formatach. Ma to na celu ułatwienie przekazywania często używanych pól do określonych metod.

Weźmy za przykład dwa polecenia w tagu Google Analytics:

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

W pierwszym poleceniu create akceptuje pola odpowiednio trackingId, cookieDomain i name jako drugie, trzecie i czwarte parametry. Polecenie send akceptuje opcjonalny drugi parametr hitType.

Wszystkie polecenia akceptują końcowy parametr fieldsObject, którego można też używać do określania pól. Na przykład powyższe dwa polecenia w tagu mogą zostać przepisane tak:

ga('create', {
  trackingId: 'UA-XXXXX-Y',
  cookieDomain: 'auto'
});
ga('send', {
  hitType: 'pageview'
});

Pełną listę opcjonalnych parametrów dozwolonych dla poszczególnych poleceń znajdziesz w dokumentacji kolejki poleceń ga().

Dalsze kroki

Z tego przewodnika dowiesz się, jak uruchamiać polecenia za pomocą tagu analytics.js i jak działa kolejka poleceń. W następnym przewodniku omawiamy tworzenie obiektów trackera.