Kod śledzenia: domeny i katalogi

Opisujemy w nim metody używane do dostosowywania działania raportowania Google Analytics w przypadku różnych domen, różnych hostów lub podkatalogów witryny.

GATC – domena/katalog

Szczegóły metody

_cookiePathCopy()

_cookiePathCopy(newPath)

Zmienia ścieżki wszystkich plików cookie GATC na nową ścieżkę. Ta funkcja pozwala śledzić zachowanie użytkowników z jednej struktury katalogów do innej w tej samej domenie.

Po wywołaniu tej funkcji natychmiast kopiuje ona wszystkie pliki cookie do nowej ścieżki pliku cookie. Dlatego jeśli metoda _trackPageview() nie została wywołana, podane zostaną wartości dla wszystkich istniejących plików cookie Analytics. Z tego powodu zalecamy wywoływanie tej metody po _trackPageview() i innych metod konfiguracji, które mogą wpływać na wartości plików cookie lub wartości kampanii, które chcesz przekazać, np. _setCampaignCookieTimeout() lub _setReferrerOverride().

Asynchroniczny fragment kodu (zalecany) 
_gaq.push(['_cookiePathCopy', '/newSubDirectory/']);

Parametry

String   newPath Nowa ścieżka przechowywania plików cookie GATC.

_getLinkerUrl()

_getLinkerUrl(targetUrl, useHash)

Ta metoda działa w połączeniu z metodami _setDomainName() i _setAllowLinker(), aby umożliwić śledzenie użytkowników w wielu domenach szczególnie w przypadku elementów iframe i linków, które otwierają się w nowym oknie. Ta metoda zwraca ciąg znaków wszystkich danych z pliku cookie GATC z linku inicjującego, dołączając go do parametru URL. Następnie można ją przekazać do innej witryny lub elementu iframe.

Asynchroniczny fragment kodu (zalecany) 
  _gaq.push(function() {
    var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
    var linkerUrl = pageTracker._getLinkerUrl('http://www.my-example-iframecontent.com/');
  });

Parametry

String   targetUrl Adres URL witryny docelowej, do której mają być przesyłane wartości plików cookie.

Boolean   useHash Ustaw wartość „true”, aby przekazywać zmienne kodu śledzenia, używając # separatora tagu kotwicy zamiast domyślnego ? separatora ciągu zapytania.

returns

String Adres URL łączący

_link()

_link(targetUrl, useHash)

Ta metoda działa w połączeniu z metodami _setDomainName() i _setAllowLinker(), aby umożliwić śledzenie w wielu domenach. Metoda _link() przekazuje pliki cookie GATC z tej witryny do innej za pomocą parametrów URL (HTTP GET). Zmienia się też wartość document.location i przekierowuje użytkownika na nowy adres URL.

Asynchroniczny fragment kodu (zalecany) 
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

Parametry

String   targetUrl Adres URL witryny docelowej, do której mają być przesyłane wartości plików cookie.

Boolean   useHash Ustaw wartość „true”, aby przekazywać zmienne kodu śledzenia, używając # separatora tagu kotwicy zamiast domyślnego ? separatora ciągu zapytania.

_linkByPost()

_linkByPost(formObject, useHash)

Ta metoda działa w połączeniu z metodami _setDomainName() i _setAllowLinker(), aby umożliwić śledzenie w wielu domenach. Metoda _linkByPost() przekazuje pliki cookie GATC z formularza odsyłającego do innej witryny w ciągu znaków dołączonym do wartości działania formularza (HTTP POST). Tej metody używa się zwykle do śledzenia zachowania użytkowników z jednej witryny do witryny koszyka na zakupy innej firmy, ale można jej też używać do wysyłania danych plików cookie do innych domen w wyskakujących okienkach lub elementach iframe.

Asynchroniczny fragment kodu (zalecany) 
    <form action="http://www.shoppingcartsite.com/myService/formProcessor.php"
    name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>

Dodatkowo link _setAllowLinker() musi być ustawiony na true na docelowej stronie internetowej, aby linki działały.

Parametry

HTMLFormElement   formObject Obiekt adresu wyświetlający żądanie POST.

Boolean   useHash Ustaw wartość „true”, aby przekazywać zmienne kodu śledzenia, używając # separatora tagu kotwicy zamiast domyślnego ? separatora ciągu zapytania.

_setAllowHash()

_setAllowHash(bool)

Ustawia flagę „Hash” domeny. Domyślnie ta wartość jest ustawiona na true. Funkcja szyfrowania domen w Google Analytics tworzy wartość skrótu z Twojej domeny i używa tej liczby do sprawdzania integralności plików cookie użytkowników. Jeśli masz wiele subdomen, np. example1.example.com i example2.example.com, i chcesz śledzić zachowanie użytkowników w obu subdomenach, musisz wyłączyć szyfrowanie domen, aby funkcja sprawdzania integralności plików cookie nie odrzucała pliku cookie użytkownika pochodzącego z jednej domeny do drugiej. Możesz też wyłączyć tę funkcję, aby zoptymalizować skuteczność śledzenia poszczególnych stron.

Parametry

Boolean   true lub false to wartość domyślna: true. Jeśli ma wartość true, szyfrowanie jest włączone. W przeciwnym razie szyfrowanie domeny jest wyłączone.

_setAllowLinker()

_setAllowLinker(bool)

Ustawia flagę tagu łączącego, która jest częścią włączania śledzenia użytkowników w wielu domenach. Domyślnie ta metoda ma wartość false, a łączenie jest wyłączone. Zobacz też metody _link(), _linkByPost() i _setDomainName(), aby włączyć śledzenie w wielu domenach. Użyj metody _setAllowLinker w witrynie docelowej, aby witryna docelowa korzystała z danych z plików cookie w parametrze URL zamiast standardowej logiki sesji.

Asynchroniczny fragment kodu (zalecany) 
_gaq.push(['_setAllowLinker', true]);

Parametry

Boolean  true lub false to wartość domyślna: false. Jeśli ma on wartość true, tag łączący jest włączony. W przeciwnym razie połączenie domen jest wyłączone.

_setCookiePath()

_setCookiePath(newCookiePath)

Ustawia nową ścieżkę pliku cookie do Twojej witryny. Domyślnie Google Analytics ustawia ścieżkę pliku cookie na poziomie głównym (/). W większości przypadków jest to odpowiednia opcja i prawidłowo działa z kodem śledzenia zainstalowanym w witrynie, blogu lub w katalogu firmowym. W niektórych przypadkach, gdy dostęp użytkowników jest ograniczony tylko do podkatalogu domeny, ta metoda może rozwiązać problemy ze śledzeniem, ustawiając podkatalog jako domyślną ścieżkę do śledzenia.

Zwykle używa się go, gdy Twoje dane nie są śledzone, a Ty subskrybujesz usługę bloga i masz dostęp tylko do zdefiniowanego podkatalogu albo korzystasz z sieci korporacyjnej lub uniwersyteckiej i masz dostęp tylko do katalogu głównego.

Asynchroniczny fragment kodu (zalecany) 
_gaq.push(['_setCookiePath', '/myBlogDirectory']);

Parametry

String   newCookiePath Nowa ścieżka pliku cookie do ustawienia.

_setDomainName()

_setDomainName(newDomainName)

Ustawia nazwę domeny dla plików cookie GATC. Ta metoda ma 3 tryby: ("auto" | "none" | [domain]). Domyślna metoda to auto, która próbuje rozpoznać nazwę domeny na podstawie właściwości document.domain w DOM.

Określanie domeny

W przewodniku po śledzeniu w wielu domenach znajdziesz wiele przykładów pokazujących, jak i jak określić domenę przy użyciu tej metody. Poniższy przykład pokazuje, jak ustawić nazwę domeny na example.com:

Asynchroniczny fragment kodu (zalecany) 
_gaq.push(['_setDomainName', 'example.com']);

Izolowanie domen najwyższego poziomu

Jeśli zasada ma wartość none, pliki cookie w określonej domenie nie są dostępne dla żadnych subdomen.

Fragment asynchroniczny (zalecany) 
_gaq.push(['_setDomainName', 'none']);

Parametry

String   newDomainName Nowa nazwa domyślna domeny do ustawienia.

_storeGac(wartość logiczna)

Określa, czy plik GAC ma zostać utworzony. Domyślnie ten plik jest tworzony przez skrypt i nie musisz nic robić. Możesz wyłączyć to ustawienie, korzystając z polecenia poniżej.

Asynchroniczny fragment kodu (zalecany) 
_gaq.push(['_storeGac', false]);