Объекты отслеживания, также называемые счетчиками, собирают данные и отправляют их в Google Аналитику.
При создании нового счетчика необходимо указать два параметра: идентификатор отслеживания (он совпадает с идентификатором ресурса Google Аналитики) и домен файлов cookie, от которого зависит, как они будут храниться. При использовании рекомендуемого значения 'auto'домен cookie настраивается автоматически.
Если файл cookie для указанного домена не существует, в файле создается идентификатор клиента, а пользователь определяется как новый. Если существует файл cookie, содержащий идентификатор клиента, этот идентификатор устанавливается в счетчике, а пользователь определяется как вернувшийся.
При создании счетчика сохраняются также такие сведения о контексте просмотра, как название и URL страницы, разрешение экрана устройства, размер области просмотра и кодировка документа. Затем вся эта информация отправляется в Google Аналитику.
Метод create
Библиотека analytics.js позволяет создавать счетчики разными способами. Чаще всего для этого используется команда create с передачей идентификатора отслеживания и домена файла cookie в качестве второго и третьего параметров:
ga('create', 'UA-XXXXX-Y', 'auto');
Названия счетчиков
При необходимости счетчику можно присвоить название, используя поле name в качестве четвертого аргумента команды create. Например, это необходимо, если счетчиков на одной странице несколько. Подробнее…
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');
Счетчик, созданный без указания названия в поле name, называется счетчиком по умолчанию. Ему присваивается внутреннее название t0.
Указание полей при создании счетчика
При создании счетчика вы можете указать любые из полей analytics.js. Они будут сохранены и станут использоваться во всех отправляемых обращениях.
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker', {
userId: '12345'
});
Как и в случае с другими вызовами функции ga(), объект полей можно использовать для указания всех полей одновременно:
ga('create', {
trackingId: 'UA-XXXXX-Y',
cookieDomain: 'auto',
name: 'myTracker',
userId: '12345'
});
Более подробную информацию вы найдете в документации по методу create.
Использование нескольких счетчиков
Иногда может понадобиться отправлять данные с одной страницы на несколько ресурсов. Например, если за разные разделы сайта отвечают разные люди, целесообразно распределять информацию между ними.
Чтобы отслеживать данные двух ресурсов, необходимо создать два отдельных счетчика. При этом по крайней мере одному из них должно быть присвоено название. В примере ниже две команды используются для создания счетчика по умолчанию и аналогичного элемента под названием clientTracker:
ga('create', 'UA-XXXXX-Y', 'auto');
ga('create', 'UA-XXXXX-Z', 'auto', 'clientTracker');
Выполнение команд для отдельного счетчика
Чтобы выполнять команды analytics.js для отдельных счетчиков, в префиксе команды нужно указать его название с точкой. Если оно не указано, команда выполняется для счетчика по умолчанию.
Чтобы отправить обращения типа pageview для двух указанных выше счетчиков, нужно выполнить две команды:
ga('send', 'pageview');
ga('clientTracker.send', 'pageview');
В следующих руководствах вы более подробно познакомитесь с определенными командами. Полный синтаксис всех команд analytics.js приводится в этой статье.
Дальнейшие действия
Создав счетчик, вы можете получить доступ к данным, которые в нем хранятся. Из следующей статьи вы узнаете, как извлекать и обновлять их.