Конфигурация

В этом документе перечислены все поля конфигурации для GA4.

allow_google_signals

Чтобы отключить все функции для рекламодателей, задайте для параметра allow_google_signals значение false.

Название поля Тип Значение по умолчанию
allow_google_signals boolean true

Пример

Глобально

gtag('set', 'allow_google_signals', true);

Для одного потока

gtag('config', 'STREAM_ID', {
  'allow_google_signals': true
});

allow_ad_personalization_signals

Задайте значение false, чтобы отключить функции для персонализации рекламы.

Название поля Тип Значение по умолчанию
allow_ad_personalization_signals boolean true

Пример

Глобально

gtag('set', 'allow_ad_personalization_signals', true);

Для одного потока

gtag('config', 'STREAM_ID', {
  'allow_ad_personalization_signals': true
});

client_id

Идентифицирует экземпляр браузера, используя псевдонимизацию. По умолчанию это значение хранится в собственном файле cookie Google Аналитики и действует два года.

Название поля Тип Значение по умолчанию
client_id string Случайно сгенерированное значение для каждого пользователя.

Пример

Глобально

gtag('set', 'client_id', 'aaa.bbb');

Для одного потока

gtag('config', 'STREAM_ID', {
  'client_id': 'aaa.bbb'
});

content_group

Название поля Тип Значение по умолчанию
content_group string

Пример

Глобально

gtag('set', 'content_group', '/news/sports');

Для одного потока

gtag('config', 'STREAM_ID', {
  'content_group': '/news/sports'
});

Домен, используемый для хранения файла cookie Google Аналитики.

Задайте значение 'none', чтобы установить файл cookie без указания домена.

Используйте 'auto' (значение по умолчанию), чтобы задать для файла cookie домен верхнего уровня и один субдомен (eTLD +1). Например, если для параметра cookie_domain задано значение 'auto', для https://example.com будет использоваться домен example.com. При этом для https://subdomain.example.com также будет использоваться домен example.com.

Название поля Тип Значение по умолчанию
cookie_domain string 'auto'

Глобально

gtag('set', 'cookie_domain', 'example.com');

Для одного потока

gtag('config', 'STREAM_ID', {
  'cookie_domain': 'example.com'
});

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

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

Название поля Тип Значение по умолчанию
cookie_expires string 63072000

Глобально

gtag('set', 'cookie_expires', 28 * 24 * 60 * 60 /* 28 days, in seconds */);

Для одного потока

gtag('config', 'STREAM_ID', {
  'cookie_expires': 28 * 24 * 60 * 60 /* 28 days, in seconds */
});

Дополнительные метки, которые добавляются при создании файлов cookie. Метки необходимо перечислить через точку с запятой. Примеры меток вы можете найти здесь.

Название поля Тип Значение по умолчанию
cookie_flags string

Глобально

gtag('set', 'cookie_flags', 'SameSite=None;Secure');

Для одного потока

gtag('config', 'STREAM_ID', {
  'cookie_flags': 'SameSite=None;Secure'
});

Раздел, используемый для хранения файла cookie Google Аналитики.

Название поля Тип Значение по умолчанию
cookie_path string '/'

Глобально

gtag('set', 'cookie_path', '/example_path');

Для одного потока

gtag('config', 'STREAM_ID', {
  'cookie_path': '/example_path'
});

Этот параметр позволяет добавлять префикс к названиям файлов cookie Аналитики.

Название поля Тип Значение по умолчанию
cookie_prefix string

Глобально

gtag('set', 'cookie_prefix', 'prefix');

Для одного потока

gtag('config', 'STREAM_ID', {
  'cookie_prefix': 'prefix'
});

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

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

Название поля Тип Значение по умолчанию
cookie_update boolean true

Глобально

gtag('set', 'cookie_update', true);

Для одного потока

gtag('config', 'STREAM_ID', {
  'cookie_update': true
});

language

Определяет язык пользователя. По умолчанию применяется пользовательское значение navigator.language.

Название поля Тип Значение по умолчанию
language string Значение по умолчанию: navigator.language.

Пример

Глобально

gtag('set', 'language', 'en-us');

Для одного потока

gtag('config', 'STREAM_ID', {
  'language': 'en-us'
});

page_location

Полный URL страницы. По умолчанию применяется пользовательское значение document.location.

Название поля Тип Значение по умолчанию
page_location string Значение по умолчанию: document.location.

Пример

Глобально

gtag('set', 'page_location', 'https://example.com/page1');

Для одного потока

gtag('config', 'STREAM_ID', {
  'page_location': 'https://example.com/page1'
});

page_referrer

Показывает, с какого URL поступил трафик на страницу. Это значение используется для определения источника трафика. Формат значения – URL. По умолчанию применяется пользовательское значение document.referrer.

Название поля Тип Значение по умолчанию
page_referrer string Значение по умолчанию: document.referrer.

Пример

Глобально

gtag('set', 'page_referrer', 'https://example.com');

Для одного потока

gtag('config', 'STREAM_ID', {
  'page_referrer': 'https://example.com'
});

page_title

Заголовок страницы или документа. По умолчанию применяется пользовательское значение document.title.

Название поля Тип Значение по умолчанию
page_title string Значение по умолчанию: document.title.

Пример

Глобально

gtag('set', 'page_title', 'Settings');

Для одного потока

gtag('config', 'STREAM_ID', {
  'page_title': 'Settings'
});

send_page_view

Задайте значение false, чтобы фрагмент по умолчанию не отправлял page_view.

Название поля Тип Значение по умолчанию
send_page_view boolean true

Пример

Глобально

gtag('set', 'send_page_view', false);

Для одного потока

gtag('config', 'STREAM_ID', {
  'send_page_view': false
});

screen_resolution

Определяет разрешение экрана. Значение должно представлять собой два целых положительных числа, разделенных символом x. Например, если разрешение экрана составляет 800 на 600p пикселей, то значение будет выглядеть так: 800x600. Рассчитывается на основании пользовательского значения window.screen.

Название поля Тип Значение по умолчанию
screen_resolution string Значение по умолчанию рассчитывается на основании window.screen.

Пример

Глобально

gtag('set', 'screen_resolution', '800x600');

Для одного потока

gtag('config', 'STREAM_ID', {
  'screen_resolution': '800x600'
});

user_id

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

Название поля Тип Значение по умолчанию
user_id string

Пример

Глобально

gtag('set', 'user_id', 'id');

Для одного потока

gtag('config', 'STREAM_ID', {
  'user_id': 'id'
});

user_properties

Свойства пользователей – это атрибуты, описывающие сегменты пользовательской базы (язык, географическое местоположение и др.). Для каждого проекта можно добавить до 25 свойств пользователей.

Название поля Тип Значение по умолчанию
user_properties object

Пример

Глобально

gtag('set', 'user_properties', {
  'favorite_color': 'blue'
});

Для одного потока

gtag('config', 'STREAM_ID', {
  'user_properties': {
    'favorite_color': 'blue'
  }
});