Статистика по дням

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET statistics https://api.admitad.com/statistics/dates/
  • 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/dates/?date_start=01.01.2011&limit=2&order_by=date&offset=1

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

{
    "results": [
        {
            "leads_sum": 0,
            "ctr": 0.0,
            "views": 0,
            "payment_sum_declined": 0.0,
            "clicks": 2,
            "payment_sum_approved": -1254.81,
            "currency": "RUB",
            "ecpm": 0.0,
            "sales_sum": 4,
            "sales_sum_approved": 1,
            "sales_sum_open": 1,
            "sales_sum_declined": 2,
            "leads_sum_approved": 1,
            "leads_sum_open": 2,
            "leads_sum_declined": 0,
            "date": "2011-02-24",
            "cr": 0.0,
            "ecpc": 2509.615,
            "payment_sum_open": 6274.04
        },
        {
            "leads_sum": 12,
            "ctr": 7.0,
            "views": 1,
            "payment_sum_declined": 0.0,
            "clicks": 7,
            "payment_sum_approved": 0.0,
            "currency": "RUB",
            "ecpm": 4350000.0,
            "sales_sum": 0,
            "sales_sum_approved": 0,
            "sales_sum_open": 0,
            "sales_sum_declined": 0,
            "leads_sum_approved": 0,
            "leads_sum_open": 0,
            "leads_sum_declined": 0,
            "date": "2011-07-19",
            "cr": 1.7143,
            "ecpc": 621.428571,
            "payment_sum_open": 4350.0
        }
    ],
    "_meta": {
        "count": 58,
        "limit": 2,
        "offset": 1
    }
}

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

curl -L -H 'Authorization: Bearer access_token' -X GET https://api.admitad.com/statistics/dates/?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 Сумма по открытым действиям
sales_sum_approved Количество подтверждённых продаж
sales_sum_open Количество открытых продаж
sales_sum_declined Количество отклоненных продаж
leads_sum_approved Количество подтверждённых лидов
leads_sum_open Количество открытых лидов
leads_sum_declined Количество отклоненных лидов
views Количество показов
clicks Количество кликов
ctr CTR
ecpc eCPC
cr Конверсия
ecpm eCPM