Kod śledzenia: obiekt globalny _gaq

Obiektu globalnego _gaq można używać bezpośrednio do asynchronicznego śledzenia stron za pomocą metody push(...). Zawiera też metody tworzenia obiektów śledzących, ale powinny być stosowane tylko w rzadkich przypadkach.

W przypadku tradycyjnego śledzenia stron użyj obiektu globalnego _gat.

Metody obiektów _gaq

Szczegóły metody

_createAsyncTracker()

    _createAsyncTracker(accountId, opt_name)
    Tworzy obiekt śledzenia, do którego można się odwoływać podczas wykonywania asynchronicznego wywołań śledzenia. Jeśli nie podasz nazwy, pojawi się pusty ciąg znaków '', który reprezentuje domyślny moduł śledzący w składni asynchronicznej. Jeśli istnieje już asynchroniczny element śledzący o podanej nazwie, zostanie zastąpiony nowym modułem śledzącym.

    Uwaga: tej metody można bezpiecznie używać tylko w ramach funkcji przekazanej do _gaq. Należy go używać tylko w rzadkich przypadkach. 
    _gaq._createAsyncTracker('UA-65432-1');

    Parametry

      String accountId Pełny identyfikator usługi internetowej (np. UA-65432-1) obiektu skryptu śledzenia.
      String opt_nameNazwa, pod którą ma być przechowywany obiekt skryptu śledzenia. Użyj tej nazwy, aby później odwoływać się do obiektu skryptu śledzenia w wywołaniach śledzenia asynchronicznego.

    returns

      Tracker Utworzony obiekt śledzenia.

_getAsyncTracker()

    _getAsyncTracker(opt_name)
    Zwraca obiekt skryptu śledzenia utworzony wcześniej pod podaną nazwą. Jeśli nie podasz nazwy, zostanie użyta domyślna nazwa skryptu śledzenia (pusty ciąg znaków ''). Jeśli nie ma obiektu śledzącego o podanej nazwie, tworzony jest nowy moduł śledzący, do którego jest przypisany i zwracany.

    Uwaga: tej metody można bezpiecznie używać tylko w ramach funkcji przekazanej do _gaq. Należy go używać tylko w rzadkich przypadkach. 
    _gaq._getAsyncTracker();

    Parametry

      String opt_name Nazwa obiektu śledzącego do pobrania.

    returns

      Tracker Pobrany lub utworzony obiekt śledzenia.

push

    push(commandArray)
    Wykonuje podany niżej kod command array, który jest po prostu tablicą JavaScriptu zgodnego z tym formatem. Pierwszym elementem tablicy musi być nazwa metody obiektu śledzącego przekazywanej jako ciąg znaków. Pozostałe elementy tablicy to wartości przekazywane jako argumenty do funkcji.

    Typowe zastosowanie tych danych:
    var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-65432-1']);
_gaq.push(['_trackPageview']);

    Ta funkcja nazywa się push, aby przed całkowitym wczytaniem Analytics użyć tablicy zamiast _gaq. Podczas wczytywania Analytics polecenia są przekazywane do tablicy lub umieszczane w kolejce. Po zakończeniu wczytywania Analytics zastępuje tablicę obiektem _gaq i wykonuje wszystkie polecenia znajdujące się w kolejce. Kolejne wywołania funkcji _gaq.push wywołują tę funkcję, która wykonuje polecenia w miarę ich przekazywania.

    Nazwą modułu do śledzenia można nazwać, dodając na początku nazwę metody (wraz z kropką). Jeśli nazwa funkcji jest oparta na nazwie modułu śledzącego, jest wykonywana w tym module śledzącym.

    W poniższym przykładzie tworzony jest moduł śledzenia o dowolnej nazwie myTracker, a także używany.
    var _gaq = _gaq || [];
_gaq.push(['myTracker._setAccount', 'UA-65432-2']);
_gaq.push(['myTracker._setDomainName', 'foo.com']);
_gaq.push(['myTracker._trackPageview']);

    Uwaga: moduły śledzenia są tworzone przy pierwszym odwoływaniu się do nich przez polecenie. Domyślny moduł do śledzenia jest tworzony za pomocą pierwszego polecenia, które nie zawiera jawnej nazwy modułu do śledzenia. Nazwa domyślnego narzędzia śledzącego to pusty ciąg znaków ''.

    Oprócz przekazywania tablic poleceń możesz też wypychać obiekty funkcji. Jest to szczególnie przydatne w przypadku metod śledzenia, które zwracają wartości. Te funkcje mogą odwoływać się zarówno do elementów _gat, jak i _gaq.
    var _gaq = _gaq || [];
_gaq.push(function() {
  var tracker = _gat._getTracker('UA-65432-1');
  tracker._trackPageview();
});

    Składni push możesz też użyć bezpośrednio w kodzie HTML strony.
    onclick="_gaq.push(['_trackEvent', 'name', value]);"

    Jeśli asynchroniczny fragment kodu Analytics znajduje się nad linkiem, kliknięcia będą rejestrowane bez błędów – nawet wtedy, gdy usługa Analytics nie zostanie w pełni wczytana w momencie kliknięcia. To jedna z wielu zalet śledzenia asynchronicznego.

    I wreszcie, zamiast wpisywać _gaq.push(...) dla każdej tablicy poleceń, możesz przekazać wszystkie polecenia naraz. Poniższy kod ilustruje tę metodę. Więcej informacji znajdziesz w przewodniku na temat korzystania z fragmentów asynchronicznego. 

    _gaq.push(
  ['_setAccount', 'UA-XXXXX-X'],
  ['_setDomainName', 'example.com'],
  ['_setCustomVar', 1, 'Section', 'Life & Style', 3],
  ['_trackPageview']
);

      Parametry

        Array commandArray Polecenie do wykonania. Co najmniej 1 z nich można przekazać w tym samym wywołaniu.

      returns

        Number Liczba poleceń, których nie udało się wykonać.