Список группировок
Группировки — это свойства посещений сайта и отслеживаемых событий, которые можно использовать для группировки данных. Например, операционная система или тип устройства, которое использует пользователь, посетивший сайт, или его местоположение. В запросах к HTTP Report API группировки указываются в параметре group.
Рассмотрим отчет по посетителям сайта в разрезе типов устройств:
Тип устройства |
Посетители |
---|---|
Desktop |
790 |
Mobile |
862 |
Tablet |
236 |
Группировкой здесь является тип устройства — свойство визита, по которому объединены данные. Посетители — это метрика, рассчитанная на основе визитов на сайт.
Все группировки делятся на несколько категорий по типу данных:
Аудитория #
Группировка |
Тип |
Описание |
---|---|---|
country # |
integer |
Страна посетителя в виде двузначного идентификатора по стандарту ISO 3166-1. |
region # |
integer |
Регион посетителя в виде двузначного буквенно-циферного идентификатора.
Например, CA для штата Калифорния в США.
Полный список идентификаторов доступен в файле. При запросе по региону обязательно также указывайте страну (параметр country), поскольку идентификаторы регионов у разных стран могут совпадать. |
city # |
integer |
Город посетителя. Указывается полностью. Например, Dallas, Moscow. |
language # |
integer |
Язык посетителя в виде двузначного идентификатора по стандарту ISO 639-1. Например:
|
user_agent # |
string |
Полное наименование user-agent посетителя.
Например, Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:63.0) Gecko/20100101 Firefox/63.0. |
ua_bot_name # |
string |
Наименование бота.
Эта группировка позволяет объединять данные по трафику от различных автоматизированных агентов, например, поисковых роботов (Googlebot, YandexBot и т.д.). |
ua_bot_version # |
string |
Версия бота. Например, 2.0.
Используя эту группировку с ua_bot_name, вы можете запросить данные по конкретной версии поискового бота. Например, Gogglebot 2.1. |
ua_client # |
integer |
Наименование браузера/приложения из user-agent: Chrome, Safari, Firefox, Edge, IE, Opera, Yandex, Facebook App, Instagram App, Google App, Pinterest App, WeChat App, Other. |
ua_client_class # |
integer |
Тип клиента из user-agent: Browser, Application. |
ua_client_name # |
string |
Наименование клиента из user-agent. Например, Firefox, Goggle App, Opera и т.д.
По сравнению с ua_client, эта группировка является более детализированной. Например, при ua_client=other (в этой категории объединены менее популярные приложения) в ua_client_name может быть указано "QQbrowser".
Возможные значения можно посмотреть в отчете по сайту "Аудитория \ Платформы" в панели Finteza. Они доступны в разделе "Приложение". |
ua_client_version # |
string |
Версия клиента из user-agent. Используя эту группировку с ua_client_name, вы можете запросить данные по конкретной версии клиента. Например, Mozilla/5.0. |
ua_os # |
integer |
Тип операционной системы из user-agent: Windows, Linux, Mac, Android, iOS, Other. |
ua_os_version # |
string |
Версия операционной системы.
Указывается полностью, например, Windows 10, Windows 2003 Server, Mac OS, Linux (Ubuntu) и т.д. |
ua_device # |
integer |
Тип устройства: Desktop, Mobile, Tablet, Other. |
ua_device_model # |
string |
Модель устройства.
Возможные значения можно посмотреть в отчете по сайту "Аудитория \ Устройства" в панели Finteza. Они доступны в разделе "Модель". |
ua_device_brand # |
string |
Имя изготовителя устройства.
Возможные значения можно посмотреть в отчете по сайту "Аудитория \ Устройства" в панели Finteza. Они доступны в разделе "Бренд". |
screen # |
string |
Разрешение экрана посетителя в пикселях в виде {ширина}x{высота}. Например, 1024x768. |
События #
Группировка |
Тип |
Описание |
---|---|---|
tracking_event # |
string |
Название отслеживаемого события. |
Страницы #
Группировка |
Тип |
Описание |
---|---|---|
page_title # |
string |
Заголовок страницы, на которой находится пользователь. |
request_source_type # |
integer |
Тип источника трафика:
|
request_source_domain_alias # |
string |
Название источника перехода.
В параметре указывается не адрес источника, а краткое имя, например: google, facebook, yandex и т.д.
Возможные значения можно найти в отчетах по сайту "Источники \ Поиск" и "Источники \ Социальные сети" в панели Finteza. |
source_type # |
integer |
Тип первоисточника трафика:
В отличие от request_source_type, здесь весь рекламный трафик выделен в отдельную категорию. |
source_domain # |
string |
Адрес первоисточника перехода. |
source_domain_alias # |
string |
Название первоисточника перехода.
В параметре указывается не адрес источника, а краткое имя, например: google, facebook, yandex и т.д.
Возможные значения можно найти в отчетах по сайту "Источники \ Поиск" и "Источники \ Социальные сети" в панели Finteza. |
source_is_freezed # |
integer |
Этот флаг начинает проставляется во все запросы посетителя, как только он совершит конверсионное действие.
Иными словами, им помечаются все запросы от уже сконвертированных посетителей. |
source_is_freezing # |
integer |
Этот флаг проставляется в один запрос — которым пользователь совершает конверсионное действие.
При помощи этого свойства можно отслеживать, сколько конверсий произошло за определенный период времени. |
referrer_protocol # |
string |
Имя протокола из адреса страницы, на которой находится посетитель.
Например, в адресе https://abc-site.com значением referrer_protocol будет "https". |
referrer_domain # |
integer |
Имя домена из адреса страницы, на которой находится посетитель.
Например, в адресе https://abc-site.com значением referrer_domain будет "abc-site.com". |
referrer_path # |
string |
Путь внутри сайта из адреса страницы, на которой находится посетитель (без параметров и якоря).
Например, в адресе https://abc-site.com/page1#section1 значением referrer_path будет "page1". |
referrer_anchor # |
string |
Якорь (хэш) из адреса страницы, на которой находится посетитель.
Например, в адресе https://abc-site.com#section1 значением referrer_anchor будет "section1". |
referrer_params # |
string |
Дополнительные параметры из адреса страницы, на которой находится посетитель.
Например, в адресе https://abc-site.com#section1?param1=value1¶m2=value2 значением referrer_params будет "param1=value1¶m2=value2". |
back_referrer_protocol # |
string |
Имя протокола из адреса страницы, на которой находился посетитель до выполнения отслеживаемого действия (источник перехода) .
Например, в адресе https://abc-site.com значением back_referrer_protocol будет "https". |
back_referrer_domain # |
integer |
Имя домена из адреса страницы, на которой находился посетитель до выполнения отслеживаемого действия (источник перехода).
Например, в адресе https://abc-site.com значением back_referrer_domain будет "abc-site.com". |
back_referrer_path # |
string |
Путь внутри сайта из адреса страницы, на которой находился посетитель до выполнения отслеживаемого действия (источник перехода).
Например, в адресе https://abc-site.com/page1#section1 значением back_referrer_path будет "page1". |
back_referrer_anchor # |
string |
Якорь (хэш) из адреса страницы, на которой находился посетитель до выполнения отслеживаемого действия (источник перехода).
Например, в адресе https://abc-site.com#section1 значением back_referrer_anchor будет "section1". |
back_referrer_params # |
string |
Дополнительные параметры из адреса страницы, на которой находился посетитель до выполнения отслеживаемого действия (источник перехода).
Например, в адресе https://abc-site.com#section1?param1=value1¶m2=value2 значением referrer_params будет "param1=value1¶m2=value2". |
next_referrer # |
string |
Адрес внешней страницы, на которую пользователь перешел с вашего сайта.
Используется для отслеживания переходов по внешним ссылкам, размещенным на вашем сайте.
Информацию о таких переходах можно найти в отчете "Страницы \ Выходы \ Внешние ссылки" в панели Finteza. |
next_referrer_domain # |
string |
Имя домена из значения next_referrer.
Например, в адресе https://abc-site.com значением next_domain будет "abc-site.com". |
Трафик #
Группировка |
Тип |
Описание |
---|---|---|
session # |
integer |
Идентификатор сессии посетителя в виде числового значения. Например, 1551232514995740556.
Каждая сессия имеет собственный уникальный идентификатор.
Все сессии можно найти в отчете "Посетители" в панели Finteza. Нажмите на любое событие, перейдите в раздел "Поток" и наведите курсор на посещение. Идентификатор сессии появится слева от даты. |
ip # |
string |
IP-адрес посетителя.
Возможные значения можно найти в отчете "Посетители" в панели Finteza. |
ip_organization # |
string |
Название поставщика Интернет-услуг посетителя (провайдер).
Возможные значения можно найти в отчете "Посетители" в панели Finteza. |
ip_flags # |
integer |
Флаги IP-адреса:
Эти флаги присваиваются IP-адресам автоматически на основе внутренних алгоритмов Finteza. |
qstatus # |
integer |
Статус трафика:
|
qreason # |
integer |
Дополнительные параметры трафика:
|
UTM и параметры ссылок #
Группировка |
Тип |
Описание |
---|---|---|
utm_source #
source_utm_source #
internal_utm_source # |
string |
Источник трафика из соответствующей UTM-метки ссылки.
Доступны три отдельные группировки: для метки непосредственного перехода, первоисточника, внутреннего перехода.
Как правило, в таких метках указывается веб-сайт или приложение.
Возможные значения меток можно найти в отчете по сайту "Источники \ UTM" в панели Finteza. |
utm_campaign #
source_utm_campaign #
internal_utm_campaign # |
string |
Название рекламной кампании из соответствующей UTM-метки ссылки.
Доступны три отдельные группировки: для метки непосредственного перехода, первоисточника, внутреннего перехода.
Возможные значения меток можно найти в отчете по сайту "Источники \ UTM" в панели Finteza. |
utm_medium #
source_utm_medium #
internal_utm_medium # |
string |
Тип рекламы из соответствующей UTM-метки ссылки.
Например, display — это баннерная реклама, cpc — платная реклама и т.д.
Доступны три отдельные группировки: для метки непосредственного перехода, первоисточника, внутреннего перехода.
Возможные значения меток можно найти в отчете по сайту "Источники \ UTM" в панели Finteza. |
utm_term #
source_utm_term #
internal_utm_term # |
string |
Дополнительное описание.
Доступны три отдельные группировки: для метки непосредственного перехода, первоисточника, внутреннего перехода.
В метках utm_term обычно указывается ключевое слово, описание аудитории или название группы объявлений.
Возможные значения меток можно найти в отчете по сайту "Источники \ UTM" в панели Finteza. |
utm_content #
source_utm_content #
internal_utm_content # |
string |
Описание или идентификатор креатива из соответствующей UTM-метки ссылки.
Доступны три отдельные группировки: для метки непосредственного перехода, первоисточника, внутреннего перехода.
Возможные значения меток можно найти в отчете по сайту "Источники \ UTM" в панели Finteza. |
affiliate_s1 — affiliate_s16 #
source_s1 — source_s16 # |
string |
Дополнительные параметры ссылок, которые присылают некоторые рефералы для расширенной маркировки трафика.
Например, в ссылке помимо стандартных UTM-меток могут быть присланы: www.abc.com?utm_campaign=campaign&s1=customtrack1&s2=customtrack2. По значениям customtrack1 и customtrack2 вы можете сгруппировать запрашиваемые данные.
Доступны два типа группировок: 16 для параметров непосредственного перехода (affiliate_s*) и 16 для первоисточника (source_s*).
Список доступных параметров зависит от каждого реферала. Например, в Google Adwords эти параметры можно настроить самостоятельно. |
Другие #
Группировка |
Тип |
Описание |
---|---|---|
day # |
filetime |
День в формате Windows FILETIME. |
day_unixtime # |
unixtime |
День в количестве секунд с 1970.01.01. Например, day=1549027860. |
search_keyword # |
string |
Поисковый запрос (фраза), по которому пришел посетитель.
Указывается только в запросах, где источником (request_source_type) являются поисковые системы. |
Источник и первоисточник трафика
Finteza разделяет источник и первоисточник трафика:
- Источник — страница или ресурс, на котором пользователь находился непосредственно перед выполнением запроса к вашему сайту (перед отправкой трека в Finteza). Для него предусмотрены группировки request_*, utm_*, и affiliate_s*.
- Первоисточник — страница или ресурс, с которого пользователь изначально попал на ваш сайт. Для него предусмотрены группировки source_*, source_utm* и source_s*.
Например, пользователь пришел на сайт из поисковой системы. При первом заходе источник и первоисточник для него будут совпадать. Далее пользователь переходит в другой раздел сайта и в Finteza отправляется событие с атрибутами: теперь источником для него будет ваш сайт (внутренний переход), а первоисточником — по-прежнему поисковая система.
На примере группировок по типу источника это будет выглядеть следующим образом:
- Первый заход из поисковой системы: request_source_type=3 и source_type=3. В обоих параметрах источником трафика указана поисковая система.
- Последующие переходы внутри сайта: request_source_type=5 и source_type=3. В каждом последующем запросе для посетителя будет указываться новый request_source_type — фактический тип страницы, с которой он перешел. При этом source_type для него не будет изменяться в течение определенного промежутка времени. Так система позволяет отслеживать фактический источник трафика.
Работа с utm_* и source_utm_* происходит аналогично. В первых указываются метки из ссылки, по которой произошел непосредственно переход. Во вторых — метки, с которыми пользователь изначально пришел на сайт.
Также есть отдельные набор группировок для меток внутренних переходов — internal_utm_*. В них указываются метки из ссылок, размещенных на вашем же сайте.