Файлы cookie

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

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

Имя поля Тип значения Значения по умолчанию
cookie_domain Строка auto
cookie_expires Целое число Для Аналитики: 63072000 (два года в секундах). Для конверсий: 7776000 (90 дней в секундах).
cookie_prefix Строка Для конверсий: _gcl. Примечание. В файлах cookie Аналитики префикс по умолчанию не используется.
cookie_update Логическое значение true

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

gtag('config', '<TARGET_ID>', {
  'cookie_prefix': 'MyCookie',
  'cookie_domain': 'blog.example.com',
  'cookie_expires': 28 * 24 * 60 * 60  // 28 days, in seconds
});

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

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

gtag('config', '<TARGET_ID>', {
  'cookie_domain': 'blog.example.com'
});

Чтобы избежать конфликтов с другими файлами cookie, вам может потребоваться изменить префикс файла cookie. Например, следующий код будет добавлять в имя файла cookie префикс example (example_ga, example_aw и т. д.):

gtag('config', '<TARGET_ID>', {
  cookie_prefix: 'example'
});

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

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

gtag('config', '<TARGET_ID>', {
  cookie_expires: 0
});

Если для cookie_update задано значение true (значение по умолчанию), gtag.js будет обновлять файлы cookie при каждой загрузке страницы. При этом срок действия файла cookie будет установлен по самому последнему посещению сайта. Таким образом, если срок действия файла cookie равен одной неделе и пользователь заходит на сайт с помощью одного браузера каждые пять дней, срок действия файла cookie будет обновляться при каждом посещении и, следовательно, не истечет никогда.

Если задано значение false, файлы cookie не обновляются при каждой загрузке страницы. Срок действия файла cookie задается относительно первого посещения сайта.

gtag('config', '<TARGET_ID>', {
  cookie_update: false
});