Sections in this category

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

  • Обновлено

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

Параметры

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": ""

        },

        {

            "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": ""

        }

    ],

    "_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 Расходы общие
order_id ID заказа
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 Количество показов

Была ли эта статья полезной?

Пользователи, считающие этот материал полезным: 1 из 2