Авторизация
Для использования 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 |
Интервал между запросами должен быть не менее 30 секунд
Обновлено 01 февраля, 2023