Analytics

Последнее обновление not available | История страницы | Улучшить эту страницу | Сообщить о проблеме

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

Budget

$204 per month—let's make that $500!

Learn more

Что такое Analytics?¶

Analytics это утилита для MODX Revolution, которая вставляет код отслеживания Google Universal Analytics (analytics.js) и/или Google Analytics (ga.js) на страницы вашего сайта.

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

Требования¶

MODX Revolution 2.1.5 или новее
PHP5 или новее

История¶

Analytics впервые выпущен 5 февраля 2012 года yogoo. Идея extra появилась после поста Mark Hamstra: Hiding code for MODX Manager users.

Загрузка¶

Extra доступен через Package Manager или в репозитории.

Использование¶

Примеры¶

Самый простой вызов (всегда без кэша):

[[!Analytics? &webPropertyID=`UA-XXXXX-Y`]]

Отключить фильтрацию по контексту (кэшировать сниппет):

[[Analytics?
    &excludeContextList=``
    &excludeLoggedInUserContextList=``
    &webPropertyID=`UA-XXXXX-Y`
]]

Расширенный пример:

[[!Analytics?
    &debug=`1`
    &isLocalhost=`1`
    &excludeContextList=`content_editors`
    &excludeLoggedInUserContextList=`mgr`
    &displayfeatures=`0`
    &enhancedLinkAttribution=`0`
    &webPropertyID=`UA-XXXXX-Y`
    &cookieDomain=`domain.tld`
    &forceSSL=`1`
    &anonymizeIP=`1`
    &pagePath=`/home/landingPage`
    &setAccount=`GA-XXXXX-Y`
    &setDomainName=`domain.tld`
    &trackPageview=`/home/landingPage`
]]

Общие свойства¶

Name	Description	Required	Default
debug	Простой режим отладки: debug-сообщения как js-комментарии.	no	0
excludeContextList	Список контекстов через запятую для исключения из отслеживания. Ex: web, web2,...	no
excludeLoggedInUserContextList	Список контекстов через запятую для исключения, когда пользователи в них авторизованы. Ex: mgr, web,...	no	mgr
enhancedLinkAttribution	Enhanced Link Attribution: analytics.js, ga.js	no	1

Свойства Google Universal Analytics (analytics.js)¶

Name	Description	Required	Default
webPropertyID	Параметр trackingId.	yes
displayfeatures	Display Features plugin. Включает Display Advertising Features.	no	1
enhancedLinkAttribution	см. общие свойства выше.	no	1
forceSSL	Поле forceSSL.	no	0
anonymizeIP	Поле anonymizeIp.	no	0
cookieDomain	Поле cookieDomain.	no	auto
isLocalhost	Включите для теста analytics.js с localhost. Подробнее…	no	0
cookiePath	[deprecated] Использование настоятельно не рекомендуется и будет удалено в будущем релизе Analytics.	no
pagePath	Поле Page в send().	no

Свойства Google Analytics (ga.js)¶

Name	Description	Required	Default
setAccount	Параметр _setAccount.	yes
enhancedLinkAttribution	см. общие свойства выше.	no	1
setDomainName	Параметр _setDomainName.	no
setCookiePath	[deprecated] Использование настоятельно не рекомендуется и будет удалено в будущем релизе Analytics.	no
trackPageview	Параметр _trackPageview.	no

Хотите мигрировать код на Universal Analytics? См. Universal Analytics Upgrade Center.

Разные способы задать свойства¶

Свойства можно задать через вызов сниппета, наборы свойств, ресурс или настройки контекста.

Если настройки сайта хранятся в ресурсе, используйте getResourceField для получения значений и передайте их в вызов сниппета.

Свой код отслеживания¶

Создайте чанки ua_tracking и ga_tracking. По желанию используйте плейсхолдеры [[+ua_options]] и [[+ga_options]].

Устранение неполадок¶

Включите режим debug.
Убедитесь, что tracking ID задан через webTrackingID и/или setAccount.
Выйдите из менеджера. По умолчанию трафик авторизованных в менеджере пользователей не отслеживается.

Разработка и сообщения об ошибках¶

Запросы функций и баги: github.