Статистика по каналам

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET advertiser_statistics https://api.admitad.com/advertiser/{c_id}/statistics/channels/
  • 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
    • 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 Количество показов