Kod śledzenia: konfiguracja podstawowa

Opisuje on metody używane do dostosowywania wszystkich aspektów raportowania Google Analytics.

Metody podstawowe ga.js

Szczegóły metody

_deleteCustomVar(),

_deleteCustomVar(index)

Ta metoda usuwa zmienną przypisaną do podanego indeksu, jeśli istnieje. Możesz np. ustawić zmienną niestandardową na poziomie użytkownika, a potem zdecydować, że nie chcesz już używać tej zmiennej na poziomie użytkownika.

Fragment asynchroniczny (zalecany)

_gaq.push(['_deleteCustomVar', 1]);

Parametry

Int   index Indeks zmiennej niestandardowej do usunięcia.


_getName()

_getName()

Zwraca nazwę nadaną trackerowi w chwili jego utworzenia.

Fragment asynchroniczny (zalecany)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var trackerName = pageTracker._getName();
});

returns

String Nazwa trackera.


_getAccount()

_getAccount()

Zwraca identyfikator Google Analytics tego obiektu śledzącego. Jeśli śledzisz strony w swojej witrynie na wielu kontach, możesz użyć tej metody, aby sprawdzić, które konto jest powiązane z określonym obiektem śledzenia.

Fragment asynchroniczny (zalecany)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var accountId = pageTracker._getAccount();
});

returns

String Identyfikator konta, za pomocą którego utworzono instancję tego obiektu śledzącego.


_getVersion()

_getVersion()

Zwraca numer wersji GATC.

Fragment asynchroniczny (zalecany)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var version = pageTracker._getVersion();
});

returns

Numer wersji GATC: String.


_getvisitorCustomVar()

_getVisitorCustomVar(index)

Zwraca wartość zmiennej niestandardowej na poziomie użytkownika przypisaną do określonego indeksu.

Fragment asynchroniczny (zalecany)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var visitorCustomVar1Value = pageTracker._getVisitorCustomVar(1);
});

Parametry

Int   index Indeks zmiennej niestandardowej na poziomie użytkownika.

returns

String Wartość zmiennej niestandardowej na poziomie użytkownika. Zwraca nieokreśloną wartość, jeśli nie można pobrać zmiennej dla określonego indeksu.


_initData()

_initData()Wycofana. Parametr initData() jest teraz uruchamiany automatycznie w kodzie śledzenia ga.js.

Inicjuje lub ponownie inicjuje obiekt GATC (Google Analytics Tracker Code).

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview();

_setAccount()

_setAccount(accountId)

Używany tylko w śledzeniu asynchronicznym. Ustawia identyfikator usługi internetowej dla obiektu śledzenia.

_gaq.push(['_setAccount', 'UA-XXXXX-X']);

Parametry

String accountID Pełny identyfikator usługi internetowej (np. UA-65432-1) dla obiektu śledzącego.


_setCookiePersistence()

_setCookiePersistence(milliseconds)

Ta metoda została wycofana. Zamiast niego użyj metody _setVisitorCookieTimeout(cookieTimeoutMillis).

Ustawia w milisekundach ważność pliku cookie użytkownika Google Analytics. Domyślnie plik cookie użytkownika wygasa po 2 latach. Możesz też zmienić datę ważności pliku cookie użytkownika, korzystając z tej metody. Aby np. ustawić okres ważności pliku cookie użytkownika na 7 dni, użyj tego kodu:

pageTracker._setCookiePersistence(604800000); 

parametry

Number   milliseconds Data ważności pliku cookie nowego użytkownika.


_setCustomVar()

_setCustomVar(index, name, value, opt_scope)

Ustawia zmienną niestandardową z podaną nazwą, wartością i zakresem zmiennej. Łączny limit znaków w parametrach name i value wynosi 128 bajtów.

Fragment asynchroniczny (zalecany)

_gaq.push(['_setCustomVar', 1, 'Section', 'Life & Style', 3]);

returns

Boolean Ta metoda zwraca wartość true, jeśli zmienna niestandardowa została ustawiona, a false, jeśli nie została skonfigurowana (np. jeśli długość ciągu znaków nazwy lub wartości przekracza 128 bajtów lub użyjesz nieprawidłowego boksu).

Parametry

Int      index       Wymagane. Boks używany dla zmiennej niestandardowej. Możliwe wartości to 1-5 (włącznie).

String   name        Wymagane. Nazwa zmiennej niestandardowej.

String   value       Wymagane. Wartość zmiennej niestandardowej.

Int      opt_scope   Opcjonalnie. Zakres używany dla zmiennej niestandardowej. Możliwe wartości to 1 na poziomie użytkownika, 2 – na poziomie sesji i 3 na poziomie strony.


_setSampleRate()

_setSampleRate(newRate)

Ustawia nową częstotliwość próbkowania. Jeśli Twoja witryna jest szczególnie duża i ma za sobą duże natężenie ruchu, ustawienie częstotliwości próbkowania zapewni Ci niezakłócone śledzenie raportów. Próbkowanie w Google Analytics odbywa się konsekwentnie, więc obowiązuje spójność trendów i raportowania nawet wtedy, gdy próbkowanie jest włączone, ponieważ próbkowanie jest uwzględnione w próbce lub z niej wykluczone, zgodnie z próbką próbkowania.

Tę metodę musisz określić tylko w tym samym czasie, co wywołuje funkcję _setAccount(), zwykle raz na stronę lub aplikację (w każdym miejscu, w którym inicjujesz kod śledzenia). Pamiętaj, że określona przez Ciebie wartość przykładowej częstotliwości pozostaje aktywna, dopóki obiekt śledzenia nie ulegnie zmianie.

Fragment asynchroniczny (zalecany)

_gaq.push(['_setSampleRate', '2.5']);

Parametry

String newRate Nowa częstotliwość próbkowania do ustawienia. Podaj ciąg liczbowy z zakresu od 0 do 100 (ścisły do 2 miejsc po przecinku).


_setSessionTimeout()

_setSessionTimeout(newTimeout)

Ta metoda została wycofana. Zamiast niego użyj metody _setSessionCookieTimeout(cookieTimeoutMillis).

Ustawia czas oczekiwania nowej sesji w sekundach. Domyślnie limit czasu sesji jest ustawiony na 30 minut (1800 sekund). Limit czasu sesji jest wykorzystywany do obliczania liczby wizyt (patrz sekcja Definicja sesji w Analytics). Jeśli chcesz zmienić definicję &sesji i określonych potrzeb, możesz przekazać liczbę sekund w celu zdefiniowania nowej wartości. Będzie to miało wpływ na raporty o wizytach w każdej sekcji, w której obliczana jest liczba wizyt i w której oblicza się liczbę wizyt. Na przykład liczba wizyt zazwyczaj rośnie, jeśli skrócisz limit czasu sesji, a zwykle zmniejszy się, gdy zwiększysz limit czasu sesji.

parametry

String newTimeout Nowy czas trwania sesji ustawiony na kilka sekund.


_setSessionCookieTimeout()

_setSessionCookieTimeout(cookieTimeoutMillis)

Ustawia w pliku cookie czas oczekiwania na nowe pliki cookie sesji. Domyślnie limit czasu sesji jest ustawiony na 30 minut. Limit czasu sesji jest używany do obliczania liczby wizyt, ponieważ sesja kończy się po 30 minutach bezczynności przeglądarki lub po zamknięciu przeglądarki. Jeśli chcesz zmienić definicję &sesji&konkretnej potrzeby, możesz przekazać tę wartość w milisekundach, aby zdefiniować nową wartość. Będzie to miało wpływ na raporty dotyczące wizyt w każdej sekcji, w której obliczana jest liczba wizyt i w której używane są obliczenia do innych wartości. Na przykład liczba wizyt zwiększy się, jeśli skrócisz limit czasu sesji, a jeśli je zmniejszysz, Możesz zmienić datę ważności na 0, aby wskazać, że plik cookie powinien zostać usunięty po zamknięciu przeglądarki.

Fragment asynchroniczny (zalecany)

_gaq.push(['_setSessionCookieTimeout', 1800000]);


Parametry

Number cookieTimeoutMillis Nowy czas trwania sesji w milisekundach lub 0, aby usunąć plik cookie po zamknięciu przeglądarki.


_setSiteSpeedSampleRate()

_setSiteSpeedSampleRate(sampleRate)

Określa nowy rozmiar zbioru danych do zbierania danych o szybkości witryny. Domyślnie dane, na podstawie których określa się szybkość witryny, pochodzą z próbki obejmującej 1% użytkowników witryny. Jeśli Twoja witryna odwiedza stosunkowo niewielką liczbę użytkowników dziennie, np. nie więcej niż 100 000, możesz zwiększyć częstotliwość próbkowania. Zwiększy to dokładność czasu wczytywania strony i innych wskaźników szybkości witryny. Szczegółowe informacje o raportach Szybkość witryny znajdziesz w artykule Szybkość witryny w Centrum pomocy.

Aby metoda _setSiteSpeedSampleRate() była skuteczna, należy ją wywołać przed metodą _trackPageview().

Analytics ogranicza działania dotyczące zbierania danych o szybkości witryny w ramach jednej usługi do ponad 1% użytkowników lub do 10 tys. działań dziennie, aby zapewnić sprawiedliwy rozkład zasobów systemowych dla tej funkcji.

Uwaga: zdecydowanie zalecamy, aby witryny z ponad 1 milionem działań dziennie miały ustawioną domyślną wartość 1%. Dostosowanie rozmiaru próbki do większej liczby nie spowoduje zwiększenia rozmiaru próbki.

Fragment asynchroniczny (zalecany)

_gaq.push(['_setSiteSpeedSampleRate', 5]);
_gaq.push(['_trackPageview']);

Parametry

Number sampleRate Wartość z zakresu od 0 do 100, aby określić procent użytkowników witryny, którzy będą mierzeni pod kątem szybkości witryny. Na przykład wartość 5 ustawia próbkę kolekcji „Szybkość witryny” na 5%.


_setvisitorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

Ustawia w milisekundach ważność pliku cookie użytkownika Google Analytics. Domyślnie plik cookie użytkownika wygasa po 2 latach. Możesz też zmienić datę ważności pliku cookie użytkownika, korzystając z tej metody. Możesz zmienić datę ważności na 0, aby wskazać, że plik cookie powinien zostać usunięty po zamknięciu przeglądarki.

Fragment asynchroniczny (zalecany)

_gaq.push(['_setVisitorCookieTimeout', 63072000000]);

Parametry

Number cookieTimeoutMillis Czas wygaśnięcia nowego pliku cookie użytkownika w milisekundach lub 0 w celu usunięcia pliku cookie po zamknięciu przeglądarki.


_setVar(),

_setVar(newVal)

Ta metoda została wycofana. Zamiast niej użyj kolumny _setCustomVar().

Ustawia lub definiuje niestandardowy segment użytkowników na podstawie podanego ciągu znaków. Możesz użyć tej wartości, by zapewnić użytkownikom dodatkowe segmentowanie witryny. Może to być na przykład strona logowania lub formularz, który wywołuje wartość na podstawie danych wejściowych użytkownika, takich jak preferencje lub opcja prywatności. Ta zmienna jest następnie aktualizowana w pliku cookie tego użytkownika. Gdy zastosujesz tę metodę implementacji w witrynie, a jej dane będą zbierane za pomocą tej metody, nowo zdefiniowany segment pojawi się w raportach Zdefiniowane przez użytkownika w sekcji Użytkownicy w raportach Analytics. Poza tym segment Wartość definiowana przez użytkownika w raporcie Szczegóły treści pozwala sprawdzić, jaki procent użytkowników strony należy do określonego przez Ciebie segmentu.

parametry

String newVal Wartość nowego użytkownika do ustawienia.


_trackPageLoadTime()

_trackPageLoadTime()

Ta metoda została wycofana, ponieważ raportowanie szybkości witryny jest automatycznie włączone dla wszystkich użytkowników. Aby dostosować częstotliwość próbkowania w raportach Szybkość witryny, użyj zasady _setSiteSpeedSampleRate().

Włącza raporty Szybkość witryny na tej stronie. Wstaw tę metodę w przypadku każdej strony w witrynie, której ma dotyczyć raportowanie szybkości witryny. Więcej informacji o raportach Szybkość witryny w Analytics znajdziesz w artykule Szybkość witryny w Centrum pomocy.

Weryfikowanie zmian

Jeśli w raportach pojawią się dane, oznacza to, że konfiguracja jest prawidłowa. Jeśli po 24 godzinach nie widzisz żadnych danych, sprawdź, czy nie zostały wprowadzone żadne błędy. Listę typowych błędów kodu śledzenia znajdziesz w artykule Rozwiązywanie problemów z kodem śledzenia. Ten przewodnik rozwiązywania problemów zawiera też podstawowe kroki debugowania i więcej informacji na temat debugowania.

Włączenie śledzenia szybkości witryny powoduje wysyłanie dodatkowego żądania do serwerów Google Analytics, niezależnie od żądania GIF śledzenia stron wysyłanego w celu śledzenia liczby odsłon. Aby zminimalizować wpływ na ogólny czas oczekiwania dla witryny, żądanie to jest wysyłane tylko w przypadku wybranej próbki odsłon witryny. Z tego powodu, podczas debugowania tej funkcji przy użyciu programu Firebug i innych narzędzi, żądanie GIF szybkości witryny nie zawsze będzie widoczne. Jest to normalne zjawisko.

Fragment asynchroniczny (zalecany)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview']);
_gaq.push(['_trackPageLoadTime']);

_trackPageview()

_trackPageview(opt_pagePath)

Logika GATC (Google Analytics Analytic Tracker Code). Jeśli funkcje łączących funkcje są włączone, próbuje on pobrać wartości plików cookie z adresu URL. W przeciwnym razie próbuje wyodrębnić wartości plików cookie z tagu document.cookie. W razie potrzeby aktualizuje lub tworzy pliki cookie, a następnie zapisuje je z powrotem w obiekcie dokumentu. Zbiera wszystkie odpowiednie dane do wysłania do UCFE (Urchin Collector).

Fragment asynchroniczny (zalecany)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview', '/home/landingPage']);

Parametry

String opt_pagePath Parametr opcjonalny, który wskazuje ścieżkę do strony, na której mają być śledzone dane. Jeśli korzystasz z tej opcji, użyj ukośnika początkowego (/), aby wskazać ścieżkę do strony.