В этом справочнике описаны методы, которые вы используете для настройки работы отчетов Google Analytics в разных доменах, на разных хостах или в подкаталогах веб-сайта.
Методы домена/каталога GATC
-
_cookiePathCopy (newPath) -
_getLinkerUrl (targetUrl, useHash) -
_link (targetUrl, useHash) -
_linkByPost (formObject, useHash) -
_setAllowHash (bool)устарел -
_setAllowLinker (bool) -
_setCookiePath (newCookiePath) -
_setDomainName (newDomainName) -
_storeGac (bool)
Детали метода
_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]);