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

gtag.js использует файлы 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
});

По умолчанию в 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, установленным gtag.js. Например, имя идентификационного файла cookie, используемого Google Analytics, по умолчанию — _ga . Вместо этого этот код приведет к тому, что файл cookie будет называться example_ga :

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'example'
});

При каждой загрузке страницы время истечения срока действия файла 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_update установлено значение true (значение по умолчанию), gtag.js будет обновлять файлы cookie при каждой загрузке страницы. При этом срок действия файлов cookie будет установлен относительно последнего посещения сайта. Например, если срок действия файлов cookie установлен на одну неделю, а пользователь посещает один и тот же браузер каждые пять дней, срок действия файлов cookie будет обновляться при каждом посещении и, следовательно, фактически никогда не истечет.

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

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_update': false
});

Добавляет дополнительные флаги к файлу 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 до тех пор, пока не будет получено согласие пользователя. Подробнее см. в разделе Настройка поведения тегов на основе согласия.