Статистика по времени
Параметры
HTTP метод | Права доступа | URL | Параметры | Примечание |
---|---|---|---|---|
GET | advertiser_statistics | https://api.admitad.com/ |
|
Статистические данные по времени, где с_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/ |
|
Статистические данные по действиям, где с_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/ |
|
Статистические данные по веб-мастерам, где с_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/ |
|
Статистические данные по площадкам, где с_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/ |
|
Статистические данные по баннерам, где с_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/ |
|
Статистические данные по лендингам, где с_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/ |
|
Статистические данные по лендингам и площадкам, где с_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/ |
|
Статистические данные по каналам, где с_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/ |
|
Статистические данные по группам, где с_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 | Количество показов |