В этом документе перечислены все настраиваемые поля в analytics.js.
Поля, которые задаются только в методе create
Следующие поля задаются только в методе create. Подробнее читайте в разделе Создание объектов трекера в руководстве по расширенной настройке.
Идентификатор отслеживания/идентификатор веб-ресурса
Является обязательным для всех типов обращений.
Идентификатор отслеживания/идентификатор веб-ресурса в формате UA-XXXX-Y. С этим идентификатором связываются все собираемые данные.
| Название поля | Тип значения | Значение по умолчанию |
|---|---|---|
trackingId |
Текст | Нет |
UA-XXXX-YПример использования:
ga('create', 'UA-XXXX-Y');
// Alerts the tracking ID for the default tracker.
ga(function(tracker) {
alert(tracker.get('trackingId'));
});
Имя трекера
Необязательное поле.
Может устанавливаться только в методе create.
Название объекта трекера.
| Название поля | Тип значения | Значение по умолчанию |
|---|---|---|
name |
Текст | t0
|
myTrackerПример использования:
ga('create', 'UA-XXXX-Y', {'name': 'myTracker'});
Идентификатор клиента
Необязательное поле.
Может устанавливаться только в методе create.
Анонимно идентифицирует экземпляр браузера. По умолчанию это значение хранится в файле cookie Google Analytics. Срок действия идентификатора составляет два года.
| Название поля | Тип значения | Значение по умолчанию |
|---|---|---|
clientId |
Текст | Randomly Generated
|
35009a79-1a05-49d7-b876-2b884d0f825bПример использования:
ga('create', 'UA-XXXX-Y', {
'clientId': '35009a79-1a05-49d7-b876-2b884d0f825b'
});
Частота выборки
Необязательное поле.
Может устанавливаться только в методе create.
Указывает, какой процент пользователей должен отслеживаться. Значение по умолчанию – 100 (выборка не производится), однако крупным сайтам, возможно, нужно будет установить более низкий процент, чтобы не превысить ограничения Google Analytics.
| Название поля | Тип значения | Значение по умолчанию |
|---|---|---|
sampleRate |
Число | 100
|
5Пример использования:
ga('create', 'UA-XXXX-Y', {'sampleRate': 5});
Частота выборки данных о скорости загрузки сайта
Необязательное поле.
Может устанавливаться только в методе create.
Определяет, как часто будут отправляться маркеры отслеживания скорости загрузки сайта. По умолчанию автоматически отслеживается 1% пользователей.
| Название поля | Тип значения | Значение по умолчанию |
|---|---|---|
siteSpeedSampleRate |
Число | 1
|
10Пример использования:
ga('create', 'UA-XXXX-Y', {'siteSpeedSampleRate': 10});
Всегда отправлять URL перехода
Необязательное поле.
Может устанавливаться только в методе create.
По умолчанию URL перехода (используемый для определения источников трафика) передается, только если у ссылающегося сайта и текущей страницы не совпадает имя хоста. Эту настройку следует включать только в том случае, если вы хотите учитывать переходы с других страниц текущего хоста.
| Название поля | Тип значения | Значение по умолчанию |
|---|---|---|
alwaysSendReferrer |
Логическое выражение | false
|
trueПример использования:
ga('create', 'UA-XXXX-Y', {'alwaysSendReferrer': true});
Разрешить параметры в якоре
Необязательное поле.
Может устанавливаться только в методе create.
По умолчанию библиотека analytics.js ищет пользовательские параметры кампании (utm_source, utm_medium и т. д.) как в строке запроса, так и в якоре URL текущей страницы. Если задать для этого поля значение false, все пользовательские параметры кампании в якоре будут игнорироваться.
| Название поля | Тип значения | Значение по умолчанию |
|---|---|---|
allowAnchor |
Логическое выражение | true
|
falseПример использования:
ga('create', 'UA-XXXX-Y', {'allowAnchor': false});
Название cookie
Необязательное поле.
Может устанавливаться только в методе create.
Название файла cookie, используемого для хранения данных Google Analytics.
| Название поля | Тип значения | Значение по умолчанию |
|---|---|---|
cookieName |
Текст | _ga
|
gaCookieПример использования:
ga('create', 'UA-XXXX-Y', {'cookieName': 'gaCookie'});
Домен cookie
Необязательное поле.
Может устанавливаться только в методе create.
Домен, используемый для хранения файла cookie Google Analytics. Если для этого поля задано значение none, файл cookie устанавливается без указания домена.
| Название поля | Тип значения | Значение по умолчанию |
|---|---|---|
cookieDomain |
Текст | document.location.hostname (normalized)
|
example.comПример использования:
ga('create', 'UA-XXXX-Y', {'cookieDomain': 'example.com'});
Срок действия cookie
Необязательное поле.
Может устанавливаться только в методе create.
Определяет срок действия файла cookie в секундах.
| Название поля | Тип значения | Значение по умолчанию |
|---|---|---|
cookieExpires |
Целое число | 63072000 (two years)
|
86400Пример использования:
ga('create', 'UA-XXXX-Y', {'cookieExpires': 86400});
Хранение файлов cookie
Необязательное поле.
Может устанавливаться только в методе create.
По умолчанию в библиотеке analytics.js создается файл cookie для хранения информации о кампании. В этом поле можно указать, что файл cookie записывать не нужно.
| Название поля | Тип значения | Значение по умолчанию |
|---|---|---|
storeGac |
Логическое выражение | true
|
falseПример использования:
ga('create', 'UA-XXXX-Y', {'storeGac': false});
Устаревший домен cookie
Необязательное поле.
Может устанавливаться только в методе create.
Это поле позволяет указать, как библиотека analytics.js должна искать файлы cookie, созданные более ранними скриптами отслеживания Google Analytics (например, ga.js или urchin.js).
| Название поля | Тип значения | Значение по умолчанию |
|---|---|---|
legacyCookieDomain |
Текст | Нет |
store.example.comПример использования:
ga('create', 'UA-XXXX-Y', {'legacyCookieDomain': 'store.example.com'});
Импорт устаревшей истории
Необязательное поле.
Может устанавливаться только в методе create.
Указывает, должен ли analytics.js импортировать историю из файлов cookie ga.js.
| Название поля | Тип значения | Значение по умолчанию |
|---|---|---|
legacyHistoryImport |
Логическое выражение | true
|
falseПример использования:
ga('create', 'UA-XXXX-Y', 'auto', {'legacyHistoryImport': false});
Разрешить параметры связи
Необязательное поле.
Может устанавливаться только в методе create.
Если задано значение true, система будет обрабатывать параметры связи, используемые для междоменного отслеживания.
| Название поля | Тип значения | Значение по умолчанию |
|---|---|---|
allowLinker |
Логическое выражение | false
|
trueПример использования:
ga('create', 'UA-XXXX-Y', {allowLinker: true});
Общие
Анонимизация IP
Необязательное поле.
IP-адрес отправителя (при наличии) переводится в анонимную форму.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
anonymizeIp |
aip
|
Логическое выражение | Нет | — | Все |
trueПример использования:
ga('set', 'anonymizeIp', true);
Источник данных
Необязательное поле.
Указывает источник данных для обращения. Обращения от analytics.js будут иметь значение web, обращения от мобильных SDK – значение app.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
dataSource |
ds
|
Текст | Нет | Нет | Все |
crmПример использования:
ga('set', 'dataSource', 'crm');
Время в очереди
Необязательное поле.
Используется для сбора офлайн-обращений (латентных обращений). Значение представляет собой временную дельту (в миллисекундах) между моментом, когда произошло обращение, и его отправкой. Значение должно быть больше или равно 0. Если значение превышает четыре часа, обращение может быть не обработано.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
queueTime |
qt
|
Целое число | Нет | Нет | Все |
560Пример использования:
ga('set', 'queueTime', 560);
Принудительное использование SSL
Необязательное поле.
По умолчанию маркеры отслеживания, отправляемые с HTTPS-страниц, будут передаваться с использованием HTTPS, а отправляемые с HTTP-страниц – с использованием HTTP. Если вы зададите принудительное использование SSL, то маркеры с HTTP-страниц также будут пересылаться с использованием протокола HTTPS.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
forceSSL |
Нет | Логическое выражение | false
|
— | Все |
trueПример использования:
ga('set', 'forceSSL', true);
Транспортировка
Необязательное поле.
Указывает метод отправки обращений. Варианты: beacon, xhr или image. По умолчанию analytics.js определяет лучший метод с учетом размера обращения и возможностей браузера. Если вы укажете beacon, но браузер пользователя не поддерживает метод navigator.sendBeacon, будет использоваться вариант image или xhr (в зависимости от размера обращения).
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
transport |
Нет | Текст | none (automatically determined)
|
Нет | Все |
beaconПример использования:
ga('send', 'event', 'click', 'download-me', {transport: 'beacon'});
Использовать метод beacon
Необязательное поле.
Этот параметр в настоящее время не поддерживается, используйте вариант transport. Если задано значение true, клиент будет отправлять обращения с использованием navigator.sendBeacon. Это позволяет отслеживать события непосредственно перед уходом пользователя с сайта, не замедляя переход. Если браузер не поддерживает navigator.sendBeacon, обращения отправляются в стандартном режиме.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
useBeacon |
Нет | Логическое выражение | false
|
— | Все |
trueПример использования:
ga('send', 'event', 'click', 'download-me', {useBeacon: true});
Параметр связывания
Необязательное поле.
Параметр связывания для междоменного отслеживания.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
linkerParam |
Нет | Текст | Нет | Нет | Все |
_ga=1.231587807.1974034684.1435105198Пример использования:
// Alerts the linker parameter for the default tracker.
ga(function(tracker) {
alert(tracker.get('linkerParam'));
});
Обратный вызов после обращения
Необязательное поле.
Функция, которая будет вызвана после обработки обращения. Обратный вызов выполняется всегда – как после успешной отправки обращения, так и тогда, когда передать обращение оказалось невозможно или не удалось. При вызове этой функции никакие аргументы ей не передаются. Не рекомендуем использовать поле hitcallBack для выполнения кода, критически важного для вашего приложения, поскольку в редких случаях он может не вызываться (например, если сервер не отвечает или не удалось загрузить analytics.js). В этом случае, чтобы гарантировать выполнение кода, можно задать время ожидания.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
hitCallback |
Нет | function | Нет | Нет | Все |
// Alerts the user when a hit is sent.
ga('send', 'pageview', {
'hitCallback': function() {
alert('hit sent');
}
});
// Use a timeout to ensure the execution of critical application code.
ga('send', 'pageview', {'hitCallback': criticalCode});
setTimeout(criticalCode, 2000);
// Only run the critical code once.
var alreadyCalled = false;
function criticalCode() {
if (alreadyCalled) return;
alreadyCalled = true;
// Run critical code here...
}
Пользователь
User ID
Необязательное поле.
Это поле обязательно, если в запросе не задан идентификатор клиента. User ID – известный идентификатор, присваиваемый пользователю владельцем сайта или пользователем библиотеки отслеживания. Он должен быть анонимным, т. е. не связанным с личной информацией, а его значение не должно сохраняться с помощью файлов cookie или каких-либо других средств хранения данных в Google Analytics.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
userId |
uid
|
Текст | Нет | Нет | Все |
as8eknlllПример использования:
// Set the user ID when creating the tracker.
ga('create', 'UA-XXXX-Y', {'userId': 'as8eknlll'});
// Alternatively, you may set the user ID via the `set` method.
ga('set', 'userId', 'as8eknlll');
Сеанс
Контроллер сеансов
Необязательное поле.
Используется для контроля за продолжительностью сеанса. При значении start с этого обращения начинается новый сеанс, а при значении end на этом обращении заканчивается текущий сеанс. Все остальные значения игнорируются.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
sessionControl |
sc
|
Текст | Нет | Нет | Все |
startПример использования:
// Starts a new session.
ga('send', 'pageview', {'sessionControl': 'start'});
Источники трафика
URL перехода к документу
Необязательное поле.
Показывает, с какого URL поступил трафик на сайт. Это значение используется для определения источника трафика. Формат значения – URL. Это поле инициализируется командой create и устанавливается, только если текущее имя хоста отличается от имени хоста URL перехода (за исключением случаев, когда для поля alwaysSendReferrer задано значение true).
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
referrer |
dr
|
Текст | document.referrer
|
2048 байтов | Все |
http://example.comПример использования:
ga('set', 'referrer', 'http://example.com');
Название кампании
Необязательное поле.
Указывает название кампании.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
campaignName |
cn
|
Текст | Нет | 100 байт | Все |
(direct)Пример использования:
ga('set', 'campaignName', '(direct)');
Источник кампании
Необязательное поле.
Указывает источник кампании.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
campaignSource |
cs
|
Текст | Нет | 100 байт | Все |
(direct)Пример использования:
ga('set', 'campaignSource', '(direct)');
Канал кампании
Необязательное поле.
Указывает канал кампании.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
campaignMedium |
cm
|
Текст | Нет | 50 байт | Все |
organicПример использования:
ga('set', 'campaignMedium', 'organic');
Ключевое слово кампании
Необязательное поле.
Определяет ключевое слово кампании.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
campaignKeyword |
ck
|
Текст | Нет | 500 байт | Все |
Blue ShoesПример использования:
ga('set', 'campaignKeyword', 'Blue Shoes');
Содержание кампании
Необязательное поле.
Определяет содержание кампании.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
campaignContent |
cc
|
Текст | Нет | 500 байт | Все |
contentПример использования:
ga('set', 'campaignContent', 'content');
Идентификатор кампании
Необязательное поле.
Определяет идентификатор кампании.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
campaignId |
ci
|
Текст | Нет | 100 байт | Все |
IDПример использования:
ga('set', 'campaignId', 'ID');
Информация о системе
Разрешение экрана
Необязательное поле.
Указывает разрешение экрана. Это поле инициализируется командой create.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
screenResolution |
sr
|
Текст | Нет | 20 байт | Все |
800x600Пример использования:
ga('set', 'screenResolution', '800x600');
Окно просмотра
Необязательное поле.
Определяет размер видимой области браузера/устройства. Это поле инициализируется командой create.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
viewportSize |
vp
|
Текст | Нет | 20 байт | Все |
123x456Пример использования:
ga('set', 'viewportSize', '123x456');
Кодирование документа
Необязательное поле.
Определяет набор символов для кодирования страницы/документа. Это поле инициализируется командой create.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
encoding |
de
|
Текст | UTF-8
|
20 байтов | Все |
UTF-8Пример использования:
ga('set', 'encoding', 'UTF-16');
Цвета экрана
Необязательное поле.
Определяет глубину цветов экрана. Это поле инициализируется командой create.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
screenColors |
sd
|
Текст | Нет | 20 байт | Все |
24-bitsПример использования:
ga('set', 'screenColors', '8-bit');
Язык пользователя
Необязательное поле.
Определяет язык пользователя. Это поле инициализируется командой create.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
language |
ul
|
Текст | Нет | 20 байт | Все |
en-usПример использования:
ga('set', 'language', 'en-us');
Поддержка Java включена?
Необязательное поле.
Указывает, включена ли поддержка Java. Это поле инициализируется командой create.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
javaEnabled |
je
|
Логическое выражение | Нет | — | Все |
trueПример использования:
ga('set', 'javaEnabled', true);
Версия Flash
Необязательное поле.
Указывает версию Flash. Это поле инициализируется командой create.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
flashVersion |
fl
|
Текст | Нет | 20 байт | Все |
10 1 r103Пример использования:
ga('set', 'flashVersion', '10 1 r103');
Обращение
Тип обращения
Является обязательным для всех типов обращений.
Тип обращения. Возможные варианты: pageview (просмотр страницы), screenview (просмотр экрана), event (событие), transaction (транзакция), item (товар), social (социальное взаимодействие), exception (исключение), timing (время).
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
hitType |
t
|
Текст | Нет | Нет | Все |
pageviewПример использования:
ga('send', {
'hitType': 'pageview',
'page': '/home'
});
Не взаимодействие
Необязательное поле.
Указывает, что обращение не должно считаться взаимодействием.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
nonInteraction |
ni
|
Логическое выражение | Нет | — | Все |
trueПример использования:
ga('set', 'nonInteraction', true);
Информация о содержании
URL местоположения документа
Необязательное поле.
Указывает полный URL (за исключением якоря) страницы. Это поле инициализируется командой create.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
location |
dl
|
Текст | Нет | 2048 байт | Все |
http://foo.com/home?a=bПример использования:
ga('set', 'location', 'http://foo.com/home?a=b');
Имя хоста документа
Необязательное поле.
Указывает имя хоста, где хранится контент.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
hostname |
dh
|
Текст | Нет | 100 байт | Все |
foo.comПример использования:
ga('set', 'hostname', 'foo.com');
Путь к документу
Необязательное поле.
Часть URL страницы, определяющая путь. Путь должен начинаться с символа косой черты (/). Для обращений типа pageview необходимо указать либо параметр &dl, либо одновременно параметры &dh и &dp. Используется для указания путей виртуальных страниц.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
page |
dp
|
Текст | Нет | 2048 байт | Все |
/fooПример использования:
ga('set', 'page', '/foo');
Заголовок документа
Необязательное поле.
Заголовок страницы/документа. По умолчанию: document.title.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
title |
dt
|
Текст | Нет | 1500 байт | Все |
SettingsПример использования:
ga('set', 'title', 'Settings');
Название экрана
Обязательно для обращений типа screenview (просмотр экрана).
Это необязательный параметр для веб-ресурсов и обязательный – для мобильных ресурсов. Он используется в качестве названия экрана для обращений типа screenview (просмотр экрана). Для веб-ресурсов по умолчанию используется уникальный URL страницы (параметр &dl как есть либо комбинация параметров &dh и &dp).
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
screenName |
cd
|
Текст | Нет | 2048 байт | screenview (просмотр экрана) |
High ScoresПример использования:
ga('set', 'screenName', 'High Scores');
Группа контента
Необязательное поле.
У вас может быть до пяти групп контента, каждой из которых присваивается номер от 1 до 5. Каждая из них в свою очередь может включать до 100 групп контента. Значением параметра "Группа контента" должен быть текст, обозначающий категорию контента в иерархической структуре. При этом в качестве разделителя используется косая черта "/". Если такие знаки содержатся в начале или конце строки, они будут удалены. Если этот знак указан несколько раз подряд, то его повторы удаляются. Например, строка "/a//b/" преобразуется в "a/b".
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
contentGroup |
cg<groupIndex>
|
Текст | Нет | 100 байт | Все |
news/sportsПример использования:
ga('set', 'contentGroup5', '/news/sports');
Идентификатор ссылки
Необязательное поле.
Идентификатор того элемента DOM, на который нажал пользователь. Этот идентификатор используется для различения ссылок на один URL в отчетах "Статистика страницы" в случаях, когда для ресурса включена улучшенная атрибуция ссылок.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
linkid |
linkid
|
Текст | Нет | Нет | Все |
nav_barПример использования:
ga('set', '&linkid', 'html-element-id');
Отслеживание приложений
Название приложения
Необязательное поле.
Указывает название приложения. Это поле является обязательным для обращений, в которых содержатся данные, связанные с приложением (например, версия приложения, его идентификатор или идентификатор установщика). Для веб-ресурсов необязательно.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
appName |
an
|
Текст | Нет | 100 байт | Все |
My AppПример использования:
ga('set', 'appName', 'My App');
Идентификатор приложения
Необязательное поле.
Идентификатор приложения.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
appId |
aid
|
Текст | Нет | 150 байт | Все |
com.company.appПример использования:
ga('set', 'appId', 'com.company.app');
Версия приложения
Необязательное поле.
Указывает версию приложения.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
appVersion |
av
|
Текст | Нет | 100 байт | Все |
1.2Пример использования:
ga('set', 'appVersion', '1.2');
Идентификатор установщика приложения
Необязательное поле.
Идентификатор установщика приложения.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
appInstallerId |
aiid
|
Текст | Нет | 150 байт | Все |
com.platform.vendingПример использования:
ga('set', 'appInstallerId', 'com.platform.vending');
Отслеживание событий
Категория событий
Обязательно для обращений типа event.
Указывает категорию события. Это поле не должно быть пустым.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
eventCategory |
ec
|
Текст | Нет | 150 байт | event |
CategoryПример использования:
ga('send', 'event', {
'eventCategory': 'Category',
'eventAction': 'Action'
});
Действие по событию
Обязательно для обращений типа event.
Указывает действие события. Это поле не должно быть пустым.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
eventAction |
ea
|
Текст | Нет | 500 байт | event |
ActionПример использования:
ga('send', 'event', {
'eventCategory': 'Category',
'eventAction': 'Action'
});
Ярлык события
Необязательное поле.
Указывает ярлык события.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
eventLabel |
el
|
Текст | Нет | 500 байт | event |
LabelПример использования:
ga('send', 'event', {
'eventCategory': 'Category',
'eventAction': 'Action',
'eventLabel': 'Label'
});
Значение события
Необязательное поле.
Задает значение события. Значения не могут быть отрицательными.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
eventValue |
ev
|
Целое число | Нет | Нет | event |
55Пример использования:
ga('send', 'event', {
'eventCategory': 'Category',
'eventAction': 'Action',
'eventValue': 55
});
Расширенная электронная торговля
Код товара
Необязательное поле.
Код товара. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product) id |
pr<productIndex>id
|
Текст | Нет | 500 байт | Все |
P12345Пример использования:
ga('ec:addProduct', {'id': 'P12345'});
Название товара
Необязательное поле.
Название товара. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product) name |
pr<productIndex>nm
|
Текст | Нет | 500 байт | Все |
Android T-ShirtПример использования:
ga('ec:addProduct', {'name': 'Android T-Shirt'});
Бренд товара
Необязательное поле.
Бренд, связанный с товаром. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product) brand |
pr<productIndex>br
|
Текст | Нет | 500 байт | Все |
GoogleПример использования:
ga('ec:addProduct', {'brand': 'Google'});
Категория товара
Необязательное поле.
Категория, к которой относится товар. Индекс товара задается положительным целым числом от 1 до 200 включительно. Параметр категории товара может быть иерархическим. Вы можете указать до пяти уровней иерархии, используя косую черту (/) в качестве разделителя. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product) category |
pr<productIndex>ca
|
Текст | Нет | 500 байт | Все |
ApparelПример использования:
ga('ec:addProduct', {'category': 'Apparel'});
Вариант товара
Необязательное поле.
Разновидность товара. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product) variant |
pr<productIndex>va
|
Текст | Нет | 500 байт | Все |
BlackПример использования:
ga('ec:addProduct', {'variant': 'Black'});
Цена товара
Необязательное поле.
Цена за единицу товара. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product) price |
pr<productIndex>pr
|
Валюта | Нет | Нет | Все |
29.20Пример использования:
ga('ec:addProduct', {'price': '29.20'});
Количество единиц товара
Необязательное поле.
Количество единиц товара. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product) quantity |
pr<productIndex>qt
|
Целое число | Нет | Нет | Все |
2Пример использования:
ga('ec:addProduct', {'quantity': 2});
Код купона товара
Необязательное поле.
Код купона, связанного с товаром. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product) coupon |
pr<productIndex>cc
|
Текст | Нет | 500 байт | Все |
SUMMER_SALE13Пример использования:
ga('ec:addProduct', {'coupon': 'SUMMER_SALE13'});
Позиция товара
Необязательное поле.
Позиция товара в списке или коллекции. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product) position |
pr<productIndex>ps
|
Целое число | Нет | Нет | Все |
2Пример использования:
ga('ec:addProduct', {'position': 2});
Специальный параметр товара
Необязательное поле.
Специальный параметр на уровне товара, где номер – это положительное целое число в интервале от 1 до 200 включительно. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product) dimension |
pr<productIndex>cd<dimensionIndex>
|
Текст | Нет | 150 байт | Все |
MemberПример использования:
ga('ec:addProduct', {'dimension1': 'Member'});
Специальный показатель товара
Необязательное поле.
Специальный показатель на уровне товара, где номер – это положительное целое число в интервале от 1 до 200 включительно. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product) metric |
pr<productIndex>cm<metricIndex>
|
Целое число | Нет | Нет | Все |
28Пример использования:
ga('ec:addProduct', {'metric1': 28});
Действие с товаром
Необязательное поле.
Роль товаров, входящих в обращение. Если действие не указано, то все товарные определения в обращении будут проигнорированы. Возможные значения: detail (просмотр информации), click (клик), add (добавление в корзину), remove (удаление из корзины), checkout (оформление покупки), checkout_option (вариант оформления покупки), purchase (покупка), refund (возврат). Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product action) |
pa
|
Текст | Нет | Нет | Все |
detailПример использования:
ga('ec:setAction', 'detail');
Идентификатор транзакции
Необязательное поле.
Идентификатор транзакции. Этот необязательный параметр может передаваться, если для действия с товаром задано значение purchase (покупка) или refund (возврат). Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product action) id |
ti
|
Текст | Нет | Нет | Все |
T1234Пример использования:
ga('ec:setAction', 'purchase', {'id': 'T1234'});
Аффилированность
Необязательное поле.
Магазин или филиал, в котором произошла транзакция. Этот необязательный параметр может передаваться, если для действия с товаром задано значение purchase (покупка) или refund (возврат). Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product action) affiliation |
ta
|
Текст | Нет | Нет | Все |
Google StoreПример использования:
ga('ec:setAction', 'purchase', {'affiliation': 'Google Store'});
Доход
Необязательное поле.
Общая сумма транзакции, включая налоги и стоимость доставки. Если значение не задано, оно автоматически рассчитывается с использованием полей "Количество единиц товара" и "Цена товара" для всех товаров в одном обращении. Этот необязательный параметр может передаваться, если для действия с товаром задано значение purchase (покупка) или refund (возврат). Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product action) revenue |
tr
|
Валюта | Нет | Нет | Все |
123.21Пример использования:
ga('ec:setAction', 'purchase', {'revenue': '123.21'});
Налог
Необязательное поле.
Сумма всех налогов, связанных с транзакцией. Этот необязательный параметр может передаваться, если для действия с товаром задано значение purchase (покупка) или refund (возврат). Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product action) tax |
tt
|
Валюта | Нет | Нет | Все |
10.78Пример использования:
ga('ec:setAction', 'purchase', {'tax': '10.78'});
Доставка
Необязательное поле.
Стоимость доставки, связанная с транзакцией. Этот необязательный параметр может передаваться, если для действия с товаром задано значение purchase (покупка) или refund (возврат). Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product action) shipping |
ts
|
Валюта | Нет | Нет | Все |
3.55Пример использования:
ga('ec:setAction', 'purchase', {'shipping': '3.55'});
Код купона
Необязательное поле.
Купон, погашенный при транзакции. Этот необязательный параметр может передаваться, если для действия с товаром задано значение purchase (покупка) или refund (возврат). Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product action) coupon |
tcc
|
Текст | Нет | Нет | Все |
SUMMER08Пример использования:
ga('ec:setAction', 'purchase', {'coupon': 'SUMMER08'});
Список действия с товаром
Необязательное поле.
Список или коллекция, куда входит действие с товаром. Этот необязательный параметр может передаваться, если для действия с товаром задано значение detail (получение информации) или click (клик). Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product action) list |
pal
|
Текст | Нет | Нет | Все |
Search ResultsПример использования:
ga('ec:setAction', 'click', {'list': 'Search Results'});
Этап оформления покупки
Необязательное поле.
Номер шага в последовательности покупки. Этот необязательный параметр может передаваться, если для действия с товаром задано значение checkout (оформление покупки). Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product action) step |
cos
|
Целое число | Нет | Нет | Все |
2Пример использования:
ga('ec:setAction', 'checkout', {'step': 2});
Вариант оформления покупки
Необязательное поле.
Вариант, выбранный на этапе оформления покупки. Этот необязательный параметр может передаваться, если для действия с товаром задано значение checkout (оформление покупки). Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(product action) option |
col
|
Текст | Нет | Нет | Все |
VisaПример использования:
ga('ec:setAction', 'checkout', {'option': 'Visa'});
Название списка показанного товара
Необязательное поле.
Список или коллекция, куда входит этот товар. Индекс списка показов задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(impression) list |
il<listIndex>nm
|
Текст | Нет | Нет | Все |
Search ResultsПример использования:
ga('ec:addImpression', {'list': 'Search Results'});
Код показанного товара
Необязательное поле.
Идентификатор или код товара. Индекс списка показов задается положительным целым числом от 1 до 200 включительно. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(impression) id |
il<listIndex>pi<productIndex>id
|
Текст | Нет | Нет | Все |
P67890Пример использования:
ga('ec:addImpression', {'id': 'P67890'});
Название показанного товара
Необязательное поле.
Название товара. Индекс списка показов задается положительным целым числом от 1 до 200 включительно. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(impression) name |
il<listIndex>pi<productIndex>nm
|
Текст | Нет | Нет | Все |
Android T-ShirtПример использования:
ga('ec:addImpression', {'name': 'Android T-Shirt'});
Бренд показанного товара
Необязательное поле.
Бренд, связанный с товаром. Индекс списка показов задается положительным целым числом от 1 до 200 включительно. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(impression) brand |
il<listIndex>pi<productIndex>br
|
Текст | Нет | Нет | Все |
GoogleПример использования:
ga('ec:addImpression', {'brand': 'Google'});
Категория показанного товара
Необязательное поле.
Категория, к которой относится товар. Индекс списка показов задается положительным целым числом от 1 до 200 включительно. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(impression) category |
il<listIndex>pi<productIndex>ca
|
Текст | Нет | Нет | Все |
ApparelПример использования:
ga('ec:addImpression', {'category': 'Apparel'});
Вариант показанного товара
Необязательное поле.
Разновидность товара. Индекс списка показов задается положительным целым числом от 1 до 200 включительно. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(impression) variant |
il<listIndex>pi<productIndex>va
|
Текст | Нет | Нет | Все |
BlackПример использования:
ga('ec:addImpression', {'variant': 'Black'});
Позиция показанного товара
Необязательное поле.
Позиция товара в списке или коллекции. Индекс списка показов задается положительным целым числом от 1 до 200 включительно. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(impression) position |
il<listIndex>pi<productIndex>ps
|
Целое число | Нет | Нет | Все |
2Пример использования:
ga('ec:addImpression', {'position': 2});
Цена показанного товара
Необязательное поле.
Цена товара. Индекс списка показов задается положительным целым числом от 1 до 200 включительно. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(impression) price |
il<listIndex>pi<productIndex>pr
|
Валюта | Нет | Нет | Все |
29.20Пример использования:
ga('ec:addImpression', {'price': '29.20'});
Специальный параметр показанного товара
Необязательное поле.
Специальный параметр на уровне товара, где номер – это положительное целое число в интервале от 1 до 200 включительно. Индекс списка показов задается положительным целым числом от 1 до 200 включительно. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(impression) dimension |
il<listIndex>pi<productIndex>cd<dimensionIndex>
|
Текст | Нет | Нет | Все |
MemberПример использования:
ga('ec:addImpression', {'dimension1': 'Member'});
Специальный показатель показанного товара
Необязательное поле.
Специальный показатель на уровне товара, где номер – это положительное целое число в интервале от 1 до 200 включительно. Индекс списка показов задается положительным целым числом от 1 до 200 включительно. Индекс товара задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(impression) metric |
il<listIndex>pi<productIndex>cm<metricIndex>
|
Целое число | Нет | Нет | Все |
28Пример использования:
ga('ec:addImpression', {'metric1': '28'});
Идентификатор рекламной акции
Необязательное поле.
Идентификатор рекламной акции. Ее индекс задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(promo) id |
promo<promoIndex>id
|
Текст | Нет | Нет | Все |
SHIPПример использования:
ga('ec:addPromo', {'id': 'SHIP'});
Название рекламной акции
Необязательное поле.
Название рекламной акции. Ее индекс задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(promo) name |
promo<promoIndex>nm
|
Текст | Нет | Нет | Все |
Free ShippingПример использования:
ga('ec:addPromo', {'name': 'Free Shipping'});
Объявление рекламной акции
Необязательное поле.
Объявление, связанное с рекламной акцией. Ее индекс задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(promo) creative |
promo<promoIndex>cr
|
Текст | Нет | Нет | Все |
Shipping BannerПример использования:
ga('ec:addPromo', {'creative': 'Shipping Banner'});
Позиция рекламной акции
Необязательное поле.
Позиция объявления. Ее индекс задается положительным целым числом от 1 до 200 включительно. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(promo) position |
promo<promoIndex>ps
|
Текст | Нет | Нет | Все |
banner_slot_1Пример использования:
ga('ec:addPromo', {'position': 'banner_slot_1'});
Действие с рекламной акцией
Необязательное поле.
Определяет роль рекламных акций, входящих в обращение. Если значение не указано, по умолчанию используется действие view (просмотр). Чтобы отслеживать клики по рекламе, задайте значение promo_click. Прежде чем использовать это поле, необходимо установить плагин расширенной электронной торговли для analytics.js.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
(promo) action |
promoa
|
Текст | Нет | Нет | Все |
clickПример использования:
ga('ec:setAction', 'promo_click'});
Код валюты
Необязательное поле.
Указывает местную валюту для всех значений, связанных с транзакцией. Значение должно быть в кодировке ISO 4217.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
currencyCode |
cu
|
Текст | Нет | 10 байт | Все |
EURПример использования:
ga('set', 'currencyCode', 'EUR');
Социальные взаимодействия
Социальная сеть
Обязательно для обращений типа social.
Указывает социальную сеть, например Facebook или Google+.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
socialNetwork |
sn
|
Текст | Нет | 50 байт | social |
facebookПример использования:
ga('send', 'social', {
'socialNetwork': 'facebook',
'socialAction': 'like',
'socialTarget': 'http://foo.com'
})
Социальное действие
Обязательно для обращений типа social.
Указывает действие, являющееся социальным взаимодействием. Например, если пользователь нажмет кнопку +1, социальным действием будет plus.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
socialAction |
sa
|
Текст | Нет | 50 байт | social |
likeПример использования:
ga('send', 'social', {
'socialNetwork': 'facebook',
'socialAction': 'like',
'socialTarget': 'http://foo.com'
})
Цель социального действия
Обязательно для обращений типа social.
Указывает цель социального взаимодействия. Значением обычно является URL, но может быть любой текст.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
socialTarget |
st
|
Текст | Нет | 2048 байт | social |
http://foo.comПример использования:
ga('send', 'social', {
'socialNetwork': 'facebook',
'socialAction': 'like',
'socialTarget': 'http://foo.com'
})
Время
Категория пользовательского времени
Обязательно для обращений типа timing.
Указывает категорию пользовательского времени.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
timingCategory |
utc
|
Текст | Нет | 150 байт | timing |
categoryПример использования:
ga('send', 'timing', {
'timingCategory': 'category',
'timingVar': 'lookup',
'timingValue': 123
});
Переменная пользовательского времени
Обязательно для обращений типа timing.
Указывает переменную пользовательского времени.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
timingVar |
utv
|
Текст | Нет | 500 байт | timing |
lookupПример использования:
ga('send', 'timing', {
'timingCategory': 'category',
'timingVar': 'lookup',
'timingValue': 123
});
Значение пользовательского времени
Обязательно для обращений типа timing.
Указывает значение пользовательского времени (в миллисекундах).
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
timingValue |
utt
|
Целое число | Нет | Нет | timing |
123Пример использования:
ga('send', 'timing', {
'timingCategory': 'category',
'timingVar': 'lookup',
'timingValue': 123
});
Ярлык пользовательского времени
Необязательное поле.
Указывает ярлык пользовательского времени.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
timingLabel |
utl
|
Текст | Нет | 500 байт | timing |
labelПример использования:
ga('send', 'timing', {
'timingCategory': 'category',
'timingVar': 'lookup',
'timingValue': 123,
'timingLabel': 'label'
});
Исключения
Описание исключения
Необязательное поле.
Описание возникшей ошибки.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
exDescription |
exd
|
Текст | Нет | 150 байт | exception |
DatabaseErrorПример использования:
ga('send', 'exception', {
'exDescription': 'DatabaseError'
});
Неустранимое исключение?
Необязательное поле.
Указывает, была ли ошибка неустранимой.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
exFatal |
exf
|
Логическое выражение | 1
|
— | exception |
trueПример использования:
ga('send', 'exception', {
'exFatal': true
});
Специальные параметры и показатели
Специальный параметр
Необязательное поле.
У каждого специального параметра есть порядковый номер. Максимальное количество специальных параметров – 20 (в Google Analytics 360 Suite – 200). Индекс параметра задается положительным целым числом от 1 до 200 включительно.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
dimension |
cd<dimensionIndex>
|
Текст | Нет | 150 байт | Все |
SportsПример использования:
ga('set', 'dimension14', 'Sports');
Специальный показатель
Необязательное поле.
У каждого специального показателя есть порядковый номер. Максимальное количество специальных показателей – 20 (в Google Analytics 360 Suite – 200). Индекс показателя задается положительным целым числом от 1 до 200 включительно.
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
metric |
cm<metricIndex>
|
Число | Нет | Нет | Все |
47Пример использования:
ga('set', 'metric7', 47);
Эксперименты со страницами
Идентификатор эксперимента
Необязательное поле.
Пользователь принял участие в эксперименте с данным идентификатором. Этот параметр должен предоставляться вместе с параметром "Вариант эксперимента".
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
expId |
xid
|
Текст | Нет | 40 байт | Все |
Qp0gahJ3RAO3DJ18b0XoUQПример использования:
ga('set', 'expId', 'Qp0gahJ3RAO3DJ18b0XoUQ');
Экспериментальный вариант
Необязательное поле.
Этот параметр означает, что пользователю был показан определенный вариант в рамках эксперимента. Этот параметр должен предоставляться вместе с параметром "Идентификатор эксперимента".
| Название поля | Параметр протокола | Тип значения | Значение по умолчанию | Макс. длина | Поддерживаемые типы обращений |
|---|---|---|---|---|---|
expVar |
xvar
|
Текст | Нет | Нет | Все |
1Пример использования:
ga('set', 'expVar', '1');