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

В этом документе перечислены все поля конфигурации для 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 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 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 обновляется при каждой отправке обращения на серверы 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. Метки необходимо перечислить через точку с запятой. Примеры меток вы можете найти здесь.

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

Пример

Глобально

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 300

Пример

Глобально

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'
  }
});