#345: Статистика рекламодателя

Отредактирована: 10 дней назад

Статистика по времени

Параметры

HTTP методПрава доступаURLПараметрыПримечание
GETadvertiser_statisticshttps://api.admitad.com/advertiser/{c_id}/statistics/dates/offset**Статистические данные по времени, где с_id — это идентификатор партнерской программы*
limit**
start_date***
end_date***
webmasters***
websites***
groups***
channels***
banners***
landings***
order_by****

* Возвращает результат в формате JSON.

** Задаёт пропуск и количество возвращаемых записей. Например limit=5&offset=2

*** Фильтр по датам, веб-мастерам, площадкам, группам, каналам, банерам и лендингам соответственно. Например websites=3&websites=4&groups=8&start_date=01.01.2011&end_date=11.01.2011, где значения - это идентификаторы фильтруемых категорий или фильтруемые данные. Значения для дат должны быть в формате %d.%m.%Y - 01.05.2012.

**** Порядок сортировки. Возможные значения:

  • clicks
  • cr
  • ctr
  • date
  • ecpc
  • ecpm
  • leads_approved
  • leads_declined
  • leads_open
  • new_rate
  • payment_sum_all
  • payment_sum_approved
  • payment_sum_declined
  • payment_sum_open
  • sales_approved
  • sales_declined
  • sales_open
  • views
    Знак '-' перед значением означает обратный порядок. Например, order_by=-clicks&order_by=cr.

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token' -X GET
"https://api.admitad.com/advertiser/1/statistics/dates/?limit=2"

Пример ответа API-сервера в формате JSON:

{
    "results": [
        {
            "sales_approved": "0",
            "sales_declined": "0",
            "date": "2014-10-01",
            "payment_sum_approved": "0.00",
            "ctr": 5.11,
            "views": 138265,
            "currency": "RUB",
            "leads_open": "130",
            "payment_sum_open": "7314.00",
            "ecpm": 52.86,
            "payment_sum_declined": "0.00",
            "cr": 1.84,
            "leads_declined": "0",
            "sales_open": "0",
            "leads_approved": "0",
            "ecpc": 1.03,
            "clicks": 7070
        },
        {
            "sales_approved": "0",
            "sales_declined": "0",
            "date": "2014-10-02",
            "payment_sum_approved": "0.00",
            "ctr": 4.12,
            "views": 214719,
            "currency": "RUB",
            "leads_open": "144",
            "payment_sum_open": "7650.00",
            "ecpm": 35.63,
            "payment_sum_declined": "0.00",
            "cr": 1.63,
            "leads_declined": "0",
            "sales_open": "0",
            "leads_approved": "0"
            "ecpc": 0.86,
            "clicks": 8850
        }
    ],
    "_meta": {
        "count": 3,
        "limit": 2,
        "offset": 0
    }
}

Описание полей ответа API-сервера

НазваниеОписание
clicksКлики
currencyВалюта
crКонверсия
ctrCTR
dateДата статистики
ecpceCPC
ecpmeCPM
leads_approvedКоличество подтверждённых лидов
leads_declinedКоличество отклоненных лидов
leads_openКоличество открытых лидов
payment_sum_approvedСумма по подтверждённым действиям
payment_sum_declinedСумма по отклоненным действиям
payment_sum_openСумма по открытым действиям
sales_approvedКоличество подтверждённых продаж
sales_declinedКоличество отклоненных продаж
sales_openКоличество открытых продаж
viewsКоличество показов

Статистика по действиям

Параметры

HTTP методПрава доступаURLПараметрыПримечание
GETadvertiser_statisticshttps://api.admitad.com/advertiser/{c_id}/statistics/actions/offset**Статистические данные по действиям, где с_id — это идентификатор партнерской программы*
limit**
start_date***
end_date***
webmasters***
websites***
actions***
groups***
channels***
status***
banners***
order_id***
system_id***
order_by****

* Возвращает результат в формате JSON.

** Задаёт пропуск и количество возвращаемых записей. Наприме limit=5&offset=2.

*** Фильтр по датам, веб-мастерам, площадкам, тарифам, группам, каналам, статусам, банерам, идентификатору действия и идентификатору в системе соответственно. Например websites=3&websites=4&groups=8&start_date=01.01.2011&end_date=11.01.2011, где значения - это идентификаторы фильтруемых категорий или фильтруемые данные. Значения для дат должны быть в формате %d.%m.%Y - 01.05.2012.

**** Порядок сортировки. Возможные значения:

  • action_all
  • cart
  • click_time
  • clicks
  • closing_date
  • conversion_time
  • cr
  • ctr
  • datetime
  • ecpc
  • ecpm
  • full_payment
  • id
  • leads_approved
  • leads_declined
  • leads_open
  • new_rate
  • order_id
  • payment
  • payment_sum_all
  • payment_sum_approved
  • payment_sum_approved
  • payment_sum_declined
  • payment_sum_declined
  • payment_sum_open
  • payment_sum_open
  • payment_sum_system_approved
  • payment_sum_system_declined
  • payment_sum_system_open
  • payment_to_system
  • product
  • sales_approved
  • sales_declined
  • sales_open
  • status
  • views
  • webmaster
    Знак '-' перед значением означает обратный порядок. Например, order_by=-clicks&order_by=cr.

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token' -X GET
"https://api.admitad.com/advertiser/1/statistics/actions/?limit=2"

Пример ответа API-сервера в формате JSON:

{
    "results": [
        {
            "order_sum": "1.00",
            "action_ip": "244.196.245.35",
            "uid": "1",
            "website_id": "site1_of_webmaster1",
            "currency": "RUB",
            "id": 455109,
            "click_time": "2014-10-03T17:23:17",
            "action_country": null,
            "click_ref": "",
            "order_id": "1",
            "click_ip": "58.227.38.245",
            "action_id": 1,
            "status": 0,
            "full_payment": "5000.00",
            "screen": "",
            "action_name": "product1",
            "conversion_time": 2,
            "click_country": null,
            "user_language": "",
            "webmaster": "webmaster1",
            "action_time": "2013-12-10T16:30:52",
            "tracking": "1",
            "closing_date": "2013-12-19",
            "user_agent": "django-test-client",
            "action_ref": "",
            "original_currency": "USD"
        },
        {
            "order_sum": "1.00",
            "action_ip": "251.166.164.253",
            "uid": "1" 
            "website_id": "site1_of_webmaster1",
            "currency": "RUB",
            "id": 455110,
            "click_time": "2014-10-03T17:23:17",
            "action_country": null,
            "click_ref": "",
            "order_id": "1",
            "click_ip": "58.227.38.245",
            "action_id": 1,
            "status": 0,
            "full_payment": "5000.00",
            "screen": "",
            "action_name": "product1",
            "conversion_time": 2,
            "click_country": null,
            "user_language": "",
            "webmaster": "webmaster1",
            "action_time": "2013-12-10T16:30:52",
            "tracking": "1",
            "closing_date": "2013-12-19",
            "user_agent": "django-test-client",
            "action_ref": "",
            "original_currency": "USD"
        }
    ],
    "_meta": {
        "count": 5,
        "limit": 2,
        "offset": 0
    }
}

Описание полей ответа API-сервера

НазваниеОписание
idAdmitad ID
action_countryСтрана действия
action_idID тарифа
action_ipIP адрес при действии
action_nameТариф
action_refРеферер действия
action_timeВремя действия
click_countryСтрана клика
click_ipIP адрес при клике
click_refРеферер клика
click_timeВремя клика
closing_dateДата применения
conversion_timeВремя конверсии
currencyВалюта партнерской программы (валюта значения в поле full_payment)
full_paymentРасходы общие
order_idID заказа
order_sumСумма заказа
original_currencyВалюта суммы заказа (валюта значения в поле order_sum)
screenРазрешение экрана
statusСтатус
trackingTracking
uidUID посетителя
user_agentБраузер пользователя
user_languageЯзык пользователя
webmasterВеб-мастер
website_idПлощадка
commentКомментарий

Статистика по веб-мастерам

Параметры

HTTP методПрава доступаURLПараметрыПримечание
GETadvertiser_statisticshttps://api.admitad.com/advertiser/{c_id}/statistics/webmasters/offset**Статистические данные по веб-мастерам, где с_id — это идентификатор партнерской программы*.
limit**
start_date***
end_date***
webmasters***
websites***
actions***
groups***
channels***
status***
banners***
order_id***
system_id***
order_by****

* Возвращает результат в формате JSON.

** Задаёт пропуск и количество возвращаемых записей. Например limit=5&offset=2

*** Фильтр по датам, веб-мастерам, площадкам, группам, каналам и тарифам соответственно. Например websites=3&websites=4&groups=8&start_date=01.01.2011&end_date=11.01.2011, где значения - это идентификаторы фильтруемых категорий или фильтруемые данные. Значения для дат должны быть в формате %d.%m.%Y - 01.05.2012.

**** Порядок сортировки. Возможные значения:

  • clicks
  • cr
  • ctr
  • username
  • ecpc
  • ecpm
  • leads_approved
  • leads_declined
  • leads_open
  • new_rate
  • payment_sum_all
  • payment_sum_approved
  • payment_sum_declined
  • payment_sum_open
  • sales_approved
  • sales_declined
  • sales_open
  • views
    Знак '-' перед значением означает обратный порядок. Например, order_by=-clicks&order_by=cr.

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token' -X GET
"https://api.admitad.com/advertiser/1/statistics/webmasters/?limit=2"

Пример ответа API-сервера в формате JSON:

{
    "results": [
        {
            "username": "ngvl",
            "sales_approved": "0"
            "sales_declined": "0",
            "payment_sum_approved": "1072230.00",
            "ctr": 1107992.31,
            "views": 13,
            "currency": "RUB",
            "leads_open": "1343",
            "payment_sum_open": "65260.00",
            "ecpm": 87499230.77,
            "payment_sum_declined": "0.00",
            "cr": 17.0,
            "leads_declined": "0",
            "sales_open": "0",
            "leads_approved": "23146",
            "ecpc": 7.9,
            "clicks": 144039
        },
        {
            "username": "fici",
            "sales_approved": "0",
            "sales_declined": "0",
            "payment_sum_approved": "6648.00",
            "ctr": 0.0,
            "views": 0,
            "currency": "RUB",
            "leads_open": "11",
            "payment_sum_open": "288.00",
            "ecpm": 0.0,
            "payment_sum_declined": "0.00",
            "cr": 3.93,
            "leads_declined": "0",
            "sales_open": "0",
            "leads_approved": "10651",
            "ecpc": 2.45,
            "clicks": 271534
        }
    ],
    "_meta": {
        "count": 1703,
        "limit": 2,
        "offset": 0
    }
}

Описание полей ответа API-сервера

НазваниеОписание
clicksКлики
currencyВалюта
crКонверсия
ctrCTR
usernameВеб-мастер
ecpceCPC
ecpmeCPM
leads_approvedКоличество подтверждённых лидов
leads_declinedКоличество отклоненных лидов
leads_openКоличество открытых лидов
payment_sum_approvedСумма по подтверждённым действиям
payment_sum_declinedСумма по отклоненным действиям
payment_sum_openСумма по открытым действиям
sales_approvedКоличество подтверждённых продаж
sales_declinedКоличество отклоненных продаж
sales_openКоличество открытых продаж
viewsКоличество показов

Статистика по площадкам

Параметры

HTTP методПрава доступаURLПараметрыПримечание
GETadvertiser_statisticshttps://api.admitad.com/advertiser/{c_id}/statistics/websites/offset**Статистические данные по площадкам, где с_id — это идентификатор партнерской программы*.
limit**
start_date***
end_date***
webmasters***
websites***
groups***
channels***
actions***
order_by****

* Возвращает результат в формате JSON.

** Задаёт пропуск и количество возвращаемых записей. Например limit=5&offset=2.

*** Фильтр по датам, веб-мастерам, площадкам, группам, каналам и тарифам соответственно. Например websites=3&websites=4&groups=8&start_date=01.01.2011&end_date=11.01.2011, где значения - это идентификаторы фильтруемых категорий или фильтруемые данные. Значения для дат должны быть в формате %d.%m.%Y - 01.05.2012.

**** Порядок сортировки. Возможные значения:

  • clicks
  • cr
  • ctr
  • website_name
  • ecpc
  • ecpm
  • leads_approved
  • leads_declined
  • leads_open
  • new_rate
  • payment_sum_all
  • payment_sum_approved
  • payment_sum_declined
  • payment_sum_open
  • sales_approved
  • sales_declined
  • sales_open
  • views
    Знак '-' перед значением означает обратный порядок. Например, order_by=-clicks&order_by=cr.

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token' -X GET
"https://api.admitad.com/advertiser/1032/statistics/websites/?limit=2&start_date=29.09.2014&end_date=02.10.2014"

Пример ответа API-сервера в формате JSON:

{
"results": [
        {
            "sales_approved": "0",
            "sales_declined": "0",
            "payment_sum_approved": "0.00",
            "ctr": 0.0,
            "views": 0,
            "currency": "RUB",
            "leads_open": "147",
            "website_name": "",
            "payment_sum_open": "7170.00",
            "ecpm": 0.0,
            "payment_sum_declined": "0.00",
            "cr": 14.08,
            "leads_declined": "0",
            "sales_open": "0",
            "leads_approved": "0",
            "ecpc": 6.87,
            "clicks": 1044
        },
        {
            "sales_approved": "0",
            "sales_declined": "0",
            "payment_sum_approved": "0.00",
            "ctr": 0.0,
            "views": 0,
            "currency": "RUB",
            "leads_open": "110",
            "website_name": "",
            "payment_sum_open": "6072.00",
            "ecpm": 0.0,
            "payment_sum_declined": "0.00",
            "cr": 0.81,
            "leads_declined": "0",
            "sales_open": "0",
            "leads_approved": "0",
            "ecpc": 0.45,
            "clicks": 13532
        }
    ],
    "_meta": {
        "count": 123,
        "limit": 2,
        "offset": 0
    }
}

Описание полей ответа API-сервера

НазваниеОписание
clicksКлики
currencyВалюта
crКонверсия
ctrCTR
website_nameПлощадка
ecpceCPC
ecpmeCPM
leads_approvedКоличество подтверждённых
leads_declinedКоличество отклоненных лидов
leads_openКоличество открытых лидов
payment_sum_approvedСумма по подтверждённым действиям
payment_sum_declinedСумма по отклоненным действиям
payment_sum_openСумма по открытым действиям
sales_approvedКоличество подтверждённых продаж
sales_declinedКоличество отклоненных продаж
sales_openКоличество открытых продаж
viewsКоличество показов

Статистика по баннерам

Параметры

HTTP методПрава доступаURLПараметрыПримечание
GETadvertiser_statisticshttps://api.admitad.com/advertiser/{c_id}/statistics/banners/offset**Статистические данные по баннерам, где с_id — это идентификатор партнерской программы*.
limit**
start_date***
end_date***
webmasters***
websites***
groups***
channels***
landings***
order_by****

* Возвращает результат в формате JSON.

** Задаёт пропуск и количество возвращаемых записей. Например limit=5&offset=2.

*** Фильтр по датам, веб-мастерам, площадкам, группам, каналам и лендингам соответственно. Например websites=3&websites=4&groups=8&start_date=01.01.2011&end_date=11.01.2011, где значения - это идентификаторы фильтруемых категорий или фильтруемые данные. Значения для дат должны быть в формате %d.%m.%Y - 01.05.2012.

**** Порядок сортировки. Возможные значения:

  • clicks
  • cr
  • ctr
  • banner_name
  • ecpc
  • ecpm
  • leads_approved
  • leads_declined
  • leads_open
  • new_rate
  • payment_sum_all
  • payment_sum_approved
  • payment_sum_declined
  • payment_sum_open
  • sales_approved
  • sales_declined
  • sales_open
  • views
    Знак '-' перед значением означает обратный порядок. Например, order_by=-clicks&order_by=cr.

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token' -X GET
"https://api.admitad.com/advertiser/1/statistics/banners/?limit=2"

Пример ответа API-сервера в формате JSON:

{
    "results": [
        {
            "sales_approved": "0",
            "sales_declined": "0",
            "payment_sum_approved": "0.00",
            "ctr": 36.65,
            "views": 2927,
            "currency": "RUB",
            "leads_open": "155",
            "banner_name": "130x600_banner",
            "payment_sum_open": "7178.00",
            "ecpm": 2528.91,
            "payment_sum_declined": "0.00",
            "cr": 23.56,
            "leads_declined": "0",
            "sales_open": "0",
            "leads_approved": "0",
            "ecpc": 6.14,
            "clicks": 3143
        },
        {
            "sales_approved": "0",
            "sales_declined": "0",
            "payment_sum_approved": "0.00",
            "ctr": 0.0,
            "views": 0,
            "currency": "RUB",
            "leads_open": "120",
            "banner_name": "Default link",
            "payment_sum_open": "6568.00",
            "ecpm": 0.0,
            "payment_sum_declined": "0.00",
            "cr": 0.88,
            "leads_declined": "0",
            "sales_open": "0",
            "leads_approved": "0",
            "ecpc": 0.48,
            "clicks": 13661
        }
    ],
    "_meta": 
        "count": 134,
        "limit": 2,
        "offset": 0
    }
}

Описание полей ответа API-сервера

НазваниеОписание
clicksКлики
currencyВалюта
crКонверсия
ctrCTR
banner_nameБаннер
ecpceCPC
ecpmeCPM
leads_approvedКоличество подтверждённых лидов
leads_declinedКоличество отклоненных лидов
leads_openКоличество открытых лидов
payment_sum_approvedСумма по подтверждённым действиям
payment_sum_declinedСумма по отклоненным действиям
payment_sum_openСумма по открытым действиям
sales_approvedКоличество подтверждённых продаж
sales_declinedКоличество отклоненных продаж
sales_openКоличество открытых продаж
viewsКоличество показов

Статистика по лендингам

Параметры

HTTP методПрава доступаURLПараметрыПримечание
GETadvertiser_statisticshttps://api.admitad.com/advertiser/{c_id}/statistics/landings/offset**Статистические данные по лендингам, где с_id — это идентификатор партнерской программы*
limit**
start_date***
end_date***
webmasters***
websites***
groups***
channels***
order_by****

* Возвращает результат в формате JSON.

** Задаёт пропуск и количество возвращаемых записей. Например limit=5&offset=2.

*** Фильтр по датам, веб-мастерам, площадкам, группам, каналам и тарифам соответственно. Например websites=3&websites=4&groups=8&start_date=01.01.2011&end_date=11.01.2011, где значения - это идентификаторы фильтруемых категорий или фильтруемые данные. Значения для дат должны быть в формате %d.%m.%Y - 01.05.2012.

**** Порядок сортировки. Возможные значения:

  • clicks
  • cr
  • ctr
  • ecpc
  • ecpm
  • leads_approved
  • leads_declined
  • leads_open
  • new_rate
  • payment_sum_all
  • payment_sum_approved
  • payment_sum_declined
  • payment_sum_open
  • sales_approved
  • sales_declined
  • sales_open
  • views
    Знак '-' перед значением означает обратный порядок. Например, order_by=-clicks&order_by=cr.

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token' -X GET
"https://api.admitad.com/advertiser/1/statistics/landings/?limit=2"

Пример ответа API-сервера в формате JSON:

{
    "results": [
        {
            "sales_approved": "0",
            "sales_declined": "0",
            "payment_sum_approved": "0.00",
            "ctr": 36.65,
            "views": 2927,
            "landing_id": 22,
            "landing_url": "http://yoursite.tld/nsJKFmf?iewe=265&admitad_uid={{admitad_uid}}",
            "currency": "RUB",
            "leads_open": "155",
            "landing_name": "Melena",
            "payment_sum_open": "7178.00",
            "ecpm": 2528.91,
            "payment_sum_declined": "0.00",
            "cr": 23.56,
            "leads_declined": "0",
            "sales_open": "0",
            "leads_approved": "0",
            "ecpc": 6.14,
            "clicks": 3143
        },
        {
            "sales_approved": "0",
            "sales_declined": "0",
            "payment_sum_approved": "0.00",
            "ctr": 0.0,
            "views": 0,
            "landing_id": 45,
            "landing_url": "http://yoursite.tld/P7UVerZh?iewe=231&admitad_uid={{admitad_uid}}",
            "currency": "RUB",
            "leads_open": "120",
            "landing_name": "Default landing",
            "payment_sum_open": "6568.00",
            "ecpm": 0.0,
            "payment_sum_declined": "0.00",
            "cr": 0.88,
            "leads_declined": "0",
            "sales_open": "0",
            "leads_approved": "0",
            "ecpc": 0.48,
            "clicks": 13661
        }
    ],
    "_meta": {
        "count": 134,
        "limit": 2,
        "offset": 0
    }
}

Описание полей ответа API-сервера

НазваниеОписание
clicksКлики
currencyВалюта
crКонверсия
ctrCTR
landing_idID лендинга
landing_nameЛендинг
landing_urlСсылка для перехода
ecpceCPC
ecpmeCPM
leads_approvedКоличество подтверждённых лидов
leads_declinedКоличество отклоненных лидов
leads_openКоличество открытых лидов
payment_sum_approvedСумма по подтверждённым действиям
payment_sum_declinedСумма по отклоненным действиям
payment_sum_openСумма по открытым действиям
sales_approvedКоличество подтверждённых продаж
sales_declinedКоличество отклоненных продаж
sales_openКоличество открытых продаж
viewsКоличество показов

Статистика по лендингам и площадкам

Параметры

HTTP методПрава доступаURLПараметрыПримечание
GETadvertiser_statisticshttps://api.admitad.com/advertiser/{c_id}/statistics/landingwebsites/offset**Статистические данные по лендингам и площадкам, где с_id — это идентификатор партнерской программы*
limit**
start_date***
end_date***
webmasters***
websites***
groups***
channels***
order_by****

* Возвращает результат в формате JSON.

** Задаёт пропуск и количество возвращаемых записей. Например limit=5&offset=2.

*** Фильтр по датам, веб-мастерам, площадкам, группам, каналам и тарифам соответственно. Например websites=3&websites=4&groups=8&start_date=01.01.2011&end_date=11.01.2011, где значения - это идентификаторы фильтруемых категорий или фильтруемые данные. Значения для дат должны быть в формате %d.%m.%Y - 01.05.2012.

**** Порядок сортировки. Возможные значения:

  • clicks
  • cr
  • ctr
  • ecpc
  • ecpm
  • leads_approved
  • leads_declined
  • leads_open
  • new_rate
  • payment_sum_all
  • payment_sum_approved
  • payment_sum_declined
  • payment_sum_open
  • sales_approved
  • sales_declined
  • sales_open
  • views
    Знак '-' перед значением означает обратный порядок. Например, order_by=-clicks&order_by=cr.

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token' -X GET
"https://api.admitad.com/advertiser/1/statistics/landingwebsites/?limit=2"

Пример ответа API-сервера в формате JSON:

{
    "results": [
        {
            "sales_approved": "0",
            "sales_declined": "0",
            "payment_sum_approved": "0.00",
            "ctr": 36.65,
            "views": 2927,
            "website_id": 943,
            "website_name": 'Blabla website',
            "landing_id": 45,
            "landing_name": 'Bla landing',
            "landing_url": "http://yoursite.tld/nsJKFmf?iewe=265&admitad_uid={{admitad_uid}}",
            "currency": "RUB",
            "leads_open": "155",
            "landing_name": "Melena",
            "payment_sum_open": "7178.00",
            "ecpm": 2528.91,
            "payment_sum_declined": "0.00",
            "cr": 23.56,
            "leads_declined": "0",
            "sales_open": "0",
            "leads_approved": "0",
            "ecpc": 6.14,
            "clicks": 3143
        },
        {
            "sales_approved": "0",
            "sales_declined": "0",
            "payment_sum_approved": "0.00",
            "ctr": 0.0,
            "views": 0,
            "website_id": 23,
            "website_name": 'Blablabla',
            "landing_id": 13,
            "landing_name": 'Blablabla landing',
            "landing_url": "http://yoursite.tld/P7UVerZh?iewe=231&admitad_uid={{admitad_uid}}",
            "currency": "RUB",
            "leads_open": "120",
            "landing_name": "Default landing",
            "payment_sum_open": "6568.00",
            "ecpm": 0.0,
            "payment_sum_declined": "0.00",
            "cr": 0.88,
            "leads_declined": "0",
            "sales_open": "0",
            "leads_approved": "0",
            "ecpc": 0.48,
            "clicks": 13661
        }
    ],
    "_meta": {
        "count": 134,
        "limit": 2,
        "offset": 0
    }
}

Описание полей ответа API-сервера

НазваниеОписание
clicksКлики
currencyВалюта
crКонверсия
ctrCTR
landing_idID лендинга
landing_nameЛендинг
landing_urlСсылка для перехода
website_idID площадки
website_nameПлощадка
ecpceCPC
ecpmeCPM
leads_approvedКоличество подтверждённых лидов
leads_declinedКоличество отклоненных лидов
leads_openКоличество открытых лидов
payment_sum_approvedСумма по подтверждённым действиям
payment_sum_declinedСумма по отклоненным действиям
payment_sum_openСумма по открытым действиям
sales_approvedКоличество подтверждённых продаж
sales_declinedКоличество отклоненных продаж
sales_openКоличество открытых продаж
viewsКоличество показов

Статистика по каналам

Параметры

HTTP методПрава доступаURLПараметрыПримечание
GETadvertiser_statisticshttps://api.admitad.com/advertiser/{c_id}/statistics/channels/offset**Статистические данные по каналам, где с_id — это идентификатор партнерской программы*
limit**
start_date***
end_date***
webmasters***
websites***
groups***
channels***
actions***
order_by****

* Возвращает результат в формате JSON.

** Задаёт пропуск и количество возвращаемых записей. Например limit=5&offset=2.

*** Фильтр по датам, веб-мастерам, площадкам, группам, каналам и тарифам соответственно. Например websites=3&websites=4&groups=8&start_date=01.01.2011&end_date=11.01.2011, где значения - это идентификаторы фильтруемых категорий или фильтруемые данные. Значения для дат должны быть в формате %d.%m.%Y - 01.05.2012.

**** Порядок сортировки. Возможные значения:

  • clicks
  • cr
  • ctr
  • channel_name
  • ecpc
  • ecpm
  • leads_approved
  • leads_declined
  • leads_open
  • new_rate
  • payment_sum_all
  • payment_sum_approved
  • payment_sum_declined
  • payment_sum_open
  • sales_approved
  • sales_declined
  • sales_open
  • views
    Знак '-' перед значением означает обратный порядок. Например, order_by=-clicks&order_by=cr.

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token' -X GET
"https://api.admitad.com/advertiser/1/statistics/channels/?limit=2"

Пример ответа API-сервера в формате JSON:

{
    "results": [
        {
            "sales_approved": "0",
            "sales_declined": "0",
            "payment_sum_approved": "0.00",
            "ctr": 10.04,
            "views": 11885,
            "currency": "RUB",
            "leads_open": "153",
            "payment_sum_open": "7450.00",
            "ecpm": 626.84,
            "payment_sum_declined": "0.00",
            "cr": 12.82,
            "leads_declined": "0",
            "sales_open": "0",
            "leads_approved": "0",
            "ecpc": 6.24,
            "clicks": 1193,
            "channel_name": "Program eDarling"
        },
        {
            "sales_approved": "0",
            "sales_declined": "0",
            "payment_sum_approved": "0.00",
            "ctr": 0.0,
            "views": 0,
            "currency": "RUB",
            "leads_open": "4",
            "payment_sum_open": "56.00",
            "ecpm": 0.0,
            "payment_sum_declined": "0.00",
            "cr": 15.38,
            "leads_declined": "0",
            "sales_open": "0",
            "leads_approved": "0",
            "ecpc": 2.15,
            "clicks": 26,
            "channel_name": "zavhoz - planbmedia"
        }
    ],
    "_meta": {
        "count": 435,
        "limit": 2,
        "offset": 0
    }
}

Описание полей ответа API-сервера

НазваниеОписание
clicksКлики
currencyВалюта
crКонверсия
ctrCTR
channel_nameКанал
ecpceCPC
ecpmeCPM
leads_approvedКоличество подтверждённых лидов
leads_declinedКоличество отклоненных лидов
leads_openКоличество открытых лидов
payment_sum_approvedСумма по подтверждённым действиям
payment_sum_declinedСумма по отклоненным действиям
payment_sum_openСумма по открытым действиям
sales_approvedКоличество подтверждённых продаж
sales_declinedКоличество отклоненных продаж
sales_openКоличество открытых продаж
viewsКоличество показов

Статистика по группам

Параметра

HTTP методПрава доступаURLПараметрыПримечание
GETadvertiser_statisticshttps://api.admitad.com/advertiser/{c_id}/statistics/groups/offset**Статистические данные по группам, где с_id — это идентификатор партнерской программы*
limit**
start_date***
end_date***
webmasters***
websites***
groups***
channels***
order_by****

* Возвращает результат в формате JSON.

** Задаёт пропуск и количество возвращаемых записей. Например limit=5&offset=2.

*** Фильтр по датам, веб-мастерам, площадкам, группам, каналам и тарифам соответственно. Например websites=3&websites=4&groups=8&start_date=01.01.2011&end_date=11.01.2011, где значения - это идентификаторы фильтруемых категорий или фильтруемые данные. Значения для дат должны быть в формате %d.%m.%Y - 01.05.2012.

**** Порядок сортировки. Возможные значения:

  • clicks
  • cr
  • ctr
  • group_name
  • ecpc
  • ecpm
  • leads_approved
  • leads_declined
  • leads_open
  • new_rate
  • payment_sum_all
  • payment_sum_approved
  • payment_sum_declined
  • payment_sum_open
  • sales_approved
  • sales_declined
  • sales_open
  • views
    Знак '-' перед значением означает обратный порядок. Например, order_by=-clicks&order_by=cr.

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token' -X GET
"https://api.admitad.com/advertiser/1/statistics/groups/?limit=2&start_date=01.01.2014&end_date=02.10.2014"

Пример ответа API-сервера в формате JSON:

{
    "results": [
        {
            "sales_approved": "0",
            "sales_declined": "0",
            "payment_sum_approved": "0.00",
            "ctr": 10.04,
            "views": 11885,
            "currency": "RUB",
            "leads_open": "153",
            "payment_sum_open": "7450.00",
            "ecpm": 626.84,
            "payment_sum_declined": "0.00",
            "cr": 12.82,
            "leads_declined": "0",
            "sales_open": "0",
            "leads_approved": "0",
            "ecpc": 6.24,
            "clicks": 1193
        },
        {
            "sales_approved": "0",
            "sales_declined": "0",
            "payment_sum_approved": "0.00",
            "ctr": 0.0,
            "views": 0,
            "currency": "RUB",
            "leads_open": "2",
            "payment_sum_open": "52.00",
            "ecpm": 0.0,
            "payment_sum_declined": "0.00",
            "cr": 5.38,
            "leads_declined": "0",
            "sales_open": "0",
            "leads_approved": "0",
            "ecpc": 2.51,
            "clicks": 36
        }
    ],
    "_meta": {
        "count": 123,
        "limit": 2,
        "offset": 0
    }
}

Описание полей ответа API-сервера

НазваниеОписание
clicksКлики
currencyВалюта
crКонверсия
ctrCTR
group_nameГруппа
ecpceCPC
ecpmeCPM
leads_approvedКоличество подтверждённых лидов
leads_declinedКоличество отклоненных лидов
leads_openКоличество открытых лидов
payment_sum_approvedСумма по подтверждённым действиям
payment_sum_declinedСумма по отклоненным действиям
payment_sum_openСумма по открытым действиям
sales_approvedКоличество подтверждённых продаж
sales_declinedКоличество отклоненных продаж
sales_openКоличество открытых продаж
viewsКоличество показов