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",
"payment_webmaster": "5000.00",
"click_ip": "58.227.38.245",
"action_id": 1,
"status": 0,
"full_payment": "5000.00",
"screen": "",
"action_name": "product1",
"payment_system": "0.00",
"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",
"payment_webmaster": "5000.00",
"click_ip": "58.227.38.245",
"action_id": 1,
"status": 0,
"full_payment": "5000.00",
"screen": "",
"action_name": "product1",
"payment_system": "0.00",
"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 Сумма заказа
payment_system Расходы на систему
payment_webmaster Расходы на веб-мастеров
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 Количество показов

Статистика по офлайн-заказам

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET advertiser_statistics https://api.admitad.com/
advertiser/{c_id}/
statistics/offline/
  • 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.
  • **** Порядок сортировки. Возможные значения:
    • datetime
    • id

    Знак '-' перед значением означает обратный порядок. Например, order_by=-datetime

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

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

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

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

{
"_meta": {
"count": 18,
"limit": 1,
"offset": 0
},
"results": [
{
"action_time": "2018-10-13T19:18:00",
"activation_time": "",
"ad_space": "example.com",
"admitad_id": 242711970,
"check_amount": 392.2,
"comment": "2310031475",
"conversion_time": "",
"cost_for_publishers": "16.66",
"cost_for_the_system": "5.00",
"date_processed": "2018-10-13T19:10:13",
"duplication": 1,
"fiscal_drive": 8710000101718961,
"fiscal_document": 40080,
"general_exprenses": "21.66",
"offline_deal_id": 76,
"offline_deal_name": "Пакет Магнит",
"order_amount": "333.20",
"order_id": "8710000101718968_118362_76",
"positions": [
{
"amount": "3.00",
"match": true,
"name": "Пакет Магнит Косметик мал(Пластиктре",
"price": "3.00",
"quantity": "1.00"
},
{
"amount": "85.00",
"match": false,
"name": "Корзинка унив прямоуг 27,5*18*14,3см",
"price": "85.00",
"quantity": "1.00"
},
{
"amount": "99.00",
"match": false,
"name": "BREF Сила Актив Туал Блок Лимонная С",
"price": "99.00",
"quantity": "1.00"
},
{
"amount": "87.20",
"match": false,
"name": "SPLAT Juicy Дет з/п укр МОРОЖЕНОЕ(Ор",
"price": "87.20",
"quantity": "1.00"
},
{
"amount": "118.00",
"match": false,
"name": "Вешалка дер с антиск перекл натур(СИ",
"price": "59.00",
"quantity": "2.00"
}
],
"publisher": "publisher",
"status": "pending",
"store_address": "603144, Нижегородская обл, Нижний Новгород г, Пушкина ул, дом 1",
"store_name": "ООО Admitad",
"store_tax_number": "2311131475"
}
]
}

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

Название Описание
admitad_id ID заказа в Admitad
activation_time Время активации акции пользователем
action_time Время печати чека
conversion_time Время конверсии
ad_space Площадка веб-мастера
publisher Логин веб-мастера
offline_deal_id ID офлайн-акции
offline_deal_name Наименование офлайн-акции, по которой зафиксировано действие
order_id ID заказа
order_amount Сумма заказа
status Статус заказа
date_processed Дата обработки заказа
cost_for_publishers Расходы на комиссию веб-мастера
cost_for_the_system Расходы на комиссию Admitad
general_expenses Общие расходы
comment Коментарий к заказу
duplication Признак того, что QR-код уже запрашивался другим сервисом: 1 - запрашивался. 0 - не запрашивался.
store_name Название юридического лица магазина, в котором совершена покупка
store_address Фактический адрес магазина
store_tax_number ИНН магазина
check_amount Сумма всего чека
fiscal_drive Номер фискального накопителя (ФН)
fiscal_document Номер фискального документа (ФД)

Описание полей позиций заказов

Название Описание
name Наименование товара
price Цена за единицу товара
quantity Количество единиц товара
amount Стоимость позиции товара (price * quantity)
match Признак срабатывания акции на товар

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

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