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

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

Пример

Примечание. Это значение переопределит параметр запроса "utm_content".

Глобально

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

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

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

campaign_id

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

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

Пример

Примечание. Это значение переопределит параметр запроса "utm_id".

Глобально

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

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

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

campaign_medium

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

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

Пример

Примечание. Это значение переопределит параметр запроса "utm_medium".

Глобально

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

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

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

campaign_name

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

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

Пример

Примечание. Это значение переопределит параметр запроса "utm_name".

Глобально

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

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

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

campaign_source

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

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

Пример

Примечание. Это значение переопределит параметр запроса "utm_source".

Глобально

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

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

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

campaign_term

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

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

Пример

Примечание. Это значение переопределит параметр запроса "utm_term".

Глобально

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_".

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

Пример

Примечание. Ваши настройки кампании переопределят любые параметры запроса utm_.

Глобально

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 будет слишком коротким, это увеличит количество пользователей и снизит эффективность отслеживания.

Название поля	Тип	Значение по умолчанию
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'
  }
});