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

В этом документе перечислены все поля конфигурации для 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
});

campaign_content

Используется для A/B-тестирования и объявлений с таргетингом на контент. campaign_content позволяет различать объявления или ссылки, ведущие на один и тот же URL.

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

Пример

Глобально

gtag('set', 'campaign_content', 'logolink');

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

gtag('config', 'STREAM_ID', {
  'campaign_content': 'logolink'
});

campaign_id

Позволяет узнать, к каким кампаниям относится этот переход. campaign_id помогает идентифицировать кампанию.

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

Пример

Глобально

gtag('set', 'campaign_id', 'abc.123');

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

gtag('config', 'STREAM_ID', {
  'campaign_id': 'abc.123'
});

campaign_medium

Используйте campaign_medium для идентификации канала: электронная рассылка, реклама с оплатой за клик и т. д.

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

Пример

Глобально

gtag('set', 'campaign_medium', 'cpc');

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

gtag('config', 'STREAM_ID', {
  'campaign_medium': 'cpc'
});

campaign_name

Используется для анализа ключевых слов. campaign_name позволяет идентифицировать акции для отдельных товаров и стратегические кампании.

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

Пример

Глобально

gtag('set', 'campaign_name', 'spring_sale');

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

gtag('config', 'STREAM_ID', {
  'campaign_name': 'spring_sale'
});

campaign_source

Используйте campaign_source для идентификации поисковой системы, электронной рассылки или другого источника.

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

Пример

Глобально

gtag('set', 'campaign_source', 'google');

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

gtag('config', 'STREAM_ID', {
  'campaign_source': 'google'
});

campaign_term

Применяется для поисковой рекламы. campaign_term позволяет указать ключевые слова для этого объявления.

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

Пример

Глобально

gtag('set', 'campaign_term', 'running+shoes');

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

gtag('config', 'STREAM_ID', {
  'campaign_term': 'running+shoes'
});

campaign

Объект, содержащий все возможные значения для кампании.

Объект "campaign" нужен только для поддержки устаревших версий. Мы не рекомендуем использовать его в большинстве случаев. Вместо него следует применять отдельные поля с префиксом "campaign":

campaign_id
campaign_source
campaign_medium
campaign_name
campaign_term
campaign_content

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

Пример

Глобально

gtag('set', 'campaign', {
  'id': 'abc.123',
  'source': 'google',
  'medium': 'cpc',
  'name': 'spring_sale',
  'term': 'running+shoes',
  'content': 'logolink'
});

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

gtag('config', 'STREAM_ID', {
  'campaign': {
    'id': 'abc.123',
    'source': 'google',
    'medium': 'cpc',
    'name': 'spring_sale',
    'term': 'running+shoes',
    'content': 'logolink'
  }
});

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_domain

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

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

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

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

Пример

Глобально

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

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

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

cookie_expires

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

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

Название поля	Тип	Значение по умолчанию
`cookie_expires`	`number`	`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_flags

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

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

Пример

Глобально

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

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

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

cookie_path

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

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

Пример

Глобально

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

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

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

cookie_prefix

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

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

Пример

Глобально

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

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

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

cookie_update

Если для параметра 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
});

ignore_referrer

Присвойте этому полю значение true, и Аналитика не будет считать URL перехода источником трафика. Где использовать это поле

Название поля	Тип	Значение по умолчанию
`ignore_referrer`	`boolean`	false

Пример

Глобально

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

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

gtag('config', 'STREAM_ID', {
  'ignore_referrer': 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`.	1000

Пример

Глобально

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`	420

Пример

Глобально

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`	300

Пример

Глобально

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 на 600 пикселей, то значение будет выглядеть так: 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`		256

Пример

Глобально

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

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

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

user_properties

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

Название поля	Тип	Значение по умолчанию	Ограничение на количество символов
`user_properties`	`object`		Название свойства: 24, значение свойства: 36

Пример

Глобально

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

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

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