В этом справочнике описаны методы, которые вы используете для настройки работы отчетов 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"
'_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" '_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]);