Korzystanie z wtyczek

Wtyczki to skrypty wzbogacające działanie biblioteki analytics.js, które ułatwiają pomiar interakcji użytkowników. Wtyczki mają zazwyczaj specyficzny zestaw funkcji, które mogą nie być wymagane przez wszystkich użytkowników Google Analytics (np. ecommerce czy pomiar w wielu domenach), dlatego nie są domyślnie uwzględnione w kodzie analytics.js.

Z tego przewodnika dowiesz się, jak wymagać wtyczek analytics.js i ich używać.

Wymaganie wtyczek

Polecenie require pobiera nazwę wtyczki i rejestruje ją do użycia w kolejce poleceń ga(). Jeśli wtyczka akceptuje opcje konfiguracji, można je przekazać jako ostatni argument w poleceniu require.

Oto pełny podpis polecenia require:

ga('[trackerName.]require', pluginName, [pluginOptions]);

Oto jak potrzebujesz wtyczki Ulepszone e-commerce, by używać jej z domyślnym modułem do śledzenia:

ga('require', 'ec');

Oto jak potrzebujesz wtyczki Funkcje reklamowe do śledzenia o nazwie „myTracker” i przekazać opcję konfiguracji, która zastąpi wartość domyślnej nazwy pliku cookie:

ga('myTracker.require', 'displayfeatures', {
  cookieName: 'display_features_cookie'
});

Wczytuję kod wtyczki

Polecenie require inicjuje metody wtyczki na potrzeby kolejki poleceń ga(), ale nie wczytuje samego skryptu wtyczki. Jeśli korzystasz z wtyczki innej firmy lub tworzysz wtyczkę samodzielnie, musisz ręcznie dodać kod wtyczki do strony.

Zalecana metoda dodawania kodu wtyczki do strony to użycie tagu <script> z ustawionym atrybutem async. Dzięki temu nie będzie ona blokować ładowania innych funkcji w witrynie.

Ten kod wymaga i wczytuje hipotetyczną wtyczkę do śledzenia linków:

<script>
ga('create', 'UA-XXXXX-Y', 'auto');
ga('require', 'linkTracker');
ga('send', 'pageview');
</script>

<!--Note: plugin scripts must be included after the tracking snippet. -->
<script async src="/path/to/link-tracker-plugin.js"></script>

Uwaga: oficjalne wtyczki Google Analytics dotyczące tagu analytics.js są wczytywane automatycznie, gdy są potrzebne. Nie trzeba dodawać do nich tagów skryptu. Pełną listę oficjalnych wtyczek analytics.js znajdziesz w sekcji Oficjalne wtyczki w panelu nawigacyjnym po lewej stronie.

Czekam na wczytanie wtyczek

Ponieważ zarówno biblioteka analytics.js, jak i wtyczki analytics.js są ładowane asynchronicznie, określenie, kiedy wtyczki są w pełni wczytane i gotowe do użycia, może być trudne.

Biblioteka analytics.js rozwiązuje ten problem, wstrzymując wykonywanie kolejki poleceń po napotkaniu polecenia require dla wtyczki, która nie została jeszcze wczytana. Po wczytaniu wtyczki kolejka będzie kontynuowana w zwykły sposób.

Z tego względu niezwykle ważne jest przetestowanie używanych wtyczek w celu sprawdzenia, czy ładują się i działają prawidłowo. Jeśli wtyczki nie uda się wczytać lub wystąpi błąd, jej wykonanie uniemożliwi wykonanie wszystkich kolejnych poleceń analytics.js.

Wywoływanie metod wtyczek

Gdy wymagasz wtyczki, metody te stają się dostępne do użycia w kolejce poleceń ga(). Oto podpis polecenia do wywoływania metod wtyczek:

ga('[trackerName.][pluginName:]methodName', ...args);

Na przykład metoda addProduct wtyczki Ulepszone e-commerce może wyglądać tak:

ga('ec:addProduct', {
  'id': 'P12345',
  'quantity': 1
});

W przypadku nazwanego narzędzia śledzącego możesz też dodać nazwę skryptu śledzenia do ciągu poleceń:

ga('myTracker.ec:addProduct', {
  'id': 'P12345',
  'quantity': 1
});

Dalsze kroki

Jeśli znasz już wszystkie przewodniki z tej sekcji, prawdopodobnie znasz większość funkcji biblioteki analytics.js. W następnym przewodniku opisujemy, jak debugować implementacje analytics.js, by łatwiej wykrywać błędy i dokładniej sprawdzać działanie kodu.