Код отслеживания: домены и каталоги

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

В этом справочнике описаны методы, которые вы используете для настройки работы отчетов Google Analytics в разных доменах, на разных хостах или в подкаталогах веб-сайта.

Методы домена/каталога GATC

Детали метода

_cookiePathCopy()

_cookiePathCopy(newPath)

Изменяет пути всех файлов cookie GATC на новый указанный путь. Используйте эту функцию для отслеживания поведения пользователей при переходе из одной структуры каталогов в другую в том же домене.

Когда эта функция вызывается, она немедленно копирует все куки-файлы в новый путь к куки-файлам. Таким образом, если метод _trackPageview() не был вызван, будут предоставлены значения для всех существующих файлов cookie Analytics. По этой причине мы рекомендуем вызывать этот метод после _trackPageview() , а также других методов конфигурации, которые могут повлиять на значения файлов cookie или значения кампании, которые вы хотите передать, например _setCampaignCookieTimeout() или _setReferrerOverride() .

Асинхронный фрагмент (рекомендуется)
_gaq.push(['_cookiePathCopy', '/newSubDirectory/']);

параметры

String newPath Новый путь для хранения файлов cookie GATC.

_getLinkerUrl()

_getLinkerUrl(targetUrl, useHash)

Этот метод работает в сочетании с _setDomainName() и _setAllowLinker() , чтобы включить междоменное отслеживание пользователей специально для iFrames и ссылок, которые открываются в новом окне. Этот метод возвращает строку всех данных cookie GATC из инициирующей ссылки, добавляя ее к параметру URL. Затем это можно передать на другой сайт или в iFrame.

Асинхронный фрагмент (рекомендуется)
  _gaq.push(function() {
    var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
    var linkerUrl = pageTracker._getLinkerUrl('http://www.my-example-iframecontent.com/');
  });

параметры

String targetUrl URL-адрес целевого сайта для отправки значений cookie.

Boolean useHash Установите значение true для передачи переменных кода отслеживания с использованием разделителя тега привязки # вместо используемого по умолчанию? разделитель строк запроса.

возвращается

String URL-адрес компоновщика.

_link(targetUrl, useHash)

Этот метод работает в сочетании с _setDomainName() и _setAllowLinker() для включения междоменного отслеживания пользователей. Метод _link() передает файлы cookie GATC с этого сайта на другой с помощью параметров URL (HTTP GET). Он также изменяет document.location и перенаправляет пользователя на новый URL-адрес.

Асинхронный фрагмент (рекомендуется)
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

параметры

String targetUrl URL-адрес целевого сайта для отправки значений cookie.

Boolean useHash Установите значение true для передачи переменных кода отслеживания с использованием разделителя тега привязки # вместо используемого по умолчанию? разделитель строк запроса.


_linkByPost()

_linkByPost(formObject, useHash)

Этот метод работает в сочетании с _setDomainName() и _setAllowLinker() для включения междоменного отслеживания пользователей. Метод _linkByPost() передает файлы cookie GATC из направляющей формы на другой сайт в виде строки, добавляемой к значению действия формы (HTTP POST). Этот метод обычно используется при отслеживании поведения пользователя с одного сайта на сторонний сайт корзины покупок, но также может использоваться для отправки данных cookie на другие домены во всплывающих окнах или в iFrames.

Асинхронный фрагмент (рекомендуется)
    <form action="http://www.shoppingcartsite.com/myService/formProcessor.php"
    name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>

Кроме того, _setAllowLinker() должно быть установлено в значение true на целевой веб-странице, чтобы ссылка работала.

параметры

HTMLFormElement formObject Объект формы, инкапсулирующий запрос POST.

Boolean useHash Установите значение true для передачи переменных кода отслеживания с использованием разделителя тега привязки # вместо используемого по умолчанию? разделитель строк запроса.


_setAllowHash()

_setAllowHash(bool)

Устанавливает флаг разрешения хэша домена. По умолчанию для этого значения установлено значение true . Функция хеширования домена в Google Analytics создает хеш-значение из вашего домена и использует это число для проверки целостности файлов cookie для посетителей. Если у вас есть несколько поддоменов, таких как example1.example.com и example2.example.com , и вы хотите отслеживать поведение пользователей в обоих этих поддоменах, отключите хеширование домена, чтобы проверка целостности файлов cookie выполнялась. не отклонять пользовательский файл cookie, поступающий из одного домена в другой. Кроме того, вы можете отключить эту функцию, чтобы оптимизировать производительность отслеживания каждой страницы.

параметры

Boolean true или false Значение по умолчанию — true . Если для этого параметра установлено значение true , хеширование домена включено. В противном случае хэширование домена отключено.

_setAllowLinker()

_setAllowLinker(bool)

Устанавливает флаг функциональности компоновщика как часть включения междоменного отслеживания пользователей. По умолчанию для этого метода установлено значение false , а связывание отключено. См. также _link() , _linkByPost() и _setDomainName() для включения междоменного отслеживания. Используйте метод _setAllowLinker на целевом сайте, чтобы целевой сайт использовал данные cookie в параметре URL вместо стандартной логики сеанса.

Асинхронный фрагмент (рекомендуется)
_gaq.push(['_setAllowLinker', true]); 

параметры

Boolean true или false Значение по умолчанию — false . Если для этого параметра установлено значение true , компоновщик включен. В противном случае привязка домена отключена.

_setCookiePath()

_setCookiePath(newCookiePath)

Устанавливает новый путь для файлов cookie для вашего сайта. По умолчанию Google Analytics устанавливает путь файла cookie на корневой уровень (/). В большинстве случаев это подходящий вариант, который корректно работает с кодом отслеживания, который вы устанавливаете на своем веб-сайте, в блоге или в корпоративном веб-каталоге. Однако в некоторых случаях, когда доступ пользователя ограничен только подкаталогом домена, этот метод может решить проблемы с отслеживанием, установив подкаталог в качестве пути по умолчанию для всего отслеживания.

Как правило, вы должны использовать это, если ваши данные не отслеживаются, и вы подписались на службу блога и имеете доступ только к определенному вами подкаталогу, или если вы находитесь в корпоративной или университетской сети и имеете доступ только к своему домашнему каталогу.

Асинхронный фрагмент (рекомендуется)
_gaq.push(['_setCookiePath', '/myBlogDirectory']); 

параметры

String newCookiePath Новый путь для установки файла cookie.

_setDomainName()

_setDomainName(newDomainName)

Устанавливает доменное имя для файлов cookie GATC . У этого метода есть три режима: ("auto" | "none" | [domain]) . По умолчанию для этого метода установлено значение auto , которое пытается разрешить доменное имя на основе свойства document.domain в модели DOM.

Указание домена

См. Руководство по междоменному отслеживанию , где приведены различные примеры, иллюстрирующие, когда и как указывать домен с помощью этого метода. В следующем примере показано, как установить доменное имя example.com :

Асинхронный фрагмент (рекомендуется)
_gaq.push(['_setDomainName', 'example.com']); 

Изоляция доменов верхнего уровня

Установка для этого метода значения none гарантирует, что файлы cookie в данном домене не будут доступны ни для каких поддоменов.

Асинхронный фрагмент (рекомендуется)
_gaq.push(['_setDomainName', 'none']); 

параметры

String newDomainName Новое имя домена по умолчанию для установки.

_storeGac (логическое значение)

Определяет, следует ли создавать файл cookie GAC или нет. По умолчанию файл cookie GAC записывается сценарием, и вам не нужно ничего делать для записи файла cookie. Вы можете отключить настройку этого файла cookie с помощью приведенной ниже команды.

Асинхронный фрагмент (рекомендуется)
_gaq.push(['_storeGac', false]);