gtag.js использует файлы cookie для идентификации уникальных пользователей во время сеансов просмотра. На этой странице объясняется, как настроить параметры файлов cookie.
Настройте параметры поля cookie
В следующей таблице показаны значения полей файлов cookie по умолчанию, используемые gtag.js:
Имя поля | Тип значения | Значение по умолчанию |
---|---|---|
cookie_domain | string | auto |
cookie_expires | integer | 63072000 (два года, в секундах) |
cookie_prefix | string | _ga |
cookie_update | boolean | true |
cookie_flags | string |
|
Чтобы изменить любое из этих значений, обновите config
вашего свойства, указав их в списке параметров. Например:
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 days, in seconds
});
Конфигурация домена cookie
По умолчанию в gtag.js включена автоматическая настройка домена файлов cookie. Если этот параметр включен, gtag.js будет устанавливать файлы cookie в домене самого высокого уровня, который может. Например, если адрес вашего веб-сайта — blog.example.com
, gtag.js установит файлы cookie в домене example.com
. Если gtag.js обнаруживает, что вы используете локальный сервер (например, localhost
), он автоматически устанавливает для cookie_domain
значение 'none'
, что приводит к тому, что gtag.js будет устанавливать файлы cookie, используя полный домен из местоположения документа.
Чтобы отключить автоматическую настройку домена файлов cookie, обновите config
вашего ресурса, указав значение параметра cookie_domain
:
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_domain': 'blog.example.com'
});
Префикс файла cookie
Чтобы избежать конфликтов с другими файлами cookie, вам может потребоваться изменить префикс файла cookie, который будет добавляться к файлам cookie, установленным gtag.js. Например, имя идентификационного файла cookie, используемого Google Analytics, по умолчанию — _ga
. Вместо этого этот код приведет к тому, что файл cookie будет называться example_ga
:
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_prefix': 'example'
});
Срок действия файлов cookie
При каждой загрузке страницы время истечения срока действия файла cookie обновляется и включает текущее время плюс значение поля cookie_expires
. Это означает, что если для cookie_expires
установлено значение одной недели, и пользователь посещает сайт с помощью того же браузера в течение пяти дней, файл cookie будет доступен еще на неделю, и в Google Analytics он будет отображаться как один и тот же посетитель. Если тот же пользователь вместо этого посетил сайт после истечения срока действия исходного файла cookie, будет создан новый файл cookie, и его первое и второе посещение будут отображаться как исходящие от разных посетителей в Google Analytics.
Если вы установите для параметра cookie_expires
значение 0
(ноль) секунд, файл cookie преобразуется в файл cookie на основе сеанса , срок действия которого истекает после завершения текущего сеанса браузера.
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_expires': 0
});
Обновление файлов cookie
Если для cookie_update
установлено значение true
(значение по умолчанию), gtag.js будет обновлять файлы cookie при каждой загрузке страницы. При этом срок действия файлов cookie будет установлен относительно последнего посещения сайта. Например, если срок действия файлов cookie установлен на одну неделю, а пользователь посещает один и тот же браузер каждые пять дней, срок действия файлов cookie будет обновляться при каждом посещении и, следовательно, фактически никогда не истечет.
Если установлено значение false
, файлы cookie не обновляются при каждой загрузке страницы. Это приводит к тому, что срок действия файлов cookie будет зависеть от времени первого посещения пользователем сайта.
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_update': false
});
Флаги файлов cookie
Добавляет дополнительные флаги к файлу cookie, если они установлены. Флаги должны быть разделены точкой с запятой.
gtag('set', {
'cookie_flags': 'SameSite=None;Secure'
});
Установить идентификатор пользователя
Идентификатор пользователя — это уникальная, постоянная и не идентифицирующая личность строка идентификатора, представляющая пользователя. Это позволяет анализировать группы сеансов на разных устройствах. Чтобы узнать, почему вам следует использовать User ID, см. Преимущества использования функции User ID .
Чтобы реализовать идентификатор пользователя с помощью gtag.js, обновите config
вашего ресурса, указав идентификатор пользователя:
gtag('config', 'GA_MEASUREMENT_ID', {
'user_id': 'USER_ID'
});
Настройте поведение тега на основе согласия
Вы можете настроить gtag.js так, чтобы он не считывал и не записывал файлы cookie до тех пор, пока не будет получено согласие пользователя. Подробнее см. в разделе Настройка поведения тегов на основе согласия.