Статистика по веб-мастерам

Параметры

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 Количество показов