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

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

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET advertiser_statistics https://api.admitad.com/advertiser/{c_id}/statistics/dates/
  • offset**
  • limit**
  • start_date***
  • end_date***
  • webmasters***
  • websites***
  • groups***
  • channels***
  • banners***
  • landings***
  • order_by****
Статистические данные по времени, где с_id — это идентификатор партнерской программы*.
  • * Возвращает результат в формате 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 Конверсия
ctr CTR
date Дата статистики
ecpc eCPC
ecpm eCPM
leads_approved Количество подтверждённых лидов
leads_declined Количество отклоненных лидов
leads_open Количество открытых лидов
payment_sum_approved Сумма по подтверждённым действиям
payment_sum_declined Сумма по отклоненным действиям
payment_sum_open Сумма по открытым действиям
sales_approved Количество подтверждённых продаж
sales_declined Количество отклоненных продаж
sales_open Количество открытых продаж
views Количество показов

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

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET advertiser_statistics https://api.admitad.com/advertiser/{c_id}/statistics/actions/
  • offset**
  • limit**
  • start_date***
  • end_date***
  • webmasters***
  • websites***
  • actions***
  • groups***
  • channels***
  • status***
  • banners***
  • order_id***
  • system_id***
  • order_by****
Статистические данные по действиям, где с_id — это идентификатор партнерской программы*.
  • * Возвращает результат в формате 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-сервера

Название Описание
id Admitad ID
action_country Страна действия
action_id ID тарифа
action_ip IP адрес при действии
action_name Тариф
action_ref Реферер действия
action_time Время действия
click_country Страна клика
click_ip IP адрес при клике
click_ref Реферер клика
click_time Время клика
closing_date Дата применения
conversion_time Время конверсии
currency Валюта партнерской программы (валюта значения в поле full_payment)
full_payment Расходы общие
order_id ID заказа
order_sum Сумма заказа
original_currency Валюта суммы заказа (валюта значения в поле order_sum)
screen Разрешение экрана
status Статус
tracking Tracking
uid UID посетителя
user_agent Браузер пользователя
user_language Язык пользователя
webmaster Веб-мастер
website_id Площадка
comment Комментарий

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

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET advertiser_statistics https://api.admitad.com/advertiser/{c_id}/statistics/webmasters/
  • offset**
  • limit**
  • start_date***
  • end_date***
  • webmasters***
  • websites***
  • groups***
  • channels***
  • actions***
  • order_by****
Статистические данные по веб-мастерам, где с_id — это идентификатор партнерской программы*.
  • * Возвращает результат в формате 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 Конверсия
ctr CTR
username Веб-мастер
ecpc eCPC
ecpm eCPM
leads_approved Количество подтверждённых лидов
leads_declined Количество отклоненных лидов
leads_open Количество открытых лидов
payment_sum_approved Сумма по подтверждённым действиям
payment_sum_declined Сумма по отклоненным действиям
payment_sum_open Сумма по открытым действиям
sales_approved Количество подтверждённых продаж
sales_declined Количество отклоненных продаж
sales_open Количество открытых продаж
views Количество показов

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

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET advertiser_statistics https://api.admitad.com/advertiser/{c_id}/statistics/websites/
  • offset**
  • limit**
  • start_date***
  • end_date***
  • webmasters***
  • websites***
  • groups***
  • channels***
  • actions***
  • order_by****
Статистические данные по площадкам, где с_id — это идентификатор партнерской программы*.
  • * Возвращает результат в формате 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 Конверсия
ctr CTR
website_name Площадка
ecpc eCPC
ecpm eCPM
leads_approved Количество подтверждённых
leads_declined Количество отклоненных лидов
leads_open Количество открытых лидов
payment_sum_approved Сумма по подтверждённым действиям
payment_sum_declined Сумма по отклоненным действиям
payment_sum_open Сумма по открытым действиям
sales_approved Количество подтверждённых продаж
sales_declined Количество отклоненных продаж
sales_open Количество открытых продаж
views Количество показов

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

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET advertiser_statistics https://api.admitad.com/advertiser/{c_id}/statistics/banners/
  • offset**
  • limit**
  • start_date***
  • end_date***
  • webmasters***
  • websites***
  • groups***
  • channels***
  • landings***
  • order_by****
Статистические данные по баннерам, где с_id — это идентификатор партнерской программы*.
  • * Возвращает результат в формате 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 Конверсия
ctr CTR
banner_name Баннер
ecpc eCPC
ecpm eCPM
leads_approved Количество подтверждённых лидов
leads_declined Количество отклоненных лидов
leads_open Количество открытых лидов
payment_sum_approved Сумма по подтверждённым действиям
payment_sum_declined Сумма по отклоненным действиям
payment_sum_open Сумма по открытым действиям
sales_approved Количество подтверждённых продаж
sales_declined Количество отклоненных продаж
sales_open Количество открытых продаж
views Количество показов

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

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET advertiser_statistics https://api.admitad.com/advertiser/{c_id}/statistics/landings/
  • offset**
  • limit**
  • start_date***
  • end_date***
  • webmasters***
  • websites***
  • groups***
  • channels***
  • order_by****
Статистические данные по лендингам, где с_id — это идентификатор партнерской программы*.
  • * Возвращает результат в формате 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 Конверсия
ctr CTR
landing_id ID лендинга
landing_name Лендинг
landing_url Ссылка для перехода
ecpc eCPC
ecpm eCPM
leads_approved Количество подтверждённых лидов
leads_declined Количество отклоненных лидов
leads_open Количество открытых лидов
payment_sum_approved Сумма по подтверждённым действиям
payment_sum_declined Сумма по отклоненным действиям
payment_sum_open Сумма по открытым действиям
sales_approved Количество подтверждённых продаж
sales_declined Количество отклоненных продаж
sales_open Количество открытых продаж
views Количество показов

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

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET advertiser_statistics https://api.admitad.com/advertiser/{c_id}/statistics/landingwebsites/
  • offset**
  • limit**
  • start_date***
  • end_date***
  • webmasters***
  • websites***
  • groups***
  • channels***
  • order_by****
Статистические данные по лендингам и площадкам, где с_id — это идентификатор партнерской программы*.
  • * Возвращает результат в формате 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 Конверсия
ctr CTR
landing_id ID лендинга
landing_name Лендинг
landing_url Ссылка для перехода
website_id ID площадки
website_name Площадка
ecpc eCPC
ecpm eCPM
leads_approved Количество подтверждённых лидов
leads_declined Количество отклоненных лидов
leads_open Количество открытых лидов
payment_sum_approved Сумма по подтверждённым действиям
payment_sum_declined Сумма по отклоненным действиям
payment_sum_open Сумма по открытым действиям
sales_approved Количество подтверждённых продаж
sales_declined Количество отклоненных продаж
sales_open Количество открытых продаж
views Количество показов

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

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET advertiser_statistics https://api.admitad.com/advertiser/{c_id}/statistics/channels/
  • offset**
  • limit**
  • start_date***
  • end_date***
  • webmasters***
  • websites***
  • groups***
  • channels***
  • actions***
  • order_by****
Статистические данные по каналам, где с_id — это идентификатор партнерской программы*.
  • * Возвращает результат в формате 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 Конверсия
ctr CTR
channel_name Канал
ecpc eCPC
ecpm eCPM
leads_approved Количество подтверждённых лидов
leads_declined Количество отклоненных лидов
leads_open Количество открытых лидов
payment_sum_approved Сумма по подтверждённым действиям
payment_sum_declined Сумма по отклоненным действиям
payment_sum_open Сумма по открытым действиям
sales_approved Количество подтверждённых продаж
sales_declined Количество отклоненных продаж
sales_open Количество открытых продаж
views Количество показов

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

Параметра

HTTP метод Права доступа URL Параметры Примечание
GET advertiser_statistics https://api.admitad.com/advertiser/{c_id}/statistics/groups/
  • offset**
  • limit**
  • start_date***
  • end_date***
  • webmasters***
  • websites***
  • groups***
  • channels***
  • order_by****
Статистические данные по группам, где с_id — это идентификатор партнерской программы*.
  • * Возвращает результат в формате 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 Конверсия
ctr CTR
group_name Группа
ecpc eCPC
ecpm eCPM
leads_approved Количество подтверждённых лидов
leads_declined Количество отклоненных лидов
leads_open Количество открытых лидов
payment_sum_approved Сумма по подтверждённым действиям
payment_sum_declined Сумма по отклоненным действиям
payment_sum_open Сумма по открытым действиям
sales_approved Количество подтверждённых продаж
sales_declined Количество отклоненных продаж
sales_open Количество открытых продаж
views Количество показов