Wtyczki to skrypty, które zwiększają funkcjonalność analytics.js, aby pomóc w mierzeniu interakcji użytkownika. Wtyczki są zazwyczaj specyficzne dla zestawu funkcji, które mogą nie być wymagane przez wszystkich użytkowników Google Analytics, takich jak handel elektroniczny lub pomiar domen krzyżowych, i dlatego nie są domyślnie włączone do analytics.js.

Ten przewodnik wyjaśnia, jak wymagać i używać wtyczek analytics.js.

Wymaganie wtyczek

Komenda require pobiera nazwę wtyczki i rejestruje ją do użycia w kolejce poleceń ga(). Jeśli wtyczka akceptuje opcje konfiguracyjne, opcje te mogą być przekazane jako ostatni argument polecenia require.

Poniżej znajduje się pełna sygnatura polecenia require:

ga('require', pluginName, );

Na przykład, oto jak wymagałbyś wtyczki Enhanced Ecommerce do użytku z domyślnym trackerem:

ga('require', 'ec');

A oto jak wymagałbyś wtyczki Advertising Features dla trackera o nazwie „myTracker” i przekazałbyś opcję konfiguracji, która zastępuje domyślną wartość nazwy pliku cookie:

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

Wczytanie kodu wtyczki

Polecenie require inicjalizuje metody wtyczki do użycia z kolejką poleceń ga(), ale nie ładuje samego skryptu wtyczki. Jeśli używasz wtyczki innej firmy lub sam piszesz wtyczkę, będziesz musiał ręcznie dodać kod wtyczki do strony.

Zalecaną metodą dodawania kodu wtyczki do strony jest tag <script> z ustawionym atrybutem async, aby upewnić się, że nie blokuje on ładowania innych funkcji w witrynie.

Poniższy kod zarówno wymaga, jak i ładuje 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>

Oczekiwanie na załadowanie wtyczek

Ponieważ zarówno biblioteka analytics.js, jak i wtyczki analytics.js są ładowane asynchronicznie, może być wyzwaniem wiedzieć, kiedy wtyczki są w pełni załadowane i gotowe do użycia.

Biblioteka analytics.js rozwiązuje ten problem poprzez zatrzymanie wykonywania kolejki poleceń, gdy napotka polecenie require dla wtyczki, która nie jest jeszcze załadowana. Po załadowaniu wtyczki, wykonywanie kolejki jest kontynuowane w normalny sposób.

W rezultacie, niezwykle ważne jest, abyś przetestował wtyczki, których używasz, aby upewnić się, że ładują się i działają poprawnie. Jeśli wtyczka nie załaduje się lub ma błąd, uniemożliwi to wykonanie wszystkich kolejnych poleceń analytics.js.

Wywołanie metod wtyczki

Po zażądaniu wtyczki, jej metody stają się dostępne do użycia w kolejce poleceń ga(). Oto podpis polecenia do wywoływania metod wtyczki:

ga('methodName', ...args);

Na przykład, metoda wtyczki Enhanced Ecommerce addProduct może być wywołana w ten sposób:

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

Albo na nazwanym trackerze poprzez dodanie nazwy trackera do łańcucha poleceń:

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

Jeśli przeczytałeś wszystkie poradniki w tej sekcji, powinieneś znać większość funkcji analytics.js. Następny przewodnik wyjaśnia, jak debugować implementacje analytics.js, aby łatwiej wykryć błędy i zobaczyć, co dokładnie robi Twój kod.