Назад до Огляду платформи
Глосарій
API
Статистичні APIs
Audience APIs

Авторизація

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

У тілі запиту вкажіть такі параметри.

Параметр

Значення
username ваш логін
password пароль до вашого акаунта
grant_type пароль авторизації
culture “
Увага: Якщо вигружаються файли по ТД паблішера, то Access Token для Authorization вигружається за допомогою креденшеалів паблішера, та тому в цьому випадку в тілі GET-запиту необхідно вказати ID Trading Desk паблішера. Якщо ID Trading Desk не буде вказано, то відобразиться помилка доступу.
Для Trading Desk нетворка нічого не змінюється, та в Access Token для Authorization вказуються креденшеали Trading Desk.

Як формувати запит для Trading Desk Паблішера можна побачити нижче на скріншоті.

Зверніть увагу, що термін дії токена доступу закінчується через 24 години.

Запит має наступну структуру:

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

your_token

Розгорнути приклад хедера запиту у використанні
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, or Admixer UID,
  • RetGroups.Id, ID аудиторних груп до якої занесено користувача,
  • Event Type (за замовчуванням встановлено view для всіх груп). Для аудиторних груп, що збираються в рекламних профайлах TD, можуть бути задані параметри (confirmed view, click, video Q 1-4). Дивіться таблицю з усіма типами подій та їхніми ID внизу цієї сторінки.
  • Дата / Час (у форматі UTC),
  • IP-адреса,
  • Країна, визначена геолокація за IP,
  • Тип пристрою (desktop, смартфон, планшет, ТВ). Дивіться таблицю з усіма типами пристроїв та їхніми ID внизу цієї сторінки.
  • Платформа (OS, Browser),
  • Виробник мобільних пристроїв / Бренд,
  • 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 секунд.
Оновлено 20 вересня, 2024