Kod śledzenia: konfiguracja podstawowa

W tym artykule opisujemy metody używane do dostosowywania wszystkich aspektów raportowania Google Analytics.

Podstawowe metody ga.js

Szczegóły metody

_deleteCustomVar()

_deleteCustomVar(index)

Ta metoda usuwa zmienną przypisaną do podanego indeksu, jeśli taka istnieje. Możesz np. ustawić zmienną niestandardową na poziomie użytkownika, a później zdecydować, że nie chcesz już korzystać ze 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ę nadana urządzeniu śledzącym podczas tworzenia.

Fragment asynchroniczny (zalecany)

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

returns

String Nazwa lokalizatora.

_getAccount()

_getAccount()

Zwraca identyfikator Google Analytics tego obiektu skryptu śledzenia. Jeśli śledzisz strony w swojej witrynie na wielu kontach, możesz użyć tej metody, aby określić konto powiązane z konkretnym obiektem śledzenia.

Fragment asynchroniczny (zalecany) 

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

returns

String Identyfikator konta, z którym utworzono instancję obiektu skryptu śledzenia.

_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

String numer wersji GATC.

_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 niezdefiniowaną wartość, jeśli nie można pobrać zmiennej dla określonego indeksu.

_initData(),

_initData()Wycofano. Funkcja initData() działa teraz automatycznie w kodzie śledzenia ga.js.

Inicjuje lub ponownie inicjuje obiekt GATC (kod śledzenia Google Analytics).

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

_setAccount()

_setAccount(accountId)

Używane wyłącznie 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) obiektu śledzącego.

_setCookiePersistence()

_setCookiePersistence(milliseconds)

Ta metoda została wycofana. Zamiast niej użyj pola _setVisitorCookieTimeout(cookieTimeoutMillis).

Określa datę ważności pliku cookie użytkownika Google Analytics w milisekundach. Domyślnie plik cookie użytkownika wygasa po 2 latach. Jeśli chcesz, możesz za pomocą tej metody zmienić datę ważności pliku cookie użytkownika. Aby np. ustawić okres ważności pliku cookie użytkownika na 7 dni, użyj tego kodu:

pageTracker._setCookiePersistence(604800000);

parametry

Number   milliseconds Czas 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. Łącznie w polach name i value obowiązuje limit 128 bajtów.

Fragment asynchroniczny (zalecany) 

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

returns

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

Parametry

Int      index       Wymagane. Boks używany na zmienną niestandardową. Możliwe wartości to 1-5 (włącznie).

String   name        Wymagane. Nazwa zmiennej niestandardowej.

String   value       Wymagane. Wartość zmiennej niestandardowej.

Int      opt_scope   Opcjonalny. Zakres używany przez zmienną niestandardową. 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 wyjątkowo duża i generuje duży ruch, ustawienie częstotliwości próbkowania zapewni nieprzerwane śledzenie raportów. Próbkowanie w Google Analytics odbywa się konsekwentnie w przypadku unikalnych użytkowników, co pozwala zachować integralność w trendach i raportach nawet po włączeniu próbkowania, ponieważ unikalni użytkownicy są uwzględniani w próbce lub z niej wykluczeni, zgodnie z ustawieniami na początku próbkowania.

Tę metodę trzeba określić tylko w tym samym czasie, w którym jest wywoływane funkcja _setAccount(), zazwyczaj raz na stronę lub aplikację (w każdym miejscu, w którym zainicjujesz kod śledzenia). Pamiętaj, że podana wartość częstotliwości próbkowania pozostaje w mocy, dopóki obiekt śledzenia będzie występował.

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 (z dokładnością do dwóch miejsc po przecinku).

_setSessionTimeout()

_setSessionTimeout(newTimeout)

Ta metoda została wycofana. Zamiast niej użyj pola _setSessionCookieTimeout(cookieTimeoutMillis).

Określa limit nowej sesji w sekundach. Domyślnie limit czasu sesji jest ustawiony na 30 minut (1800 sekund). Limit czasu sesji służy do obliczania liczby wizyt (patrz definicja sesji w Analytics). Jeśli chcesz zmienić definicję „sesji” zgodnie ze swoimi potrzebami, możesz wpisać liczbę sekund, aby zdefiniować nową wartość. Będzie to miało wpływ na raporty Wizyty w każdej sekcji, w której oblicza się liczbę wizyt oraz w której są one używane do obliczania innych wartości. Na przykład liczba wizyt ogólnie wzrośnie, jeśli skrócisz limit czasu sesji, i będzie się zmniejszać, jeśli wydłużysz limit czasu sesji.

parametry

String newTimeout Nowy limit czasu sesji ustawiany w sekundach.

_setSessionCookieTimeout()

_setSessionCookieTimeout(cookieTimeoutMillis)

Określa czas oczekiwania nowego pliku cookie sesji (w milisekundach). Domyślny limit czasu sesji jest ustawiony na 30 minut. Limit czasu sesji służy do obliczania liczby wizyt, ponieważ wizyta kończy się po 30 minutach braku aktywności przeglądarki lub w momencie jej zamknięcia. Jeśli chcesz zmienić definicję „sesji” do swoich potrzeb, możesz podać liczbę milisekund, by zdefiniować nową wartość. Będzie to miało wpływ na raporty Wizyty we wszystkich sekcjach, w których obliczane są odwiedziny oraz w których są one używane do obliczania innych wartości. Na przykład liczba wizyt wzrośnie, jeśli skrócisz limit czasu sesji, i zmniejszy się, jeśli wydłużysz limit czasu sesji. Możesz zmienić czas wygaśnięcia 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 limit czasu sesji (w milisekundach) lub 0 – powoduje usunięcie pliku cookie po zamknięciu przeglądarki.

_setSiteSpeedSampleRate()

_setSiteSpeedSampleRate(sampleRate)

Definiuje nowy rozmiar zbioru próbkowego do zbierania danych o szybkości witryny. Domyślnie danych, na których podstawie określa się szybkość witryny, dostarcza próbkowanie aktywności użytkowników witryny z częstotliwością wynoszącą 1%. Jeśli masz stosunkowo niewielką liczbę użytkowników dziennie, np. 100 tys. lub mniej, spróbuj dostosować próbkowanie pod kątem większej częstotliwości. Zwiększy to szczegółowość czasu wczytywania strony i innych danych dotyczących szybkości witryny. (Szczegółowe informacje o raportach Szybkość witryny znajdziesz w artykule Szybkość witryny w Centrum pomocy).

Aby metoda _setSiteSpeedSampleRate() była skuteczna, musi zostać wywołana przed _trackPageview().

Aby zapewnić równomierny rozkład zasobów systemowych tej funkcji, Analytics ogranicza w przypadku pojedynczej usługi liczbę działań służących do zbierania danych o szybkości witryny do co najmniej 1% użytkowników lub 10 tys. działań dziennie.

Uwaga: zdecydowanie zalecamy, aby w przypadku witryn, w których przypadku odnotowano ponad milion trafień dziennie, wybrana próbka była ustawiona na 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 0–100, która określa procent użytkowników Twojej witryny, który będzie mierzony na potrzeby pomiaru szybkości witryny. Na przykład wartość 5 ustawia wartość przykładową kolekcji Szybkość witryny na 5%.

_setVisitorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

Określa datę ważności pliku cookie użytkownika Google Analytics w milisekundach. Domyślnie plik cookie użytkownika wygasa po 2 latach. Jeśli chcesz, możesz za pomocą tej metody zmienić datę ważności pliku cookie użytkownika. Możesz zmienić czas wygaśnięcia 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 ważności pliku cookie nowego użytkownika (w milisekundach) lub 0, aby usunąć plik 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żytkownika za pomocą podanego ciągu. Możesz użyć tej wartości, aby zapewnić dodatkową segmentację użytkowników witryny. Może to być na przykład strona logowania lub formularz, który wywołuje wartości na podstawie wpisywanych przez użytkownika danych (np. ustawień wybranych przez niego lub opcji prywatności). Ta zmienna jest następnie aktualizowana w pliku cookie tego użytkownika. Po zaimplementowaniu danych w witrynie i gromadzenia danych za pomocą tej metody nowo zdefiniowany segment pojawi się w raportach Zdefiniowanych przez użytkowników w sekcji Użytkownicy w raportach Analytics. Możesz także uzyskać dostęp do segmentu Wartość zdefiniowana przez użytkownika w raporcie Szczegóły treści, aby sprawdzić, jaki odsetek użytkowników strony należy do określonego przez Ciebie segmentu.

parametry

String newVal Nowa wartość definiowana przez użytkownika do ustawienia.

_trackPageLoadTime()

_trackPageLoadTime()

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

Włącza dla tej strony raporty Szybkość witryny. Wstaw tę metodę w przypadku każdej strony w witrynie, w której przypadku chcesz raportować szybkość witryny. Więcej informacji o raportach Szybkość witryny w Analytics znajdziesz w artykule Szybkość witryny w naszym Centrum pomocy.

Weryfikowanie zmian

Jeśli dane będą widoczne w raportach, oznacza to, że konfiguracja jest prawidłowa. Jeśli po 24 godzinach nie będą dostępne żadne dane, sprawdź konfigurację, aby upewnić się, że nie ma w niej błędów. Listę częstych błędów kodu śledzenia znajdziesz w sekcji Rozwiązywanie problemów z kodem śledzenia. Ten przewodnik dotyczący rozwiązywania problemów zawiera też podstawowe kroki debugowania oraz więcej informacji o debugowaniu.

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)

Główna logika GATC (kodu śledzenia Google Analytics). Jeśli włączone są funkcje łączące, próbuje on wyodrębniać wartości plików cookie z adresu URL. W przeciwnym razie spróbuje wyodrębnić wartości plików cookie z document.cookie. W razie potrzeby aktualizuje lub tworzy pliki cookie, a potem zapisuje je z powrotem w obiekcie dokumentu. Zbiera wszystkie odpowiednie dane do wysłania do UCFE (Urchin Collector Frontend).

Fragment asynchroniczny (zalecany) 

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

Parametry

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