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

Плагины позволяют добавить в библиотеку analytics.js дополнительные функции для отслеживания действий пользователей. Многие плагины реализуют узкоспециализированные функции Google Аналитики, например электронную торговлю и междоменное отслеживание, поэтому они не включены в библиотеку analytics.js по умолчанию.

Из этой статьи вы узнаете, как запрашивать и использовать плагины Google Аналитики.

Как запросить плагин

Команда require принимает в качестве аргумента название плагина и регистрирует его для использования в очереди команд ga(). Если плагин поддерживает настройки конфигурации, их можно передать в качестве последнего аргумента команды require.

Вот полная сигнатура команды require:

ga('[trackerName.]require', pluginName, [pluginOptions]);

В примере ниже показано, как запросить плагин расширенной электронной торговли для счетчика по умолчанию.

ga('require', 'ec');

В следующем примере показано, как запросить плагин функций для рекламодателей для счетчика myTracker и изменить название файла cookie по умолчанию.

ga('myTracker.require', 'displayfeatures', {
  cookieName: 'display_features_cookie'
});

Как загрузить код плагина

Команда require инициализирует методы плагина для использования в очереди команд ga(), но не загружает его скрипт. Если вы используете сторонний плагин или создаете его самостоятельно, необходимо вручную добавить его код на страницу.

При добавлении кода плагина на страницу рекомендуется использовать тег <script> с атрибутом async, чтобы не блокировать загрузку других компонентов сайта.

Код в примере ниже запрашивает и загружает плагин отслеживания ссылок:

<script>
ga('create', 'UA-XXXXX-Y', 'auto');
ga('require', 'linkTracker');
ga('send', 'pageview');
</script>

<!--Note: plugin scripts must be included after the tracking snippet. -->
<script async src="/path/to/link-tracker-plugin.js"></script>

Ожидание загрузки плагинов

Библиотека и плагины analytics.js загружаются асинхронно, поэтому не так просто определить, когда плагины загрузились и готовы к использованию.

Для решения этой проблемы analytics.js приостанавливает выполнение очереди команд при обнаружении команды require для плагина, который ещё не загружен. Как только плагин будет готов к работе, очередь команд продолжит обрабатываться.

Очень важно, чтобы плагины работали корректно. Если при его загрузке или выполнении происходит ошибка, последующие команды не будут выполнены.

Как вызывать методы плагина

После запроса плагина его методы можно использовать в очереди команд ga(). Для этого используется следующая сигнатура:

ga('[trackerName.][pluginName:]methodName', ...args);

Например, вызвать метод addProduct плагина расширенной электронной торговли можно следующим образом:

ga('ec:addProduct', {
  'id': 'P12345',
  'quantity': 1
});

Если у объекта отслеживания есть название, его можно добавить в командную строку:

ga('myTracker.ec:addProduct', {
  'id': 'P12345',
  'quantity': 1
});

Дальнейшие действия

Если вы изучили все руководства в этом разделе, то теперь знакомы с основными функциями analytics.js. Из следующей статьи вы узнаете, как выполнять отладку решений на базе analytics.js, чтобы быстрее находить ошибки и проверять работу кода.