Идентификация пользователей с помощью файлов cookie в gtag.js

Код gtag.js использует файлы cookie для идентификации уникальных пользователей в сеансах просмотра. Из этой статьи вы узнаете, как настроить параметры файла cookie.

В таблице ниже показаны значения полей по умолчанию в файлах cookie библиотеки gtag.js.

Имя поля Значение Значение по умолчанию
cookie_name string _ga
cookie_domain string auto
cookie_expires integer 63072000 (два года в секундах)

Чтобы изменить какое-либо из этих значений, обновите файл config своего ресурса, указав нужные параметры в списке. Пример:

gtag('config', 'GA_TRACKING_ID', {
  'cookie_name': 'gaCookie',
  'cookie_domain': 'blog.example.co.uk',
  'cookie_expires': 2419200  // 28 days, in seconds
});

По умолчанию в gtag.js включена автоматическая конфигурация домена cookie. При этом файлы cookie _ga cookie автоматически записываются в домен самого высокого из всех возможных уровней. Например, если ваш сайт расположен по адресу blog.example.co.uk, gtag.js выберет в качестве домена для файлов cookie example.co.uk. Если же gtag.js определит, что сервер работает локально (например, localhost), для cookie_domain будет автоматически установлено значение 'none'.

Чтобы отключить автоматическую конфигурацию домена cookie, обновите файл config для своего ресурса, указав значение для параметра cookie_domain:

gtag('config', 'GA_TRACKING_ID', {
  'cookie_domain': 'blog.example.co.uk'
});

Срок действия файла cookie обновляется при каждой отправке обращения на серверы Google Analytics: к текущему времени прибавляется значение поля cookie_expires. Таким образом, если пользователь заходит на сайт раз в месяц, а значение cookie_expires установлено по умолчанию (2 года), срок действия файла cookie не истечет никогда.

Если вы зададите для cookie_expires значение 0 (ноль секунд), эта работа cookie будет привязана к длительности сеанса (то есть его действие закончится с завершением текущей сессии браузера).

Как задать идентификатор пользователя (User ID)

User ID – это уникальный постоянный анонимный строковый идентификатор, который присваивается каждому пользователю. С его помощью можно идентифицировать ряд сеансов одного и того же пользователя на разных устройствах. Подробнее о преимуществах User ID

Чтобы настроить функцию User ID с помощью gtag.js, обновите файл config для своего ресурса:

gtag('config', 'GA_TRACKING_ID', {
  'user_id': 'USER_ID'
});