Глобальный объект _gaq
можно использовать напрямую для асинхронного отслеживания страниц с помощью метода push(...)
. У него также есть методы для создания объектов трекера, но их следует использовать только в редких случаях.
Для традиционного отслеживания страниц используйте глобальный объект _gat
.
_gaq Методы объекта
-
_createAsyncTracker (accountId, opt_name)
устарел -
_getAsyncTracker (opt_name)
устарел -
push (commandArray)
Детали метода
_createAsyncTracker()
_createAsyncTracker(accountId, opt_name)
- Создает объект отслеживания, на который можно ссылаться по имени при выполнении асинхронных вызовов отслеживания. Если имя не указано, это будет пустая строка
''
, представляющая трекер по умолчанию в асинхронном синтаксисе . Если для данного имени уже существует асинхронный трекер, он будет перезаписан новым трекером.Примечание. Этот метод, как правило, безопасно использовать только внутри функции, которая была помещена в
_gaq
. Его следует использовать только в редких случаях._gaq._createAsyncTracker('UA-65432-1');
параметры
String accountId
Полный идентификатор веб-ресурса (например, UA-65432-1) для объекта отслеживания.String opt_name
Имя для хранения объекта трекера. Используйте это имя для ссылки на объект отслеживания в асинхронных вызовах отслеживания позже.возвращается
Tracker
Созданный объект слежения. _getAsyncTracker()
_getAsyncTracker(opt_name)
- Возвращает объект трекера, ранее созданный под заданным именем. Если имя не указано, будет использоваться имя трекера по умолчанию (пустая строка
''
). Если объект трекера с заданным именем не существует, создается новый трекер, назначается этому имени и возвращается.Примечание. Этот метод, как правило, безопасно использовать только внутри функции, которая была помещена в
_gaq
. Его следует использовать только в редких случаях._gaq._getAsyncTracker();
параметры
String opt_name
Имя извлекаемого объекта трекера.возвращается
Tracker
Полученный или созданный объект отслеживания.толкать
push(commandArray)
- Выполняет заданный
command array
, который представляет собой просто массив JavaScript, соответствующий следующему формату. Первым элементом массива должно быть имя метода объекта трекера, переданное в виде строки. Остальные элементы массива — это значения, которые должны быть переданы в качестве аргументов функции.Типично следующее использование:
var _gaq = _gaq || []; _gaq.push(['_setAccount', 'UA-65432-1']); _gaq.push(['_trackPageview']);
Эта функция называется
_gaq
можно было использовать массив до полной загрузки Analytics. Пока Google Analytics загружается, команды будут помещаться в массив или ставиться в очередь. Когда Analytics завершает загрузку, он заменяет массив объектом _gaq
и выполняет все команды в очереди. Последующие вызовы _gaq.push
разрешаются этой функцией, которая выполняет команды по мере их отправки.Трекеры могут быть названы путем добавления имени трекера (вместе с точкой) перед именем метода. Если имя функции уточняется именем средства отслеживания, оно выполняется на этом средстве отслеживания.
В следующем примере создается и используется средство отслеживания с произвольным названием myTracker.
var _gaq = _gaq || []; _gaq.push(['myTracker._setAccount', 'UA-65432-2']); _gaq.push(['myTracker._setDomainName', 'foo.com']); _gaq.push(['myTracker._trackPageview']);
Примечание. Трекеры создаются при первом обращении к ним команды. Трекер по умолчанию создается с помощью первой команды, которая явно не называет свой трекер. Имя трекера по умолчанию — пустая строка
''
.В дополнение к отправке массивов команд вы также можете отправлять объекты-функции. Это может быть особенно полезно для методов отслеживания, которые возвращают значения. Эти функции могут ссылаться как
_gat
так и _gaq
.var _gaq = _gaq || []; _gaq.push(function() { var tracker = _gat._getTracker('UA-65432-1'); tracker._trackPageview(); });
Вы также можете использовать синтаксис push непосредственно в HTML-коде своей страницы.
onclick="_gaq.push(['_trackEvent', 'name', value]);"
Пока над ссылкой существует асинхронный фрагмент Google Analytics, клики будут фиксироваться без ошибок; даже если Analytics не полностью загружена во время клика. Это одно из многих преимуществ асинхронного отслеживания.
Наконец, вместо того, чтобы вводить _gaq.push(...)
для каждого массива команд, вы можете отправить все свои команды одновременно. Следующий код демонстрирует эту технику. Дополнительные сведения см. в Руководстве по использованию асинхронного фрагмента.
_gaq.push( ['_setAccount', 'UA-XXXXX-X'], ['_setDomainName', 'example.com'], ['_setCustomVar', 1, 'Section', 'Life & Style', 3], ['_trackPageview'] );
параметры
Array commandArray
Команда для выполнения. Один или несколько из них могут быть отправлены в одном и том же вызове.возвращается
Number
Количество команд, которые не удалось выполнить.