Авторизация

Для использования Raw Data API необходимо получить токен доступа. Используя Postman или другую подобную программу, отправьте POST-запрос по URL-адресу: https://dmp-api.admixer.net/Token. В теле запроса укажите такие параметры.

Параметр Значение
username ваш логин
password пароль к вашему аккаунту
grant_type пароль авторизации
culture «

Сам запрос имеет следующую структуру:

userName=mylogin@example.com&password=12345&grant_type=password&culture="

Показать пример запроса
userName=networkUser@example.com&password=mypass12345&grant_type=mypass54321&culture="

В ответ вы получите JSON с полем access_token.

Показать пример JSON-ответа
{“access_token”=”wTK8HxHDjDYlCdysaee8clQAd2gfVt”}

Значение этого поля — ваш токен доступа. Указывайте его при каждом запросе в хедере запроса в таком виде:

Authorization: Bearer

Показать пример хедера запроса
Authorization: Bearer wTK8HxHDjDYlCdysaee8clQAd2gfVt

Получение данных

Для получение данных по аудиториям нужно отправить GET запрос на: https://dmp-api.admixer.net/dmp/DownloadLog?date={date}

Показать пример GET-запроса на получение данных
https://dmp-api.admixer.net/dmp/DownloadLog?date=2021-04-22

При этом укажите в хедере запроса полученный токен.

При успешной авторизации в ответ вы получите файл за выбранный день со всеми пользователями в аудиторных группах. В полученом файле будут доступны следующие данные по умолчанию:

  • VisKey: Visitor ID – Admixer UID,
  • RetGroups.Id: ID аудиторных групп в которую занесен пользователь,
  • Event type (по умолчанию установлено view для всех групп). Для аудиторных групп собираемых в рекламных профайлах TD могут быть заданы параметры (confirmed view, click, video Q 1-4). Смотрите таблицу со всеми типами событий и их ID внизу этой страницы.
  • Дата / Время (в формате UTC),
  • IP-адрес,
  • Cтрана, определенная геолокация по IP
  • Тип устройства (desktop, смартфон, планшет, ТВ). Смотрите таблицу со всеми типами устройств и их ID внизу этой страницы.
  • Платформа (ОС, Браузер),
  • Производитель / Бренд устройства,
  • RefererUrl: полный URL или APP Bundle осуществления показа
  • Параметры, которые настраиваются дополнительно – параметры, которые могут быть получены по протоколу RTB при показе рекламы на внешних ресурсах (геолокация пользователя, категория сайта/приложения)
Таблица всех типов событий и их ID
ID Event
0 Code (from Tag)
1 View
2 Click
4 ConfirmView
8 FirstQuartile
16 Midpoint
32 ThirdQuartile
64 Complete
128 Request
Таблица всех типов устройств и их ID
ID Device Type
0 Unknown
1 MobileTablet
2 PC
3 ConnectedTV
4 Phone
5 Tablet
6 Connected_Device
7 Set_Top_Box
Обновлено 01 февраля, 2023