Получение отчетов

Данный метод выгружает статистику из K50 Трекера по заданным параметрам.

Адрес для отправки запроса

https://api.tracker.k50.ru/api/counter/reports

Метод: GET

Параметры запроса

Параметр Значение
apiKey Токен для авторизации. Подробнее
counterId id счетчика, с которого будем снимать статистику. Список доступных счетчиков можно получить с помощью метода
dimensions Массив измерений, которые следует выгрузить
metrics Массив метрик, который следует выгрузить
period Объект, в котором передаётся интервал дат. Формат объекта
limit Максимальное количество результатов в ответе
offset Начальная позиция элемента в ответе. По умолчанию 0
orderBy Объект, в котором передаётся информация о сортировке. Формат объекта {'param':'sortType'}.param - параметр, по которому следует сортировать данные.sortType - тип сортировки, возможные значения: desc- по убыванию, asc - по возрастанию

Синтаксис фильтра

Массив из объектов-фильтров, применяемых на данные. Формат объекта:

{"attribute":attribute,"operator":operator,"value":value}

attribute- фильтруемый параметр (может быть измерением или метрикой).

operator- компаратор, возможные значения: equal(равно), notEqual(не равно), ilike(содержит), notIlike(не содержит), in(среди), notIn(не среди), lte(<=), gte(>=).

value- проверяемое значение.

Пример запроса

https://api.tracker.k50.ru/api/counter/reports?counterId=1&dimensions[]=sourceType&dimensions[]=source&dimensions[]=keyword&period[from]=2016-12-24&period[to]=2017-01-24&metrics[]=visits&metrics[]=users&metrics[]=calls&limit=20&offset=0&orderBy[visits]=desc&apiKey=000000000000000000

Пример ответа

{  
   "dimensions":[  
      {  
         "sourceType":"(direct)",
         "source":"(not set)",
         "keyword":"(not set)",
         "metrics":[  
            {  
               "visits":"1783",
               "users":"915",
               "calls":"73"
            }
         ]
      },
      {  
         "sourceType":"internal",
         "source":"(not set)",
         "keyword":"(not set)",
         "metrics":[  
            {  
               "visits":"1031",
               "users":"539",
               "calls":"14"
            }
         ]
      },
      {  
         "sourceType":"search",
         "source":"yandex",
         "keyword":"(not set)",
         "metrics":[  
            {  
               "visits":"893",
               "users":"745",
               "calls":"14"
            }
         ]
      },
      {  
         "sourceType":"search",
         "source":"google",
         "keyword":"(not set)",
         "metrics":[  
            {  
               "visits":"850",
               "users":"733",
               "calls":"13"
            }
         ]
      },
      {  
         "sourceType":"referral",
         "source":"(not set)",
         "keyword":"(not set)",
         "metrics":[  
            {  
               "visits":"377",
               "users":"325",
               "calls":"3"
            }
         ]
      },
      {  
         "sourceType":"cpc",
         "source":"yandex",
         "keyword":"\u043a\u043e\u043b\u043b\u0442\u0440\u0435\u043a\u0438\u043d\u0433 \u0441\u0438\u0441\u0442\u0435\u043c\u0430",
         "metrics":[  
            {  
               "visits":"34",
               "users":"2",
               "calls":"0"
            }
         ]
      },
      {  
         "sourceType":"cpc",
         "source":"yandex",
         "keyword":"K50",
         "metrics":[  
            {  
               "visits":"27",
               "users":"24",
               "calls":"2"
            }
         ]
      },
      {  
         "sourceType":"search",
         "source":"yandex",
         "keyword":"k50",
         "metrics":[  
            {  
               "visits":"26",
               "users":"23",
               "calls":"1"
            }
         ]
      },
      {  
         "sourceType":"social",
         "source":"vkontakte",
         "keyword":"(not set)",
         "metrics":[  
            {  
               "visits":"19",
               "users":"17",
               "calls":"0"
            }
         ]
      },
      {  
         "sourceType":"cpc",
         "source":"google",
         "keyword":"\u043e\u043f\u0442\u0438\u043c\u0438\u0437\u0430\u0446\u0438\u044f \u043a\u043e\u043d\u0442\u0435\u043a\u0441\u0442\u043d\u043e\u0439 \u0440\u0435\u043a\u043b\u0430\u043c\u044b",
         "metrics":[  
            {  
               "visits":"16",
               "users":"16",
               "calls":"0"
            }
         ]
      },
      {  
         "sourceType":"cpc",
         "source":"yandex",
         "keyword":"\u043a\u043e\u043b\u043b\u0442\u0440\u0435\u043a\u0438\u043d\u0433",
         "metrics":[  
            {  
               "visits":"15",
               "users":"14",
               "calls":"1"
            }
         ]
      },
      {  
         "sourceType":"cpc",
         "source":"yandex",
         "keyword":"\u041a50",
         "metrics":[  
            {  
               "visits":"14",
               "users":"10",
               "calls":"0"
            }
         ]
      },
      {  
         "sourceType":"cpc",
         "source":"yandex",
         "keyword":"{PHRASE}",
         "metrics":[  
            {  
               "visits":"11",
               "users":"11",
               "calls":"0"
            }
         ]
      },
      {  
         "sourceType":"social",
         "source":"facebook",
         "keyword":"(not set)",
         "metrics":[  
            {  
               "visits":"11",
               "users":"11",
               "calls":"0"
            }
         ]
      },
      {  
         "sourceType":"cpc",
         "source":"yandex",
         "keyword":"\u0441\u0442\u0430\u0432\u043a\u0438 \u0432 \u0434\u0438\u0440\u0435\u043a\u0442\u0435",
         "metrics":[  
            {  
               "visits":"11",
               "users":"11",
               "calls":"0"
            }
         ]
      },
      {  
         "sourceType":"search",
         "source":"yandex",
         "keyword":"\u043a50",
         "metrics":[  
            {  
               "visits":"7",
               "users":"7",
               "calls":"0"
            }
         ]
      },
      {  
         "sourceType":"sniply",
         "source":"sniply",
         "keyword":"(not set)",
         "metrics":[  
            {  
               "visits":"5",
               "users":"5",
               "calls":"0"
            }
         ]
      },
      {  
         "sourceType":"cpc",
         "source":"yandex",
         "keyword":"(not set)",
         "metrics":[  
            {  
               "visits":"5",
               "users":"5",
               "calls":"0"
            }
         ]
      },
      {  
         "sourceType":"cpc",
         "source":"yandex",
         "keyword":"\u043a50 \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440",
         "metrics":[  
            {  
               "visits":"5",
               "users":"3",
               "calls":"0"
            }
         ]
      },
      {  
         "sourceType":"cpc",
         "source":"yandex",
         "keyword":"\u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440 \u0434\u0438\u0440\u0435\u043a\u0442",
         "metrics":[  
            {  
               "visits":"5",
               "users":"5",
               "calls":"0"
            }
         ]
      }
   ],
   "totals":{  
      "visits":"5255",
      "users":"3525",
      "calls":"122",
      "rows":"100"
   },
   "limits":{  
      "offset":"0",
      "limit":"20"
   }
}

Список доступных измерений

Измерение Значение для API
Тип Трафика sourceType
Источник source
Ключевое слово keyword
Поисковый запрос searchKeyword
Домен реферера domain
Реферер referer
Метка utm_source utmSource
Метка utm_medium utmMedium
Метка utm_campaign utmCampaign
Метка utm_term utmTerm
Метка utm_content utmContent
Страница входа (landing) landing
Домен страницы входа lDomain
Страница выхода outPoint
Страница звонка callPage
User Agent userAgent
IP адрес ip
Типа устройства deviceType
Названия устройства deviceName
Браузер browser
Операционная система platformDescription
Версия браузера browserVersion
Дата и время dateTime
Дата date
День месяца dayOfMonth
День недели dayOfWeek
Месяц month
Год year
Час hour
Минута minute
Час и минута hourAndMinute
Пользовательский атрибут customAttribute
Label label
Страна country
Регион region
Округ district
Город city
Id Сеанса sid
Id Пользователя uuid
Id Пользователя В Яндекс.Метрике metrikaClientId
Id Пользователя В Google Analytics analyticsClientId
Пользовательский UserId externalUserId
Номер Клиента callerPhone
Номер Назначения calledPhone
Пул Номеров poolName
Название Номера phoneName
Запись Разговора callRecordUrl
ID Звонка callId
Тип Звонка isCallback
ID Заказа orderId
Номер Клиента (Заказы) orderCallerPhone
Комментарий (Заказы) orderComment
Контактное Лицо orderContactPerson
Email Клиента orderEmail
Тип заказа orderType

Список доступных метрик

Измерение Значение для API
Посещения visits
Пользователи users
Звонки calls
Просмотры hits
Ср. Длительность посещения avgSessionDuration
Уникальные звонки uniqueCalls
Целевые звонки targetCalls
Уникально-целевые звонки uniqueTargetCalls
Повторные звонки noneUniqueCalls
Доля повторных звонков proportionRepeatCalls
Ср. Длительность звонка avgDurationCall
Заказы orders
Заказы Offline ordersOffline
Маржа margin
Заказы Online ordersOnline
Маржа Offline marginOffline
Маржа Online marginOnline
Доход revenue
Доход Offline revenueOffline
Доход Online revenueOnline
Обратные звонки callbacks
Уникальные обратные звонки uniqueCallbacks
Целевые обратные звонки targetCallbacks
Уникальные целевые обратные звонки uniqueTargetCallbacks

Получение отчетов в CSV

Также статистику можно выгружать в CSV файл.
Необходимо изменить адрес для отправки запроса

Адрес для отправки запросов

https://api.tracker.k50.ru/api/counter/reports/csv

Пример запроса GET

https://api.tracker.k50.ru/api/counter/reports/csv?counterId=1&dimensions[]=sourceType&dimensions[]=source&dimensions[]=keyword&period[from]=2016-12-24&period[to]=2017-01-24&metrics[]=visits&metrics[]=users&metrics[]=calls&limit=20&offset=0&orderBy[visits]=desc&apiKey=000000000000000000

Пример выгрузки