Статистика по действиям

Параметры

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 Комментарий