post https://tdm4.adcloud.org/api/?id=campaign4
Метод получения статистики кампании / креатива по идентификатору.
Discription
Request
Тело запроса:
{
"jsonrpc": "2.0",
"method": "campaign.getReportById",
"params": {
"xxhash": "43DC9F7B66AFBED7",
"type": "day",
"mode": "return",
"period": {
"from": "2020-12-22",
"to": "2021-01-03"
}
},
"id": 1
}
Запрос соответствует стандарту JSON RPC 2.0, ниже представлено описание содержимого секции параметров:
Key | Value | Comment |
---|---|---|
xxhash | A5452787A85F45FD | ID кампании, строка |
type | day | вид отчета, доступный список можно узнать с помощью метода campaign.getInfo из секции "reports". |
mode | return | вид ответа, строка в значении “return” (значение по-умолчанию) или “tsv“, “csv“, “xls“, “xlsx“ (данные выгружаются в табличный файл), необязательный параметр |
period | {object} | объект с двумя датами, начало и конец периода, строки формата YYYY-MM-DD |
Response
Тело ответа:
{
"jsonrpc": "2.0",
"result": {
"items": {
"2020-12-22": {
"bid_statistic": 223680,
"show": 31552,
"click": 22,
"cpc": 22.847949090909093,
"cpm": 15.930998985801219,
"ctr": 0.0697261663286004,
"spent": 502.65488000000005
},
"2020-12-23": {
"bid_statistic": 225340,
"show": 31295,
"click": 21,
"cpc": 23.087821523809534,
"cpm": 15.492706566544184,
"ctr": 0.06710337114555041,
"spent": 484.8442520000002
},
"2020-12-24": {
"bid_statistic": 233576,
"show": 33674,
"click": 23,
"cpc": 21.364862086956524,
"cpm": 14.592618281166478,
"ctr": 0.06830195402981529,
"spent": 491.39182800000003
},
"2020-12-25": {
"bid_statistic": 403288,
"show": 43164,
"click": 33,
"cpc": 20.812734757575758,
"cpm": 15.91187672597535,
"ctr": 0.0764525993883792,
"spent": 686.820247
},
"2020-12-26": {
"bid_statistic": 583227,
"show": 55547,
"click": 35,
"cpc": 25.55734131428572,
"cpm": 16.103604983167408,
"ctr": 0.06300970349433813,
"spent": 894.5069460000001
},
"2020-12-27": {
"bid_statistic": 616678,
"show": 55896,
"click": 34,
"cpc": 27.817896882352937,
"cpm": 16.920861850579644,
"ctr": 0.0608272506082725,
"spent": 945.8084939999999
},
"2020-12-28": {
"bid_statistic": 680974,
"show": 83095,
"click": 42,
"cpc": 30.002074809523805,
"cpm": 15.164415933570009,
"ctr": 0.05054455743426199,
"spent": 1260.0871419999999
},
"2020-12-29": {
"bid_statistic": 36378,
"show": 3946,
"click": 5,
"cpc": 11.469076,
"cpm": 14.532534211860112,
"ctr": 0.12671059300557527,
"spent": 57.34538
}
},
"total": {
"bid_statistic": 3003141,
"show": 338169,
"click": 215,
"cpc": 24.760275204651162,
"cpm": 15.742008194127788,
"ctr": 0.06357767861631315,
"spent": 5323.459169
}
},
"id": 1
}
Ответ соответствует стандарту JSON RPC 2.0, ниже представлено описание содержимого секции результатов.
Key | Value | Comment |
---|---|---|
total | {Object} | итоговые данные статистики, объект. Структура объекта зависит от типа отчёта, подробнее смотрите в статье |
items | {Object} | Для каждой даты содержит значения: bid_statistic - сумма по столбцу bid, show - количество показов, click - количество кликов, spent - расход в текущей валюте, cpc - рассчитанный cpc (стоимость одного клика) cpm - рассчитанный cpm (стоимость 1000 показов), ctr - ctr в % (кликабельность). |
Выход при параметре mode в значении tsv, csv, xls, xlsx
“report_url“ - статическая ссылка на выгруженный отчет, строка