Статистика по месяцам¶

Параметры¶

HTTP метод	Права доступа	URL	Параметры	Примечание
GET	statistics	`https://api.admitad.com/statistics/months/`	offset limit date_start * date_end * website * campaign * subid * total order_by ***	Статистические данные по месяцам.*

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

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

*** Фильтр по датам, площадкам, партнерским программам и SubID соответственно. Например campaign=3&campaign=4&website=8&date_start=01.01.2011, где значения — это идентификаторы фильтруемых категорий или фильтруемые данные. Значения для дат должны быть в формате ‘%d.%m.%Y’ - ‘01.05.2012’.

**** Параметр, позволяющий получить агрегированные данные по всему запросу. Возможные значения: 1/0 - агрегированные данные/не агрегированный результат

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

action

clicks

cr

ctr

date

ecpc

ecpm

leads

payment_sum

payment_sum_approved

payment_sum_declined

payment_sum_open

sales

views

Знак ‘-‘ перед значением означает обратный порядок. Например order_by=-clicks&order_by=cr.

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

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

curl -L -H 'Authorization: Bearer access_token' -X GET https://api.admitad.com/statistics/months/?date_start=01.01.2011&limit=2&order_by=date&offset=1

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

{
    "results": [
        {
            "leads_sum": 0,
            "ctr": 0.001,
            "views": 5153,
            "payment_sum_declined": 0.0,
            "clicks": 5,
            "payment_sum_approved": -1254.81,
            "currency": "RUB",
            "ecpm": 1731.626237,
            "sales_sum": 6,
            "date": "2011-02",
            "cr": 1.2,
            "ecpc": 1784.614,
            "payment_sum_open": 10177.88
        },
        {
            "leads_sum": 1,
            "ctr": 9.0,
            "views": 1,
            "payment_sum_declined": 0.0,
            "clicks": 9,
            "payment_sum_approved": 100.0,
            "currency": "RUB",
            "ecpm": 1887020.0,
            "sales_sum": 2,
            "date": "2011-03",
            "cr": 0.5556,
            "ecpc": 209.668889,
            "payment_sum_open": 1787.02
        }
    ],
    "_meta": {
        "count": 15,
        "limit": 2,
        "offset": 1
    }
}

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

curl -L -H 'Authorization: Bearer access_token' -X GET https://api.admitad.com/statistics/months/?date_start=01.01.2011&limit=2&order_by=date&offset=1&total=1

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

[
    {
        "leads_sum": 21594304,
        "payment_sum": 3382089.02,
        "views": 7337610,
        "payment_sum_declined": 1705783.09,
        "actions_sum_total": 22023257,
        "payment_sum_approved": 1646173.57,
        "currency": "RUB",
        "sales_sum": 21694727,
        "payment_sum_open": 1735915.45,
        "clicks": 7064253
    }
]

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

Название	Описание
date	Дата статистики
currency	Системные валюты
leads_sum	Количество лидов
sales_sum	Количество продаж
payment_sum_declined	Сумма по отклоненным действиям
payment_sum_approved	Сумма по подтверждённым действиям
payment_sum_open	Сумма по открытым действиям
views	Количество показов
clicks	Количество кликов
ctr	CTR
ecpc	eCPC
cr	Конверсия
ecpm	eCPM