В этом справочнике описаны методы, которые вы используете для настройки работы отчетов 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 на новый указанный путь. Используйте эту функцию для отслеживания поведения пользователей при переходе из одной структуры каталогов в другую в том же домене.
Когда эта функция вызывается, она немедленно копирует все файлы cookie в новый путь к файлам cookie. Таким образом, если метод _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, используя команду ниже.
_gaq.push(['_storeGac', false]);