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
_createAsyncTracker(accountId, opt_name)
wycofane_getAsyncTracker(opt_name)
wycofanepush(commandArray)
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_name
Nazwa, 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ę
_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ć.