Код отслеживания: глобальный объект _gaq

Глобальный объект _gaq можно использовать напрямую для асинхронного отслеживания страниц с помощью метода push(...) . У него также есть методы для создания объектов трекера, но их следует использовать только в редких случаях.

Для традиционного отслеживания страниц используйте глобальный объект _gat .

_gaq Методы объекта

Детали метода

_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']);

    Эта функция называется push, чтобы вместо _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 Количество команд, которые не удалось выполнить.