Stat API/ru: Difference between revisions
No edit summary |
No edit summary |
||
| (7 intermediate revisions by 2 users not shown) | |||
| Line 15: | Line 15: | ||
|} | |} | ||
=== | == Как получить список всех доступных метрик и группировок == | ||
Чтобы получить все метрики и группировки, сгруппированные по категориям, воспользуйтесь этим URL: | |||
{| class="wikitable" | |||
! Method !! Path | |||
|- | |||
| OPTIONS || /api/stat/get | |||
|} | |||
'''Если вы хотите лучше понять, что показывают наши метрики, посетите страницу [[Metrics_and_groups|Metrics and groups]].''' | |||
===== | === Запрос === | ||
{| class="wikitable | ''Нет параметров'' | ||
! | |||
=== Ответ === | |||
<div class="mw-collapsible mw-collapsed" style="width:80%; overflow:auto;"> | |||
Пример ответа в JSON | |||
<pre class="mw-collapsible-content"> | |||
{ | |||
"success":true, | |||
"code":200, | |||
"msg":[], | |||
"data":{ | |||
"groups":{ | |||
"time":[ | |||
{ | |||
"id":"time_hour", | |||
"icon":"date", | |||
"filterType":"range" | |||
}, | |||
{ | |||
"id":"time_day", | |||
"icon":"date", | |||
"filterType":"range" | |||
}, | |||
{ | |||
"id":"time_week", | |||
"icon":"date", | |||
"filterType":"range" | |||
}, | |||
{ | |||
"id":"time_month", | |||
"icon":"date", | |||
"filterType":"range" | |||
}, | |||
{ | |||
"id":"time_dateTime", | |||
"icon":"date", | |||
"filterType":"list", | |||
"filterSync":true | |||
} | |||
], | |||
"sub":[ | |||
{ | |||
"id":"sub_integration", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"sub_botType", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"sub_cnvId", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true | |||
}, | |||
{ | |||
"id":"sub_clickId", | |||
"icon":"number", | |||
"filterType":"list", | |||
"filterSync":true | |||
}, | |||
{ | |||
"id":"sub_referer", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"sub_1", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true | |||
}, | |||
{ | |||
"id":"sub_2", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true | |||
}, | |||
{ | |||
"id":"sub_3", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true | |||
}, | |||
{ | |||
"id":"sub_4", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true | |||
}, | |||
{ | |||
"id":"sub_5", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true | |||
}, | |||
{ | |||
"id":"sub_6", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true | |||
}, | |||
{ | |||
"id":"sub_7", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true | |||
} | |||
], | |||
"geo":[ | |||
{ | |||
"id":"geo_language", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true | |||
}, | |||
{ | |||
"id":"geo_timezone", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"geo_country", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"geo_city", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true | |||
}, | |||
{ | |||
"id":"geo_provider", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true | |||
}, | |||
{ | |||
"id":"geo_ip", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true | |||
} | |||
], | |||
"device":[ | |||
{ | |||
"id":"device_browser", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"device_browserEngine", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"device_os", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"device_realOs", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"device_device", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"device_type", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"device_connectionType", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"device_useragent", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":true | |||
} | |||
], | |||
"screen":[ | |||
{ | |||
"id":"screen_width", | |||
"icon":"number", | |||
"filterType":"range", | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"screen_height", | |||
"icon":"number", | |||
"filterType":"range", | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"screen_orientation", | |||
"icon":"text", | |||
"filterType":"list", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"screen_pixelDensity", | |||
"icon":"number", | |||
"filterType":"list", | |||
"filterSync":true, | |||
"tooltip":true | |||
} | |||
] | |||
}, | |||
"metrics":{ | |||
"summary":[ | |||
{ | |||
"id":"summary_totalVisits", | |||
"icon":"number", | |||
"filterType":"range" | |||
}, | |||
{ | |||
"id":"summary_validVisits", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"summary_validVisitsPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"summary_techLosses", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"summary_techLossesPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"summary_uniqUsers", | |||
"icon":"number", | |||
"filterType":"range", | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"summary_uniqUsersPc", | |||
"icon":"number", | |||
"filterType":"range" | |||
}, | |||
{ | |||
"id":"summary_conversions", | |||
"icon":"number", | |||
"filterType":"binary", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"summary_conversionsPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
} | |||
], | |||
"bots":[ | |||
{ | |||
"id":"bots_total", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"bots_totalPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"bots_crawler", | |||
"icon":"number", | |||
"filterType":"binary", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"bots_crawlerPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"bots_spoofing", | |||
"icon":"number", | |||
"filterType":"binary", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"bots_spoofingPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"bots_automated", | |||
"icon":"number", | |||
"filterType":"binary", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"bots_automatedPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"bots_iFrame", | |||
"icon":"number", | |||
"filterType":"binary", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"bots_iFramePc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"bots_badReputationIp", | |||
"icon":"number", | |||
"filterType":"binary", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"bots_badReputationIpPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"bots_blocked", | |||
"icon":"number", | |||
"filterType":"binary", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"bots_blockedPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
} | |||
], | |||
"lowQuality":[ | |||
{ | |||
"id":"lowQuality_total", | |||
"icon":"number", | |||
"filterType":"binary", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"lowQuality_totalPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"lowQuality_proxy", | |||
"icon":"number", | |||
"filterType":"binary", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"lowQuality_proxyPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"lowQuality_spoofing", | |||
"icon":"number", | |||
"filterType":"binary", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"lowQuality_spoofingPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"lowQuality_automated", | |||
"icon":"number", | |||
"filterType":"binary", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"lowQuality_automatedPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"lowQuality_trafficCheats", | |||
"icon":"number", | |||
"filterType":"binary", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"lowQuality_trafficCheatsPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
} | |||
], | |||
"feature":[ | |||
{ | |||
"id":"feature_adBlock", | |||
"icon":"number", | |||
"filterType":"list", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"feature_adBlockPc", | |||
"icon":"number", | |||
"filterType":"range" | |||
}, | |||
{ | |||
"id":"feature_isMobile", | |||
"icon":"number", | |||
"filterType":"binary", | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"feature_isMobilePc", | |||
"icon":"number", | |||
"filterType":"range" | |||
}, | |||
{ | |||
"id":"feature_webView", | |||
"icon":"number", | |||
"filterType":"binary", | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"feature_webViewPc", | |||
"icon":"number", | |||
"filterType":"range" | |||
}, | |||
{ | |||
"id":"feature_iFrame", | |||
"icon":"number", | |||
"filterType":"binary", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"feature_iFramePc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
}, | |||
{ | |||
"id":"feature_pushNotifications", | |||
"icon":"number", | |||
"filterType":"binary", | |||
"filterSync":false, | |||
"tooltip":true | |||
}, | |||
{ | |||
"id":"feature_pushNotificationsPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false | |||
} | |||
], | |||
"beAn":[ | |||
{ | |||
"id":"beAn_pageVisibility", | |||
"icon":"number", | |||
"filterType":"list", | |||
"filterSync":false, | |||
"tooltip":true, | |||
"disabled":false | |||
}, | |||
{ | |||
"id":"beAn_pageVisibilityPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false, | |||
"disabled":false | |||
}, | |||
{ | |||
"id":"beAn_pageActivity", | |||
"icon":"number", | |||
"filterType":"list", | |||
"filterSync":false, | |||
"tooltip":true, | |||
"disabled":false | |||
}, | |||
{ | |||
"id":"beAn_pageActivityPc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false, | |||
"disabled":false | |||
}, | |||
{ | |||
"id":"beAn_pageAcceptance", | |||
"icon":"number", | |||
"filterType":"list", | |||
"filterSync":false, | |||
"tooltip":true, | |||
"disabled":false | |||
}, | |||
{ | |||
"id":"beAn_pageAcceptancePc", | |||
"icon":"number", | |||
"filterType":"range", | |||
"filterSync":false, | |||
"disabled":false | |||
} | |||
] | |||
} | |||
} | |||
} | |||
</pre> | |||
</div> | |||
==== API ==== | |||
{| class="wikitable" | |||
! Ключ !! Тип !! Описание | |||
|- | |- | ||
| success || Boolean | | success || Boolean || Был запрос успешным или нет | ||
|- | |- | ||
|code | | code || Number || Статус ответа | ||
| | |||
| | |||
|- | |- | ||
|msg | |msg || [String] || Сообщение об ошибке | ||
| | |||
| | |||
|- | |- | ||
| colspan="3" |data | | colspan="3" |data | ||
| Line 42: | Line 615: | ||
|{ metricTitle: ['''<item>''', …] } | |{ metricTitle: ['''<item>''', …] } | ||
|См. ниже описание '''<item>''' | |См. ниже описание '''<item>''' | ||
|} | |} | ||
{| class="wikitable mw-collapsible" | {| class="wikitable mw-collapsible" | ||
|+Описание '''<item>''' | |+Описание '''<item>''' | ||
! | !Ключ | ||
! | !Тип | ||
! | !Описание | ||
|- | |- | ||
|id | |id | ||
| Line 58: | Line 628: | ||
+ подчёркивание | + подчёркивание | ||
+ <название метрики или группировки> (groupTitle_id) | + <название метрики или группировки> (groupTitle_id, например: lowQuality_total, feature_adBlock) | ||
|- | |- | ||
|icon | |icon | ||
|<code>date</code><nowiki> | </nowiki><code>text</code><nowiki> | </nowiki><code>number</code> | |<code>date</code><nowiki> | </nowiki><code>text</code><nowiki> | </nowiki><code>number</code> | ||
| | |Тип возвращаемого контента | ||
|- | |- | ||
|filterType | |filterType | ||
|<code>range</code><nowiki> | </nowiki><code>list</code><nowiki> | </nowiki><code> | |<code>range</code><nowiki> | </nowiki><code>list</code><nowiki> | </nowiki><code>binary</code> | ||
|См. ниже описание '''<filters>''' | |||
|- | |- | ||
|filterSync | |filterSync | ||
| Line 78: | Line 644: | ||
|} | |} | ||
=== | == Как получить все возможные значения фильтра == | ||
===== | Чтобы получить значения какого-то фильтра, используйте URL: | ||
{| class="wikitable | {| class="wikitable" | ||
! | ! Method !! Path | ||
! | |- | ||
! | | POST || /api/stat/filter | ||
|} | |||
=== Запрос === | |||
<div class="mw-collapsible" style="width:80%; overflow:auto;"> | |||
Пример запроса в JSON | |||
<pre class="mw-collapsible-content"> | |||
{ | |||
"id":"geo_language", | |||
"searchQuery":"en", | |||
"dateFrom":"2024-04-10", | |||
"dateTo":"2024-04-10" | |||
} | |||
</pre> | |||
</div> | |||
==== API ==== | |||
{| class="wikitable" | |||
!Ключ | |||
!Тип | |||
!Описание | |||
|- | |- | ||
|id | |id | ||
| Line 91: | Line 677: | ||
|searchQuery | |searchQuery | ||
|String | |String | ||
| | |Поисковый запрос | ||
|- | |||
|dateFrom | |||
|String | |||
|Начиная с какой даты мы должны искать? Дата в формате Y-m-d. | |||
|- | |||
|dateTo | |||
|String | |||
|По какую дату мы должны искать? Дата в формате Y-m-d. | |||
|} | |} | ||
===== | === Ответ === | ||
{| class="wikitable | <div class="mw-collapsible mw-collapsed" style="width:80%; overflow:auto;"> | ||
! | Пример ответа в JSON | ||
! | <pre class="mw-collapsible-content"> | ||
! | { | ||
"success":true, | |||
"code":200, | |||
"msg":[], | |||
"data":{ | |||
"items":[ | |||
{ | |||
"id":"bd", | |||
"label":"Bengali" | |||
}, | |||
{ | |||
"id":"bez", | |||
"label":"Bena (Tanzania)" | |||
}, | |||
{ | |||
"id":"bn", | |||
"label":"Bengali" | |||
}, | |||
{ | |||
"id":"ce", | |||
"label":"Chechen" | |||
}, | |||
{ | |||
"id":"ckb", | |||
"label":"Central Kurdish" | |||
}, | |||
{ | |||
"id":"en", | |||
"label":"English" | |||
}, | |||
{ | |||
"id":"fr", | |||
"label":"French" | |||
}, | |||
{ | |||
"id":"hy", | |||
"label":"Armenian" | |||
}, | |||
{ | |||
"id":"kam", | |||
"label":"Kamba (Kenya)" | |||
}, | |||
{ | |||
"id":"kln", | |||
"label":"Kalenjin" | |||
}, | |||
{ | |||
"id":"km", | |||
"label":"Central Khmer" | |||
}, | |||
{ | |||
"id":"luo", | |||
"label":"Luo (Kenya and Tanzania)" | |||
}, | |||
{ | |||
"id":"mfe", | |||
"label":"Morisyen" | |||
}, | |||
{ | |||
"id":"seh", | |||
"label":"Sena" | |||
}, | |||
{ | |||
"id":"ses", | |||
"label":"Koyraboro Senni Songhai" | |||
}, | |||
{ | |||
"id":"sl", | |||
"label":"Slovenian" | |||
}, | |||
{ | |||
"id":"tk", | |||
"label":"Turkmen" | |||
}, | |||
{ | |||
"id":"tzm", | |||
"label":"Central Atlas Tamazight" | |||
}, | |||
{ | |||
"id":"ve", | |||
"label":"Venda" | |||
}, | |||
{ | |||
"id":"vec", | |||
"label":"Venetian" | |||
}, | |||
{ | |||
"id":"yav", | |||
"label":"Yangben" | |||
}, | |||
{ | |||
"id":"yrl", | |||
"label":"Nhengatu" | |||
} | |||
] | |||
} | |||
} | |||
</pre> | |||
</div> | |||
==== API ==== | |||
{| class="wikitable" | |||
! Ключ !! Тип !! Описание | |||
|- | |- | ||
|success | | success || Boolean || Был запрос успешным или нет | ||
|Boolean | |||
| | |||
|- | |- | ||
|code | | code || Number || Статус ответа | ||
| | |||
| | |||
|- | |- | ||
|msg | |msg || [String] || Сообщение об ошибке | ||
| | |||
| | |||
|- | |- | ||
| colspan="3" |data | | colspan="3" |data | ||
| Line 119: | Line 809: | ||
|} | |} | ||
=== | == Как запросить статистику == | ||
Чтобы получить данные по статистике, воспользуйтесь URL: | |||
| | {| class="wikitable" | ||
! | ! Method !! Path | ||
! | |- | ||
! | | POST || /api/stat/data | ||
|} | |||
=== Запрос === | |||
<div class="mw-collapsible mw-collapsed" style="width:80%; overflow:auto;"> | |||
Пример запроса в JSON | |||
<pre class="mw-collapsible-content"> | |||
{ | |||
"id":null, | |||
"name":null, | |||
"perPage":50, | |||
"groups":[ | |||
"time_day", | |||
"geo_country" | |||
], | |||
"metrics":[ | |||
"summary_totalVisits", | |||
"bots_total", | |||
"bots_totalPc" | |||
], | |||
"filters":{ | |||
"filters":[ | |||
{ | |||
"id":"geo_language", | |||
"type":"list", | |||
"include":["sl", "hr", "sh", "bs", "sr"], | |||
"exclude":[] | |||
} | |||
], | |||
"period":"today", | |||
"timezone":-3 | |||
}, | |||
"compare":null | |||
} | |||
</pre> | |||
</div> | |||
==== API ==== | |||
{| class="wikitable" | |||
!Ключ | |||
!Тип | |||
!Описание | |||
|- | |- | ||
|id | |id | ||
|String | |String | ||
| | |Необязательный параметр | ||
|- | |- | ||
|name | |name | ||
|String | |String | ||
| | |Необязательный параметр | ||
|- | |- | ||
|perPage | |perPage | ||
|Number | |Number | ||
|Значение по умолчанию 50 | |Количество строк, возвращаемых в запросе. Значение по умолчанию 50. | ||
|- | |- | ||
|page | |page | ||
|Number | |Number | ||
|Значение по умолчанию 1 | |Номер текущей страницы. Значение по умолчанию 1. | ||
|- | |||
|groups | |||
|[String] | |||
|Группы, которые вы хотите видеть в таблице в виде колонок | |||
'''Возможные значения:''' time_hour, time_day, time_week, time_month, time_dateTime, sub_integration, sub_botType, sub_referer, sub_1, sub_2, sib_3, sub_4, sub_5, sub_6, sub_7, geo_language, geo_timezone, geo_country, geo_city, geo_provider, device_browser, device_browserEngine, device_os, device_realOs, device_device, device_type, device_connectionType, device_useragent, screen_width, screen_height, screen_orientation, screen_pixelDensity | |||
'''Полный список группировок вы можете получить с помощью этого [[#How_to_get_all_possible_groupings_and_metrics|URL]].''' | |||
|- | |- | ||
|metrics | |metrics | ||
|[String] | |[String] | ||
| | |Метрики, которые вы хотите видеть в таблице в виде колонок | ||
'''Возможные значения:''' summary_totalVisits, summary_uniqUsers, summary_uniqUsersPc, summary_validVisits, summary_validVisitsPc, summary_techLosses, summary_techLossesPc, bots_total, bots_totalPc, bots_crawler, bots_crawlerPc, bots_spoofing, bots_spoofingPc, bots_automated, bots_automatedPc, bots_iFrame, bots_iFramePc, bots_badReputationIp, bots_badReputationIpPc, bots_blocked, bots_blockedPc, lowQuality_total, lowQuality_totalPc, lowQuality_proxy, lowQuality_proxyPc, lowQuality_spoofing, lowQuality_spoofingPc, lowQuality_automated, lowQuality_automatedPc, lowQuality_trafficCheats, lowQuality_trafficCheatsPc, feature_adBlock, feature_adBlockPc, feature_isMobile, feature_isMobilePc, feature_webView, feature_webViewPc, feature_iFrame, feature_iFramePc, feature_pushNotifications, feature_pushNotificationsPc. ''Those values are allowed only if option [[Behavioral analysis|Behavioral analysis]] is turned on for you integration'': beAn_pageVisibility, beAn_pageVisibilityPc, beAn_pageActivity, beAn_pageActivityPc, beAn_pageAcceptance, beAn_pageAcceptancePc | |||
Метрики, чьи ID наканчиваются на ''Pc'' (например: lowQuality_totalPc) возвращают проценты. | |||
'''Полный список метрик вы можете получить с помощью этого [[#How_to_get_all_possible_groupings_and_metrics|URL]].''' | |||
|- | |- | ||
| colspan="3" |filters | | colspan="3" |filters | ||
|- | |- | ||
|dateFrom | |filters.dateFrom | ||
|String | |String | ||
|Дата в формате Y-m-d | |Дата в формате Y-m-d. Если вы указываете period, dateFrom не будет учитываться, потому что period имеет больший приоритет. | ||
|- | |- | ||
|dateTo | |filters.dateTo | ||
|String | |String | ||
|Дата в формате Y-m-d | |Дата в формате Y-m-d. Если вы указываете period, dateTo не будет учитываться, потому что period имеет больший приоритет. | ||
|- | |- | ||
|filters. | |filters.period | ||
|<nowiki>today | yesterday | currentWeek | 7days| month | null</nowiki> | |<nowiki>today | yesterday | currentWeek | 7days| month | null</nowiki> | ||
| | |Если вы указываете period, то dateFrom и dateTo не будут учитываться. Period имеет больший приоритет. | ||
|- | |- | ||
|timezone | |filters.timezone | ||
|Number | |Number | ||
|От -12 до +12 | |От -12 до +12. Значение по умолчанию равно 0, что значит, что все данные будут возвращены в UTC. | ||
|- | |- | ||
| | |filters.filters | ||
|[ | |['''<filters>'''] | ||
|''' | |См. ниже описание '''<filters>''' | ||
|- | |- | ||
|compare | |compare | ||
|'''<compare>''' | |'''<compare>''' | ||
| | |См. ниже описание '''<compare>''' | ||
|} | |} | ||
{| class="wikitable mw-collapsible" | {| class="wikitable mw-collapsible" | ||
|+Описание <filters> | |+Описание <filters> | ||
! | !Ключ | ||
! | !Тип | ||
! | !Описание | ||
|- | |- | ||
|id | |id | ||
|String | |String | ||
|''' | |Колонка, по которой вы бы хотели фильтровать. | ||
time_hour, time_day, time_week, time_month, sub_integration, sub_botType, sub_referer, sub_1 | |||
'''Возможные значения:''' time_hour, time_day, time_week, time_month, sub_integration, sub_botType, sub_referer, sub_1, sub_2, sib_3, sub_4, sub_5, sub_6, sub_7, geo_language, geo_timezone, geo_country, geo_city, geo_provider, device_browser, device_browserEngine, device_os, device_realOs, device_device, device_type, device_connectionType, device_useragent, screen_width, screen_height, screen_orientation, screen_pixelDensity, summary_totalVisits, summary_uniqUsers, summary_uniqUsersPc, summary_validVisits, summary_validVisitsPc, summary_techLosses, summary_techLossesPc, bots_total, bots_totalPc, bots_crawler, bots_crawlerPc, bots_spoofing, bots_spoofingPc, bots_automated, bots_automatedPc, bots_iFrame, bots_iFramePc, bots_badReputationIp, bots_badReputationIpPc, bots_blocked, bots_blockedPc, lowQuality_total, lowQuality_totalPc, lowQuality_proxy, lowQuality_proxyPc, lowQuality_spoofing, lowQuality_spoofingPc, lowQuality_automated, lowQuality_automatedPc, lowQuality_trafficCheats, lowQuality_trafficCheatsPc, feature_adBlock, feature_adBlockPc, feature_isMobile, feature_isMobilePc, feature_webView, feature_webViewPc, feature_iFrame, feature_iFramePc, feature_pushNotifications, feature_pushNotificationsPc. ''Those values are allowed only if option [[Behavioral analysis|Behavioral analysis]] is turned on for you integration'': beAn_pageVisibility, beAn_pageVisibilityPc, beAn_pageActivity, beAn_pageActivityPc, beAn_pageAcceptance, beAn_pageAcceptancePc | |||
Фильтры, чьи ID наканчиваются на ''Pc'' (например: lowQuality_totalPc) возвращают проценты. | |||
'''Полный список метрик вы можете получить с помощью этого [[#How_to_get_all_possible_groupings_and_metrics|URL]].''' | |||
|- | |- | ||
|type | |type | ||
| | |<code>range</code><nowiki> | </nowiki><code>list</code><nowiki> | </nowiki><code>binary</code> | ||
| | | | ||
|- | |- | ||
|range | |range | ||
|{from: Number, to: Number} | |{from: Number, to: Number} | ||
| | |Используется в фильтрах с типом <code>range</code> | ||
|- | |||
|include | |||
|[Any] | |||
|Используется в фильтрах с типом <code>list</code> и <code>binary</code>. Чтобы выводить только строки, в которых встречаются искомые значения. | |||
|- | |||
|exclude | |||
|[Any] | |||
|Используется в фильтрах с типом <code>list</code> и <code>binary</code>. Чтобы выводить все строки, кроме тех, в которых встречаются искомые значения. | |||
|} | |} | ||
===== Примеры фильтров ===== | |||
'''Тип <code>list</code>, include включён.''' Ищет визиты только из Камбоджи ("KH") или Китая ("CN"). | |||
<pre> | |||
{ | |||
... | |||
"filters":{ | |||
"filters":[ | |||
{ | |||
"id":"geo_country", | |||
"type":"list", | |||
"include":["KH","CN"], | |||
"exclude":[] | |||
} | |||
], | |||
"period":"today", | |||
"timezone":-3 | |||
} | |||
} | |||
</pre> | |||
'''Тип <code>list</code>, exclude включён.''' Ищет визиты из всех стран, кроме Камбоджи ("KH") и Китая ("CN"). | |||
<pre> | |||
{ | |||
... | |||
"filters":{ | |||
"filters":[ | |||
{ | |||
"id":"geo_country", | |||
"type":"list", | |||
"include":[], | |||
"exclude":["KH","CN"] | |||
} | |||
], | |||
"period":"today", | |||
"timezone":-3 | |||
} | |||
} | |||
</pre> | |||
'''Тип <code>binary</code>, include включён.''' | |||
Ищет визиты, которые были совершены краулерами (то есть ботами поисковых систем и социальных сетей). | |||
<pre> | |||
{ | |||
... | |||
"filters":{ | |||
"filters":[ | |||
{ | |||
"id":"bots_crawler", | |||
"type":"binary", | |||
"include":[1], | |||
"exclude":[] | |||
} | |||
], | |||
"period":"today", | |||
"timezone":-3 | |||
} | |||
} | |||
</pre> | |||
'''Тип <code>binary</code>, exclude включён.''' Не показывает визиты, совершённые краулерами. | |||
<pre> | |||
{ | |||
... | |||
"filters":{ | |||
"filters":[ | |||
{ | |||
"id":"bots_crawler", | |||
"type":"binary", | |||
"include":[], | |||
"exclude":[1] | |||
} | |||
], | |||
"period":"today", | |||
"timezone":-3 | |||
} | |||
} | |||
</pre> | |||
'''Тип <code>range</code>.''' Ищет срезы, на которых общее количество ботовых визитов находится между одной и десятью тысячами. | |||
<pre> | |||
{ | |||
... | |||
"filters":{ | |||
"filters":[ | |||
{ | |||
"id":"bots_total", | |||
"type":"range", | |||
"range":{ | |||
"from":1000, | |||
"to":10000 | |||
} | |||
} | |||
], | |||
"period":"today", | |||
"timezone":-3 | |||
} | |||
} | |||
</pre> | |||
Тип <code>range</code>. Ищет срезы, на которых более 50% визитов совершены с мобильных устройств. | |||
<pre> | |||
{ | |||
... | |||
"filters":{ | |||
"filters":[ | |||
{ | |||
"id":"feature_isMobilePc", | |||
"type":"range", | |||
"range":{ | |||
"from":50, | |||
"to":null | |||
} | |||
} | |||
], | |||
"period":"today", | |||
"timezone":-3 | |||
} | |||
} | |||
</pre> | |||
Тип <code>range</code>. Ищет визиты, совершённые до 10 часов утра по UTC-3. | |||
<pre> | |||
{ | |||
... | |||
"filters":{ | |||
"filters":[ | |||
{ | |||
"id":"time_hour", | |||
"type":"range", | |||
"range":{ | |||
"from":null, | |||
"to":10 | |||
} | |||
} | |||
], | |||
"period":"today", | |||
"timezone":-3 | |||
} | |||
} | |||
</pre> | |||
{| class="wikitable mw-collapsible" | {| class="wikitable mw-collapsible" | ||
|+Описание <compare> | |+Описание <compare> | ||
! | !Ключ | ||
! | !Тип | ||
! | !Описание | ||
|- | |- | ||
|dateFrom | |dateFrom | ||
| Line 218: | Line 1,113: | ||
| | | | ||
|} | |} | ||
| | === Ответ === | ||
! | <div class="mw-collapsible mw-collapsed" style="width:80%; overflow:auto;"> | ||
! | Примера ответа в JSON | ||
! | <pre class="mw-collapsible-content"> | ||
{ | |||
"success":true, | |||
"code":200, | |||
"msg":[], | |||
"data":{ | |||
"rows":[ | |||
{ | |||
"id":0, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"AE", | |||
"value":"United Arab Emirates ", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"1", | |||
"value":"1", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":1, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"AT", | |||
"value":"Austria", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"27", | |||
"value":"27", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":2, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"BA", | |||
"value":"Bosnia and Herzegovina", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"349", | |||
"value":"349", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"3", | |||
"value":"3", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0.86, | |||
"value":"0.86", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":3, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"BD", | |||
"value":"Bangladesh", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"1", | |||
"value":"1", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":4, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"BG", | |||
"value":"Bulgaria", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"3", | |||
"value":"3", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":5, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"BR", | |||
"value":"Brazil", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"1", | |||
"value":"1", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":6, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"CA", | |||
"value":"Canada", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"1", | |||
"value":"1", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":7, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"CH", | |||
"value":"Switzerland", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"4", | |||
"value":"4", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":8, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"DE", | |||
"value":"Germany", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"110", | |||
"value":"110", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":9, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"HR", | |||
"value":"Croatia", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"274", | |||
"value":"274", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"4", | |||
"value":"4", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":1.46, | |||
"value":"1.46", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":10, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"HU", | |||
"value":"Hungary", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"1", | |||
"value":"1", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":11, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"IN", | |||
"value":"India", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"2", | |||
"value":"2", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":12, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"IR", | |||
"value":"Iran", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"1", | |||
"value":"1", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":13, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"IT", | |||
"value":"Italy", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"2", | |||
"value":"2", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":14, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"LB", | |||
"value":"Lebanon", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"2", | |||
"value":"2", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":15, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"LU", | |||
"value":"Luxembourg", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"1", | |||
"value":"1", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":16, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"MA", | |||
"value":"Morocco", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"1", | |||
"value":"1", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":17, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"ME", | |||
"value":"Montenegro", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"42", | |||
"value":"42", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":18, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"MK", | |||
"value":"Republic of North Macedonia", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"21", | |||
"value":"21", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":19, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"MT", | |||
"value":"Malta", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"1", | |||
"value":"1", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":20, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"NO", | |||
"value":"Norway", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"1", | |||
"value":"1", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":21, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"PL", | |||
"value":"Poland", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"8", | |||
"value":"8", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":22, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"QA", | |||
"value":"Qatar", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"2", | |||
"value":"2", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":23, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"RO", | |||
"value":"Romania", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"2", | |||
"value":"2", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":24, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"RS", | |||
"value":"Serbia", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"676", | |||
"value":"676", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"3", | |||
"value":"3", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0.44, | |||
"value":"0.44", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":25, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"RU", | |||
"value":"Russian Federation ", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"3", | |||
"value":"3", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":26, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"SE", | |||
"value":"Sweden", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"1", | |||
"value":"1", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":27, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"SI", | |||
"value":"Slovenia", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"199", | |||
"value":"199", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"10", | |||
"value":"10", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":5.03, | |||
"value":"5.03", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":28, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"SK", | |||
"value":"Slovakia", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"1", | |||
"value":"1", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":29, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"SO", | |||
"value":"Somalia", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"1", | |||
"value":"1", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":30, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"TR", | |||
"value":"Turkey", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"1", | |||
"value":"1", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":31, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"US", | |||
"value":"United States of America ", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"20", | |||
"value":"20", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"18", | |||
"value":"18", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":90, | |||
"value":"90", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
}, | |||
{ | |||
"id":32, | |||
"time_day":{ | |||
"rawValue":"10.04.2024", | |||
"value":"10.04.2024", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"geo_country":{ | |||
"rawValue":"XK", | |||
"value":"Kosovo", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":"3", | |||
"value":"3", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":"0", | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":0, | |||
"value":"0", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
} | |||
], | |||
"totalRows":33, | |||
"page":1, | |||
"perPage":50, | |||
"columns":[ | |||
{ | |||
"field":"time_day", | |||
"type":"string", | |||
"sortable":true, | |||
"unit":null, | |||
"tooltip":false | |||
}, | |||
{ | |||
"field":"geo_country", | |||
"type":"string", | |||
"sortable":true, | |||
"unit":null, | |||
"tooltip":false | |||
}, | |||
{ | |||
"field":"summary_totalVisits", | |||
"type":"number", | |||
"sortable":true, | |||
"unit":null, | |||
"tooltip":false | |||
}, | |||
{ | |||
"field":"bots_total", | |||
"type":"number", | |||
"sortable":true, | |||
"unit":null, | |||
"tooltip":true | |||
}, | |||
{ | |||
"field":"bots_totalPc", | |||
"type":"float", | |||
"sortable":true, | |||
"unit":"%", | |||
"tooltip":false | |||
} | |||
], | |||
"total":{ | |||
"id":33, | |||
"time_day":"fullResult", | |||
"geo_country":{ | |||
"rawValue":null, | |||
"value":"", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"summary_totalVisits":{ | |||
"rawValue":null, | |||
"value":"1763", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_total":{ | |||
"rawValue":null, | |||
"value":"38", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
}, | |||
"bots_totalPc":{ | |||
"rawValue":null, | |||
"value":"2.16", | |||
"diff":null, | |||
"percent":null, | |||
"compare_value":null | |||
} | |||
} | |||
} | |||
} | |||
</pre> | |||
</div> | |||
==== API ==== | |||
{| class="wikitable" | |||
! Ключ !! Тип !! Описание | |||
|- | |- | ||
|success | | success || Boolean || Был запрос успешным или нет | ||
|Boolean | |||
| | |||
|- | |- | ||
|code | | code || Number || Статус ответа | ||
| | |||
| | |||
|- | |- | ||
|msg | |msg || [String] || Сообщение об ошибке | ||
| | |||
| | |||
|- | |- | ||
| colspan="3" |data | | colspan="3" |data | ||
| Line 244: | Line 2,474: | ||
|data.totalRows | |data.totalRows | ||
|Number | |Number | ||
|Общее количество | |Общее количество строк в таблице | ||
|- | |- | ||
|data.total | |data.total | ||
| Line 260: | Line 2,490: | ||
|data.columns | |data.columns | ||
|['''<column>'''] | |['''<column>'''] | ||
|Описание столбцов | |Описание столбцов таблицы | ||
|} | |} | ||
{| class="wikitable mw-collapsible" | {| class="wikitable mw-collapsible" | ||
|+ | |+ | ||
Description <row> | |||
! | !Ключ | ||
! | !Тип | ||
! | !Описание | ||
|- | |- | ||
|value | |value | ||
|String | |String | ||
| | |Значение в человеко-читаемом виде | ||
|- | |||
|rawValue | |||
|String | |||
|Сырое значение | |||
|- | |- | ||
|diff | |diff | ||
| Line 279: | Line 2,513: | ||
|percent | |percent | ||
|<nowiki>Number | null</nowiki> | |<nowiki>Number | null</nowiki> | ||
| | |Является значение процентом или нет | ||
|- | |- | ||
|compare_value | |compare_value | ||
|<nowiki>String | null</nowiki> | |<nowiki>String | null</nowiki> | ||
| | |Сравниваемое значение (в случае, если запрос отправлен в режиме compare) | ||
|} | |} | ||
{| class="wikitable mw-collapsible" | {| class="wikitable mw-collapsible" | ||
|+ | |+ | ||
Описание <column> | Описание <column> | ||
! | !Ключ | ||
! | !Тип | ||
! | !Описание | ||
|- | |- | ||
|field | |field | ||
| Line 297: | Line 2,531: | ||
|- | |- | ||
|type | |type | ||
|<nowiki> | |<nowiki>String | Number | Float</nowiki> | ||
| | | | ||
|- | |- | ||
| Line 307: | Line 2,541: | ||
|<nowiki>String | null</nowiki> | |<nowiki>String | null</nowiki> | ||
|Единица измерения. | |Единица измерения. | ||
Например, % у процентных столбцов | Например, % у процентных столбцов | ||
|} | |} | ||
| Line 326: | Line 2,560: | ||
</pre> | </pre> | ||
=== NodeJS === | |||
const https = require('https'); | const https = require('https'); | ||
| Line 357: | Line 2,591: | ||
<nowiki> </nowiki> }); | <nowiki> </nowiki> }); | ||
=== PHP === | |||
<?php | <?php | ||
$ch = curl_init(); | $ch = curl_init(); | ||
| Line 371: | Line 2,605: | ||
curl_close($ch); | curl_close($ch); | ||
=== Python === | |||
import requests | import requests | ||
| Line 380: | Line 2,614: | ||
response = requests.options('<nowiki>https://kaminari.click/api/stat/get'</nowiki>, headers=headers) | response = requests.options('<nowiki>https://kaminari.click/api/stat/get'</nowiki>, headers=headers) | ||
response = requests.options('<nowiki>http://Authorization</nowiki>: Bearer <YOUR API_TOKEN>', headers=headers) | response = requests.options('<nowiki>http://Authorization</nowiki>: Bearer <YOUR API_TOKEN>', headers=headers) | ||
Latest revision as of 18:10, 1 June 2024
Подробное описание request-response по каждому эндпойнту.
Список эндпойнтов:
| Method | Path | Description |
|---|---|---|
| OPTIONS | /api/stat/get | Возвращает все возможные группировки и метрики, сгруппированные по категориям. |
| POST | /api/stat/filter | получение данных для фильтра |
| POST | /api/stat/data | получение данных для таблицы |
Как получить список всех доступных метрик и группировок
Чтобы получить все метрики и группировки, сгруппированные по категориям, воспользуйтесь этим URL:
| Method | Path |
|---|---|
| OPTIONS | /api/stat/get |
Если вы хотите лучше понять, что показывают наши метрики, посетите страницу Metrics and groups.
Запрос
Нет параметров
Ответ
Пример ответа в JSON
{
"success":true,
"code":200,
"msg":[],
"data":{
"groups":{
"time":[
{
"id":"time_hour",
"icon":"date",
"filterType":"range"
},
{
"id":"time_day",
"icon":"date",
"filterType":"range"
},
{
"id":"time_week",
"icon":"date",
"filterType":"range"
},
{
"id":"time_month",
"icon":"date",
"filterType":"range"
},
{
"id":"time_dateTime",
"icon":"date",
"filterType":"list",
"filterSync":true
}
],
"sub":[
{
"id":"sub_integration",
"icon":"text",
"filterType":"list",
"filterSync":false
},
{
"id":"sub_botType",
"icon":"text",
"filterType":"list",
"filterSync":false
},
{
"id":"sub_cnvId",
"icon":"text",
"filterType":"list",
"filterSync":true
},
{
"id":"sub_clickId",
"icon":"number",
"filterType":"list",
"filterSync":true
},
{
"id":"sub_referer",
"icon":"text",
"filterType":"list",
"filterSync":true,
"tooltip":true
},
{
"id":"sub_1",
"icon":"text",
"filterType":"list",
"filterSync":true
},
{
"id":"sub_2",
"icon":"text",
"filterType":"list",
"filterSync":true
},
{
"id":"sub_3",
"icon":"text",
"filterType":"list",
"filterSync":true
},
{
"id":"sub_4",
"icon":"text",
"filterType":"list",
"filterSync":true
},
{
"id":"sub_5",
"icon":"text",
"filterType":"list",
"filterSync":true
},
{
"id":"sub_6",
"icon":"text",
"filterType":"list",
"filterSync":true
},
{
"id":"sub_7",
"icon":"text",
"filterType":"list",
"filterSync":true
}
],
"geo":[
{
"id":"geo_language",
"icon":"text",
"filterType":"list",
"filterSync":true
},
{
"id":"geo_timezone",
"icon":"text",
"filterType":"list",
"filterSync":false
},
{
"id":"geo_country",
"icon":"text",
"filterType":"list",
"filterSync":false
},
{
"id":"geo_city",
"icon":"text",
"filterType":"list",
"filterSync":true
},
{
"id":"geo_provider",
"icon":"text",
"filterType":"list",
"filterSync":true
},
{
"id":"geo_ip",
"icon":"text",
"filterType":"list",
"filterSync":true
}
],
"device":[
{
"id":"device_browser",
"icon":"text",
"filterType":"list",
"filterSync":true,
"tooltip":true
},
{
"id":"device_browserEngine",
"icon":"text",
"filterType":"list",
"filterSync":true,
"tooltip":true
},
{
"id":"device_os",
"icon":"text",
"filterType":"list",
"filterSync":true,
"tooltip":true
},
{
"id":"device_realOs",
"icon":"text",
"filterType":"list",
"filterSync":false,
"tooltip":true
},
{
"id":"device_device",
"icon":"text",
"filterType":"list",
"filterSync":true,
"tooltip":true
},
{
"id":"device_type",
"icon":"text",
"filterType":"list",
"filterSync":false,
"tooltip":true
},
{
"id":"device_connectionType",
"icon":"text",
"filterType":"list",
"filterSync":false
},
{
"id":"device_useragent",
"icon":"text",
"filterType":"list",
"filterSync":true
}
],
"screen":[
{
"id":"screen_width",
"icon":"number",
"filterType":"range",
"tooltip":true
},
{
"id":"screen_height",
"icon":"number",
"filterType":"range",
"tooltip":true
},
{
"id":"screen_orientation",
"icon":"text",
"filterType":"list",
"filterSync":false
},
{
"id":"screen_pixelDensity",
"icon":"number",
"filterType":"list",
"filterSync":true,
"tooltip":true
}
]
},
"metrics":{
"summary":[
{
"id":"summary_totalVisits",
"icon":"number",
"filterType":"range"
},
{
"id":"summary_validVisits",
"icon":"number",
"filterType":"range",
"filterSync":false,
"tooltip":true
},
{
"id":"summary_validVisitsPc",
"icon":"number",
"filterType":"range",
"filterSync":false
},
{
"id":"summary_techLosses",
"icon":"number",
"filterType":"range",
"filterSync":false,
"tooltip":true
},
{
"id":"summary_techLossesPc",
"icon":"number",
"filterType":"range",
"filterSync":false
},
{
"id":"summary_uniqUsers",
"icon":"number",
"filterType":"range",
"tooltip":true
},
{
"id":"summary_uniqUsersPc",
"icon":"number",
"filterType":"range"
},
{
"id":"summary_conversions",
"icon":"number",
"filterType":"binary",
"filterSync":false,
"tooltip":true
},
{
"id":"summary_conversionsPc",
"icon":"number",
"filterType":"range",
"filterSync":false
}
],
"bots":[
{
"id":"bots_total",
"icon":"number",
"filterType":"range",
"filterSync":false,
"tooltip":true
},
{
"id":"bots_totalPc",
"icon":"number",
"filterType":"range",
"filterSync":false
},
{
"id":"bots_crawler",
"icon":"number",
"filterType":"binary",
"filterSync":false,
"tooltip":true
},
{
"id":"bots_crawlerPc",
"icon":"number",
"filterType":"range",
"filterSync":false
},
{
"id":"bots_spoofing",
"icon":"number",
"filterType":"binary",
"filterSync":false,
"tooltip":true
},
{
"id":"bots_spoofingPc",
"icon":"number",
"filterType":"range",
"filterSync":false
},
{
"id":"bots_automated",
"icon":"number",
"filterType":"binary",
"filterSync":false,
"tooltip":true
},
{
"id":"bots_automatedPc",
"icon":"number",
"filterType":"range",
"filterSync":false
},
{
"id":"bots_iFrame",
"icon":"number",
"filterType":"binary",
"filterSync":false,
"tooltip":true
},
{
"id":"bots_iFramePc",
"icon":"number",
"filterType":"range",
"filterSync":false
},
{
"id":"bots_badReputationIp",
"icon":"number",
"filterType":"binary",
"filterSync":false,
"tooltip":true
},
{
"id":"bots_badReputationIpPc",
"icon":"number",
"filterType":"range",
"filterSync":false
},
{
"id":"bots_blocked",
"icon":"number",
"filterType":"binary",
"filterSync":false,
"tooltip":true
},
{
"id":"bots_blockedPc",
"icon":"number",
"filterType":"range",
"filterSync":false
}
],
"lowQuality":[
{
"id":"lowQuality_total",
"icon":"number",
"filterType":"binary",
"filterSync":false,
"tooltip":true
},
{
"id":"lowQuality_totalPc",
"icon":"number",
"filterType":"range",
"filterSync":false
},
{
"id":"lowQuality_proxy",
"icon":"number",
"filterType":"binary",
"filterSync":false,
"tooltip":true
},
{
"id":"lowQuality_proxyPc",
"icon":"number",
"filterType":"range",
"filterSync":false
},
{
"id":"lowQuality_spoofing",
"icon":"number",
"filterType":"binary",
"filterSync":false,
"tooltip":true
},
{
"id":"lowQuality_spoofingPc",
"icon":"number",
"filterType":"range",
"filterSync":false
},
{
"id":"lowQuality_automated",
"icon":"number",
"filterType":"binary",
"filterSync":false,
"tooltip":true
},
{
"id":"lowQuality_automatedPc",
"icon":"number",
"filterType":"range",
"filterSync":false
},
{
"id":"lowQuality_trafficCheats",
"icon":"number",
"filterType":"binary",
"filterSync":false,
"tooltip":true
},
{
"id":"lowQuality_trafficCheatsPc",
"icon":"number",
"filterType":"range",
"filterSync":false
}
],
"feature":[
{
"id":"feature_adBlock",
"icon":"number",
"filterType":"list",
"filterSync":false,
"tooltip":true
},
{
"id":"feature_adBlockPc",
"icon":"number",
"filterType":"range"
},
{
"id":"feature_isMobile",
"icon":"number",
"filterType":"binary",
"tooltip":true
},
{
"id":"feature_isMobilePc",
"icon":"number",
"filterType":"range"
},
{
"id":"feature_webView",
"icon":"number",
"filterType":"binary",
"tooltip":true
},
{
"id":"feature_webViewPc",
"icon":"number",
"filterType":"range"
},
{
"id":"feature_iFrame",
"icon":"number",
"filterType":"binary",
"filterSync":false,
"tooltip":true
},
{
"id":"feature_iFramePc",
"icon":"number",
"filterType":"range",
"filterSync":false
},
{
"id":"feature_pushNotifications",
"icon":"number",
"filterType":"binary",
"filterSync":false,
"tooltip":true
},
{
"id":"feature_pushNotificationsPc",
"icon":"number",
"filterType":"range",
"filterSync":false
}
],
"beAn":[
{
"id":"beAn_pageVisibility",
"icon":"number",
"filterType":"list",
"filterSync":false,
"tooltip":true,
"disabled":false
},
{
"id":"beAn_pageVisibilityPc",
"icon":"number",
"filterType":"range",
"filterSync":false,
"disabled":false
},
{
"id":"beAn_pageActivity",
"icon":"number",
"filterType":"list",
"filterSync":false,
"tooltip":true,
"disabled":false
},
{
"id":"beAn_pageActivityPc",
"icon":"number",
"filterType":"range",
"filterSync":false,
"disabled":false
},
{
"id":"beAn_pageAcceptance",
"icon":"number",
"filterType":"list",
"filterSync":false,
"tooltip":true,
"disabled":false
},
{
"id":"beAn_pageAcceptancePc",
"icon":"number",
"filterType":"range",
"filterSync":false,
"disabled":false
}
]
}
}
}
API
| Ключ | Тип | Описание |
|---|---|---|
| success | Boolean | Был запрос успешным или нет |
| code | Number | Статус ответа |
| msg | [String] | Сообщение об ошибке |
| data | ||
| data.groups | { groupTitle: [<item>, …] } | См. ниже описание <item> |
| data.metrics | { metricTitle: [<item>, …] } | См. ниже описание <item> |
| Ключ | Тип | Описание |
|---|---|---|
| id | String | <groupTitle или metricTitle>
+ подчёркивание + <название метрики или группировки> (groupTitle_id, например: lowQuality_total, feature_adBlock) |
| icon | date | text | number
|
Тип возвращаемого контента |
| filterType | range | list | binary
|
См. ниже описание <filters> |
| filterSync | Boolean * | list с поиском на сервере
|
Как получить все возможные значения фильтра
Чтобы получить значения какого-то фильтра, используйте URL:
| Method | Path |
|---|---|
| POST | /api/stat/filter |
Запрос
Пример запроса в JSON
{
"id":"geo_language",
"searchQuery":"en",
"dateFrom":"2024-04-10",
"dateTo":"2024-04-10"
}
API
| Ключ | Тип | Описание |
|---|---|---|
| id | String | Название фильтра |
| searchQuery | String | Поисковый запрос |
| dateFrom | String | Начиная с какой даты мы должны искать? Дата в формате Y-m-d. |
| dateTo | String | По какую дату мы должны искать? Дата в формате Y-m-d. |
Ответ
Пример ответа в JSON
{
"success":true,
"code":200,
"msg":[],
"data":{
"items":[
{
"id":"bd",
"label":"Bengali"
},
{
"id":"bez",
"label":"Bena (Tanzania)"
},
{
"id":"bn",
"label":"Bengali"
},
{
"id":"ce",
"label":"Chechen"
},
{
"id":"ckb",
"label":"Central Kurdish"
},
{
"id":"en",
"label":"English"
},
{
"id":"fr",
"label":"French"
},
{
"id":"hy",
"label":"Armenian"
},
{
"id":"kam",
"label":"Kamba (Kenya)"
},
{
"id":"kln",
"label":"Kalenjin"
},
{
"id":"km",
"label":"Central Khmer"
},
{
"id":"luo",
"label":"Luo (Kenya and Tanzania)"
},
{
"id":"mfe",
"label":"Morisyen"
},
{
"id":"seh",
"label":"Sena"
},
{
"id":"ses",
"label":"Koyraboro Senni Songhai"
},
{
"id":"sl",
"label":"Slovenian"
},
{
"id":"tk",
"label":"Turkmen"
},
{
"id":"tzm",
"label":"Central Atlas Tamazight"
},
{
"id":"ve",
"label":"Venda"
},
{
"id":"vec",
"label":"Venetian"
},
{
"id":"yav",
"label":"Yangben"
},
{
"id":"yrl",
"label":"Nhengatu"
}
]
}
}
API
| Ключ | Тип | Описание |
|---|---|---|
| success | Boolean | Был запрос успешным или нет |
| code | Number | Статус ответа |
| msg | [String] | Сообщение об ошибке |
| data | ||
| data.items | [{ id: Number, label: String }] | { id: 1, label: "Param A" } |
Как запросить статистику
Чтобы получить данные по статистике, воспользуйтесь URL:
| Method | Path |
|---|---|
| POST | /api/stat/data |
Запрос
Пример запроса в JSON
{
"id":null,
"name":null,
"perPage":50,
"groups":[
"time_day",
"geo_country"
],
"metrics":[
"summary_totalVisits",
"bots_total",
"bots_totalPc"
],
"filters":{
"filters":[
{
"id":"geo_language",
"type":"list",
"include":["sl", "hr", "sh", "bs", "sr"],
"exclude":[]
}
],
"period":"today",
"timezone":-3
},
"compare":null
}
API
| Ключ | Тип | Описание |
|---|---|---|
| id | String | Необязательный параметр |
| name | String | Необязательный параметр |
| perPage | Number | Количество строк, возвращаемых в запросе. Значение по умолчанию 50. |
| page | Number | Номер текущей страницы. Значение по умолчанию 1. |
| groups | [String] | Группы, которые вы хотите видеть в таблице в виде колонок
Возможные значения: time_hour, time_day, time_week, time_month, time_dateTime, sub_integration, sub_botType, sub_referer, sub_1, sub_2, sib_3, sub_4, sub_5, sub_6, sub_7, geo_language, geo_timezone, geo_country, geo_city, geo_provider, device_browser, device_browserEngine, device_os, device_realOs, device_device, device_type, device_connectionType, device_useragent, screen_width, screen_height, screen_orientation, screen_pixelDensity Полный список группировок вы можете получить с помощью этого URL. |
| metrics | [String] | Метрики, которые вы хотите видеть в таблице в виде колонок
Возможные значения: summary_totalVisits, summary_uniqUsers, summary_uniqUsersPc, summary_validVisits, summary_validVisitsPc, summary_techLosses, summary_techLossesPc, bots_total, bots_totalPc, bots_crawler, bots_crawlerPc, bots_spoofing, bots_spoofingPc, bots_automated, bots_automatedPc, bots_iFrame, bots_iFramePc, bots_badReputationIp, bots_badReputationIpPc, bots_blocked, bots_blockedPc, lowQuality_total, lowQuality_totalPc, lowQuality_proxy, lowQuality_proxyPc, lowQuality_spoofing, lowQuality_spoofingPc, lowQuality_automated, lowQuality_automatedPc, lowQuality_trafficCheats, lowQuality_trafficCheatsPc, feature_adBlock, feature_adBlockPc, feature_isMobile, feature_isMobilePc, feature_webView, feature_webViewPc, feature_iFrame, feature_iFramePc, feature_pushNotifications, feature_pushNotificationsPc. Those values are allowed only if option Behavioral analysis is turned on for you integration: beAn_pageVisibility, beAn_pageVisibilityPc, beAn_pageActivity, beAn_pageActivityPc, beAn_pageAcceptance, beAn_pageAcceptancePc Метрики, чьи ID наканчиваются на Pc (например: lowQuality_totalPc) возвращают проценты. Полный список метрик вы можете получить с помощью этого URL. |
| filters | ||
| filters.dateFrom | String | Дата в формате Y-m-d. Если вы указываете period, dateFrom не будет учитываться, потому что period имеет больший приоритет. |
| filters.dateTo | String | Дата в формате Y-m-d. Если вы указываете period, dateTo не будет учитываться, потому что period имеет больший приоритет. |
| filters.period | today | yesterday | currentWeek | 7days| month | null | Если вы указываете period, то dateFrom и dateTo не будут учитываться. Period имеет больший приоритет. |
| filters.timezone | Number | От -12 до +12. Значение по умолчанию равно 0, что значит, что все данные будут возвращены в UTC. |
| filters.filters | [<filters>] | См. ниже описание <filters> |
| compare | <compare> | См. ниже описание <compare> |
| Ключ | Тип | Описание |
|---|---|---|
| id | String | Колонка, по которой вы бы хотели фильтровать.
Возможные значения: time_hour, time_day, time_week, time_month, sub_integration, sub_botType, sub_referer, sub_1, sub_2, sib_3, sub_4, sub_5, sub_6, sub_7, geo_language, geo_timezone, geo_country, geo_city, geo_provider, device_browser, device_browserEngine, device_os, device_realOs, device_device, device_type, device_connectionType, device_useragent, screen_width, screen_height, screen_orientation, screen_pixelDensity, summary_totalVisits, summary_uniqUsers, summary_uniqUsersPc, summary_validVisits, summary_validVisitsPc, summary_techLosses, summary_techLossesPc, bots_total, bots_totalPc, bots_crawler, bots_crawlerPc, bots_spoofing, bots_spoofingPc, bots_automated, bots_automatedPc, bots_iFrame, bots_iFramePc, bots_badReputationIp, bots_badReputationIpPc, bots_blocked, bots_blockedPc, lowQuality_total, lowQuality_totalPc, lowQuality_proxy, lowQuality_proxyPc, lowQuality_spoofing, lowQuality_spoofingPc, lowQuality_automated, lowQuality_automatedPc, lowQuality_trafficCheats, lowQuality_trafficCheatsPc, feature_adBlock, feature_adBlockPc, feature_isMobile, feature_isMobilePc, feature_webView, feature_webViewPc, feature_iFrame, feature_iFramePc, feature_pushNotifications, feature_pushNotificationsPc. Those values are allowed only if option Behavioral analysis is turned on for you integration: beAn_pageVisibility, beAn_pageVisibilityPc, beAn_pageActivity, beAn_pageActivityPc, beAn_pageAcceptance, beAn_pageAcceptancePc Фильтры, чьи ID наканчиваются на Pc (например: lowQuality_totalPc) возвращают проценты. Полный список метрик вы можете получить с помощью этого URL. |
| type | range | list | binary
|
|
| range | {from: Number, to: Number} | Используется в фильтрах с типом range
|
| include | [Any] | Используется в фильтрах с типом list и binary. Чтобы выводить только строки, в которых встречаются искомые значения.
|
| exclude | [Any] | Используется в фильтрах с типом list и binary. Чтобы выводить все строки, кроме тех, в которых встречаются искомые значения.
|
Примеры фильтров
Тип list, include включён. Ищет визиты только из Камбоджи ("KH") или Китая ("CN").
{
...
"filters":{
"filters":[
{
"id":"geo_country",
"type":"list",
"include":["KH","CN"],
"exclude":[]
}
],
"period":"today",
"timezone":-3
}
}
Тип list, exclude включён. Ищет визиты из всех стран, кроме Камбоджи ("KH") и Китая ("CN").
{
...
"filters":{
"filters":[
{
"id":"geo_country",
"type":"list",
"include":[],
"exclude":["KH","CN"]
}
],
"period":"today",
"timezone":-3
}
}
Тип binary, include включён.
Ищет визиты, которые были совершены краулерами (то есть ботами поисковых систем и социальных сетей).
{
...
"filters":{
"filters":[
{
"id":"bots_crawler",
"type":"binary",
"include":[1],
"exclude":[]
}
],
"period":"today",
"timezone":-3
}
}
Тип binary, exclude включён. Не показывает визиты, совершённые краулерами.
{
...
"filters":{
"filters":[
{
"id":"bots_crawler",
"type":"binary",
"include":[],
"exclude":[1]
}
],
"period":"today",
"timezone":-3
}
}
Тип range. Ищет срезы, на которых общее количество ботовых визитов находится между одной и десятью тысячами.
{
...
"filters":{
"filters":[
{
"id":"bots_total",
"type":"range",
"range":{
"from":1000,
"to":10000
}
}
],
"period":"today",
"timezone":-3
}
}
Тип range. Ищет срезы, на которых более 50% визитов совершены с мобильных устройств.
{
...
"filters":{
"filters":[
{
"id":"feature_isMobilePc",
"type":"range",
"range":{
"from":50,
"to":null
}
}
],
"period":"today",
"timezone":-3
}
}
Тип range. Ищет визиты, совершённые до 10 часов утра по UTC-3.
{
...
"filters":{
"filters":[
{
"id":"time_hour",
"type":"range",
"range":{
"from":null,
"to":10
}
}
],
"period":"today",
"timezone":-3
}
}
| Ключ | Тип | Описание |
|---|---|---|
| dateFrom | String | Дата в формате Y-m-d |
| dateTo | String | Дата в формате Y-m-d |
| mode | compare_value | diff | percent | |
| sort | Boolean |
Ответ
Примера ответа в JSON
{
"success":true,
"code":200,
"msg":[],
"data":{
"rows":[
{
"id":0,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"AE",
"value":"United Arab Emirates ",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"1",
"value":"1",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":1,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"AT",
"value":"Austria",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"27",
"value":"27",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":2,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"BA",
"value":"Bosnia and Herzegovina",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"349",
"value":"349",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"3",
"value":"3",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0.86,
"value":"0.86",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":3,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"BD",
"value":"Bangladesh",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"1",
"value":"1",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":4,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"BG",
"value":"Bulgaria",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"3",
"value":"3",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":5,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"BR",
"value":"Brazil",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"1",
"value":"1",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":6,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"CA",
"value":"Canada",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"1",
"value":"1",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":7,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"CH",
"value":"Switzerland",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"4",
"value":"4",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":8,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"DE",
"value":"Germany",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"110",
"value":"110",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":9,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"HR",
"value":"Croatia",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"274",
"value":"274",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"4",
"value":"4",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":1.46,
"value":"1.46",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":10,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"HU",
"value":"Hungary",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"1",
"value":"1",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":11,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"IN",
"value":"India",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"2",
"value":"2",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":12,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"IR",
"value":"Iran",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"1",
"value":"1",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":13,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"IT",
"value":"Italy",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"2",
"value":"2",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":14,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"LB",
"value":"Lebanon",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"2",
"value":"2",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":15,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"LU",
"value":"Luxembourg",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"1",
"value":"1",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":16,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"MA",
"value":"Morocco",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"1",
"value":"1",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":17,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"ME",
"value":"Montenegro",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"42",
"value":"42",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":18,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"MK",
"value":"Republic of North Macedonia",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"21",
"value":"21",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":19,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"MT",
"value":"Malta",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"1",
"value":"1",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":20,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"NO",
"value":"Norway",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"1",
"value":"1",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":21,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"PL",
"value":"Poland",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"8",
"value":"8",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":22,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"QA",
"value":"Qatar",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"2",
"value":"2",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":23,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"RO",
"value":"Romania",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"2",
"value":"2",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":24,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"RS",
"value":"Serbia",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"676",
"value":"676",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"3",
"value":"3",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0.44,
"value":"0.44",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":25,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"RU",
"value":"Russian Federation ",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"3",
"value":"3",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":26,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"SE",
"value":"Sweden",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"1",
"value":"1",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":27,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"SI",
"value":"Slovenia",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"199",
"value":"199",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"10",
"value":"10",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":5.03,
"value":"5.03",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":28,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"SK",
"value":"Slovakia",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"1",
"value":"1",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":29,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"SO",
"value":"Somalia",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"1",
"value":"1",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":30,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"TR",
"value":"Turkey",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"1",
"value":"1",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":31,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"US",
"value":"United States of America ",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"20",
"value":"20",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"18",
"value":"18",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":90,
"value":"90",
"diff":null,
"percent":null,
"compare_value":null
}
},
{
"id":32,
"time_day":{
"rawValue":"10.04.2024",
"value":"10.04.2024",
"diff":null,
"percent":null,
"compare_value":null
},
"geo_country":{
"rawValue":"XK",
"value":"Kosovo",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":"3",
"value":"3",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":"0",
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":0,
"value":"0",
"diff":null,
"percent":null,
"compare_value":null
}
}
],
"totalRows":33,
"page":1,
"perPage":50,
"columns":[
{
"field":"time_day",
"type":"string",
"sortable":true,
"unit":null,
"tooltip":false
},
{
"field":"geo_country",
"type":"string",
"sortable":true,
"unit":null,
"tooltip":false
},
{
"field":"summary_totalVisits",
"type":"number",
"sortable":true,
"unit":null,
"tooltip":false
},
{
"field":"bots_total",
"type":"number",
"sortable":true,
"unit":null,
"tooltip":true
},
{
"field":"bots_totalPc",
"type":"float",
"sortable":true,
"unit":"%",
"tooltip":false
}
],
"total":{
"id":33,
"time_day":"fullResult",
"geo_country":{
"rawValue":null,
"value":"",
"diff":null,
"percent":null,
"compare_value":null
},
"summary_totalVisits":{
"rawValue":null,
"value":"1763",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_total":{
"rawValue":null,
"value":"38",
"diff":null,
"percent":null,
"compare_value":null
},
"bots_totalPc":{
"rawValue":null,
"value":"2.16",
"diff":null,
"percent":null,
"compare_value":null
}
}
}
}
API
| Ключ | Тип | Описание |
|---|---|---|
| success | Boolean | Был запрос успешным или нет |
| code | Number | Статус ответа |
| msg | [String] | Сообщение об ошибке |
| data | ||
| data.rows | [<row>] | Описание строк таблицы |
| data.totalRows | Number | Общее количество строк в таблице |
| data.total | <row> | Сумма по каждой колонке с учётом невидимых строк |
| data.page | Number | Текущая страница |
| data.perPage | Number | Количество элементов на странице |
| data.columns | [<column>] | Описание столбцов таблицы |
| Ключ | Тип | Описание |
|---|---|---|
| value | String | Значение в человеко-читаемом виде |
| rawValue | String | Сырое значение |
| diff | String | null | |
| percent | Number | null | Является значение процентом или нет |
| compare_value | String | null | Сравниваемое значение (в случае, если запрос отправлен в режиме compare) |
| Ключ | Тип | Описание |
|---|---|---|
| field | String | ID метрики или группировки |
| type | String | Number | Float | |
| sortable | Boolean | Можно сортировать или нет |
| unit | String | null | Единица измерения.
Например, % у процентных столбцов |
Примеры запросов.
CURL
curl -X 'OPTIONS' \ 'https://kaminari.click/api/stat/get' \ -H 'accept: */*' 'Authorization: Bearer <YOUR API_TOKEN>'
curl -X POST 'https://kaminari.click/api/stat/filter' -d '{"id":"device_type","searchQuery":"","dateFrom":"2023-01-05","dateTo":"2023-01-05"}' -H 'content-type: application/json' -H 'Authorization: Bearer <YOUR API_TOKEN>'
curl -X POST 'https://kaminari.click/api/stat/data' -d '{"id":null,"name":null,"groups":["time_day"],"metrics":["summary_totalVisits"],"filters":{"filters":[],"period":null,"timezone":0,"dateTo":"2022-08-15","dateFrom":"2022-08-15"},"compare":null}' -H 'content-type: application/json' -H 'Authorization: Bearer <YOUR API_TOKEN>'
NodeJS
const https = require('https');
const options = {
host: 'kaminari.click',
port: 443,
path: '/api/stat/get',
method: 'POST',
headers: { 'Authorization': 'Bearer <YOUR API_TOKEN>' }
};
https
.get(options, (resp) => {
let data = '';
resp.on('data', (chunk) => {
data += chunk;
});
resp.on('end', () => {
try {
data = JSON.parse(data);
} catch {
console.log(data);
}
});
})
.on("error", (err) => {
console.log("Error: " + err.message);
});
PHP
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://kaminari.click/api/stat/get');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'OPTIONS');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'accept: */*',
]);
$response = curl_exec($ch);
curl_close($ch);
Python
import requests
headers = {
'accept': '*/*',
}
response = requests.options('https://kaminari.click/api/stat/get', headers=headers)
response = requests.options('http://Authorization: Bearer <YOUR API_TOKEN>', headers=headers)