ИнтеграцииСписок группировок

Список группировок

Группировки — это свойства посещений сайта и отслеживаемых событий, которые можно использовать для группировки данных. Например, операционная система или тип устройства, которое использует пользователь, посетивший сайт, или его местоположение. В запросах к 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. Например:

  • en — английский
  • ru — русский
  • it — итальянский
  • es — испанский
  • de — немецкий
  • и т.д.

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

Тип источника трафика:

  • 0 — неизвестный трафик
  • 1 — прямые переходы
  • 2 — реферальный трафик
  • 3 — поисковый трафик
  • 4 — трафик из социальных сетей
  • 5 — внутренние переходы

request_source_domain_alias #

string

Название источника перехода.

 

В параметре указывается не адрес источника, а краткое имя, например: google, facebook, yandex и т.д.

 

Возможные значения можно найти в отчетах по сайту "Источники \ Поиск" и "Источники \ Социальные сети" в панели Finteza.

source_type #

integer

Тип первоисточника трафика:

  • 0 — неизвестный трафик
  • 1 — прямые нерекламные переходы
  • 2 — реферальный нерекламный трафик
  • 3 — нерекламный трафик из поисковых систем
  • 4 — нерекламный трафик из социальных сетей
  • 5 — внутренние нерекламные переходы
  • 99 — рекламные переходы

В отличие от 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&param2=value2 значением referrer_params будет "param1=value1&param2=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&param2=value2 значением referrer_params будет "param1=value1&param2=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-адреса:

  • 1— адрес является выходной нодой TOR
  • 2 — адрес является прокси-сервером
  • 4 — адрес является VPN-сервером
  • 16 — адрес принадлежит дата-центру
  • 32 — адрес замечен в атаке на почтовые системы или является спамером
  • 64 — адрес замечен в атаке на SSH-серверы или переборе паролей
  • 128 — адрес замечен в атаке на веб-сайты
  • 256 — адрес замечен в атаке на приложения
  • 512 — адрес принадлежит ботнету
  • 1024 — бот поисковой системы, социальной сети или мессенджера
  • 2048 — адрес находится в черном списке

Эти флаги присваиваются IP-адресам автоматически на основе внутренних алгоритмов Finteza.

qstatus #

integer

Статус трафика:

  • 0 — чистый трафик от реальных пользователей
  • 1 — подозрительный трафик: прокси, VPN, ноды Tor и т.п.
  • 2 — нежелательный трафик: визиты с IP-адресов спамеров и хакеров, а также заходы с попыткой сфальсифицировать параметры веб-запросов и куки
  • 3 — безобидный служебный трафик, который генерируют боты поисковых систем, социальных сетей и мессенджеров
  • 4 — ошибка сервера при обработке

qreason #

integer

Дополнительные параметры трафика:

  • 0 — чистый трафик от реальных пользователей
  • 1 — использовался некорректный метод запроса
  • 2 — использовалась некорректная подпись запроса
  • 3 — в запросе изменен HTTP-заголовка Referer (spoofing)
  • 4 — изменены параметры cookie
  • 100 — адрес является выходной нодой TOR
  • 101 — адрес является прокси-сервером
  • 102 — адрес является VPN-сервером
  • 103 — адрес принадлежит дата-центру
  • 104 — адрес замечен в атаке на SSH-серверы или переборе паролей
  • 105 — адрес замечен в атаке на почтовые системы или является спамером
  • 106 — адрес принадлежит ботнету
  • 107 — адрес находится в черном списке
  • 108 — бот поисковой системы, социальной сети или мессенджера

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_*. В них указываются метки из ссылок, размещенных на вашем же сайте.