Глобальный объект _gaq
можно использовать непосредственно для асинхронного отслеживания страниц с помощью метода push(...)
. В нем также есть методы для создания объектов трекера, но их следует использовать только в редких случаях.
Для традиционного отслеживания страниц используйте вместо этого глобальный объект _gat
.
Методы объекта _gaq
-
_createAsyncTracker (accountId, opt_name)
устарел. -
_getAsyncTracker (opt_name)
устарел. -
push (commandArray)
Подробности метода
_createAsyncTracker()
_createAsyncTracker(accountId, opt_name)
_gat._createTracker (opt_account, opt_name)
. - Создает объект отслеживания, к которому можно обращаться по имени при выполнении асинхронных вызовов отслеживания. Если имя не указано, это будет пустая строка
''
которая представляет трекер по умолчанию в асинхронном синтаксисе . Если асинхронный трекер для данного имени уже существует, он будет перезаписан новым трекером.Примечание. Этот метод обычно безопасно использовать только внутри функции, которая была помещена в
_gaq
. Его следует использовать только в редких случаях._gaq._createAsyncTracker('UA-65432-1');
параметры
String accountId
Полный идентификатор веб-ресурса (например, UA-65432-1) для объекта отслеживания.String opt_name
Имя, под которым будет сохранен объект трекера. Используйте это имя для ссылки на объект отслеживания в асинхронных вызовах отслеживания позже. возвращает
Tracker
Созданный объект отслеживания._getAsyncTracker()
_getAsyncTracker(opt_name)
_gat._getTrackerByName (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. Пока 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]);"
Пока над ссылкой существует фрагмент асинхронной аналитики, клики будут регистрироваться без ошибок; даже если Аналитика не загрузилась полностью на момент клика. Это одно из многих преимуществ асинхронного отслеживания.
Наконец, вместо того, чтобы вводить _gaq.push(...)
для каждого массива команд, вы можете отправить все свои команды одновременно. Следующий код демонстрирует этот метод. Дополнительные сведения см. в Руководстве по использованию асинхронного фрагмента.
_gaq.push( ['_setAccount', 'UA-XXXXX-X'], ['_setDomainName', 'example.com'], ['_setCustomVar', 1, 'Section', 'Life & Style', 3], ['_trackPageview'] );
параметры
Array commandArray
Команда, которую необходимо выполнить. Один или несколько из них могут быть отправлены в одном вызове.возвращает
Number
Количество команд, которые не удалось выполнить.,
Глобальный объект _gaq
можно использовать непосредственно для асинхронного отслеживания страниц с помощью метода push(...)
. В нем также есть методы для создания объектов трекера, но их следует использовать только в редких случаях.
Для традиционного отслеживания страниц используйте вместо этого глобальный объект _gat
.
Методы объекта _gaq
-
_createAsyncTracker (accountId, opt_name)
устарел. -
_getAsyncTracker (opt_name)
устарел. -
push (commandArray)
Подробности метода
_createAsyncTracker()
_createAsyncTracker(accountId, opt_name)
_gat._createTracker (opt_account, opt_name)
. - Создает объект отслеживания, к которому можно обращаться по имени при выполнении асинхронных вызовов отслеживания. Если имя не указано, это будет пустая строка
''
которая представляет трекер по умолчанию в асинхронном синтаксисе . Если асинхронный трекер для данного имени уже существует, он будет перезаписан новым трекером.Примечание. Этот метод обычно безопасно использовать только внутри функции, которая была помещена в
_gaq
. Его следует использовать только в редких случаях._gaq._createAsyncTracker('UA-65432-1');
параметры
String accountId
Полный идентификатор веб-ресурса (например, UA-65432-1) для объекта отслеживания.String opt_name
Имя, под которым будет сохранен объект трекера. Используйте это имя для ссылки на объект отслеживания в асинхронных вызовах отслеживания позже. возвращает
Tracker
Созданный объект отслеживания._getAsyncTracker()
_getAsyncTracker(opt_name)
_gat._getTrackerByName (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. Пока 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]);"
Пока над ссылкой существует фрагмент асинхронной аналитики, клики будут регистрироваться без ошибок; даже если Аналитика не загрузилась полностью на момент клика. Это одно из многих преимуществ асинхронного отслеживания.
Наконец, вместо того, чтобы вводить _gaq.push(...)
для каждого массива команд, вы можете отправить все свои команды одновременно. Следующий код демонстрирует этот метод. Дополнительные сведения см. в Руководстве по использованию асинхронного фрагмента.
_gaq.push( ['_setAccount', 'UA-XXXXX-X'], ['_setDomainName', 'example.com'], ['_setCustomVar', 1, 'Section', 'Life & Style', 3], ['_trackPageview'] );
параметры
Array commandArray
Команда, которую необходимо выполнить. Один или несколько из них могут быть отправлены в одном вызове.возвращает
Number
Количество команд, которые не удалось выполнить.