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

Є декілька можливих варіантів додавання користувачів до раніше створеної аудиторної групи, відповідно до її типу ідентифікаторів.

Додавання користувачів масивом
https://dmpapi.admixer.net/AudienceAPI/UploadUsersToAudienceGroup

В POST-запиті вкажіть такі параметри:

Параметр Опис
id ID Аудиторної групи
userIds ID користувачів, об'єднані в масив

У запиті список ID користувачів потрібно об'єднати в масив.

Наприклад,
https://dmpapi.admixer.net/AudienceAPI/UploadUsersToAudienceGroup?id=123456&userIds=["6f70132d58ec4321845367dd94898544","3a45fe3d2f56d429e84ef781dd84ae780"]

де

123456 ID аудиторної групи
[‘6f70132d58ec4321845367dd94898544’,
‘3a45fe3d2f56d429e84ef781dd84ae780’]		 ID користувачів, об'єднані в масив
При створенні POST-запиту, необхідно ввести application/x-www-form-urlencoded у поле значень Content-Type.

У відповідь ви отримаєте JSON з ID аудиторної групи, до якої ви додали користувачів, та повідомлення про успішне завершення.


Показати приклад JSON-відповіді з ID аудиторної групи, до якої ви додали користувачів
{
                                "data": 3546,
                                "message": "2 users were uploaded"
                            }
Інтервал між запитами не повинен бути менше 30 сек.

Додавання користувачів за посиланням

Ви також можете додати користувачів за допомогою URL, що веде до файлу зі списком користувачів. Підтримуються тільки файли .csv.
Наприклад,
https://dmpapi.admixer.net/AudienceAPI/UploadUsersToAudienceGroup

В Body

id - ID аудиторної групи,
url - посилання на файл.

У відповідь ви отримаєте JSON з ID аудиторної групи, до якої ви додали користувачів, та повідомленням про успішне завершення.

Додавання користувачів з певним типом ID з файлу на комп'ютері

Щоб завантажити файл зі списком користувачів, виберіть опцію завантаження файлу в Body POST- запиту та в data параметрі додайте файл .csv з вашої локальної директорії.

Параметр Опис
id ID Аудиторної групи
data Файл .csv для завантаження

Файл, який ви завантажили або на який ви вказали посиланням, повинен зазначати тип ID формату в верхньому рядку. Наприклад, перший рядок може містити значення Idfa, AAID і т.д. Якщо ввести інші значення, файл може бути некоректно прочитаний.

Додавання MultiID типу користувачів з файлу на комп'ютері

Додавання користувачів до аудиторної групи

Щоб додати користувачів до аудиторної групи, використовуйте метод
https://dmpapi.admixer.net/AudienceAPI/UploadUsersToAudienceGroup 

У запиті POST вкажіть такі параметри:

Параметр Опис
id ID аудиторної групи
data Файл .csv для завантаження

Важливо!

Необхідно використовувати для завантаження файл, що відповідає прикладу, наведеному у прикріпленому файлі (як і для загрузки через інтерфейс).

При мультизавантаженні даних, таблиця з даними користувачів повинна точно відповідати формату, наведеному у прикладі файлу, інакше, дані не завантажаться коректно. Допускається відсутність деяких із колонок, але важливо зберегти назву колонки. Також допускається порожні значення у рядках відповідних колонок. При некоректному введенні даних рядок пропускається (не зчитуватиметься і не записуватиметься). При завантаженні таблиці присутня чутливості до регістру.

Завантажені дані мають відповідати цим форматам:

  • Колонка даних AdmixerId повинна містити 32 тільки алфавітно-цифрові символи без пробілів;
  • Колонки даних Idfa та >AAID не повинні містити неалфавітно-цифрових символів і повинні відповідати загальному формату: 035911ea-467d-4056-903b-65cf44f5633b;
  • Колонка даних Email повинна відповідати загальноприйнятому формату для електронних листів;
  • Колонка даних Phone має містити лише 10 або 12 цифр, без додаткових символів (наприклад знак “+” ) та відповідати одному з наступних форматів: 0991234567 чи 380991234567;
  • Дані у колонках EmailMD5 та PhoneMD5 повинні містити електронні адреси та телефони хешовані у форматі MD5;
  • Дані EmailSHA256 та PhoneSHA256 мають містити електронні адреси та телефони, хешовані у форматі SHA256 ;
  • Колонки PubId та ClientId можуть містити будь-які дані в будь-якому формат.

Приймаються лише таблиці у форматі .csv

AdmixerId IDFA AAID ClientId Email Phone PubId EmailMD5 PhoneMD5 EmailSHA256 PhoneSHA256

Завантажте зразок заповненого рядка таблиці з прикладами хешованих рядків даних тут.

Потрібно пам'ятати!

Якщо одним з типів ідентифікаторів аудиторної групи при додаванні користувачів є PubID, тоді необхідно в запиті додавати параметр containerId. З чого випливає, що початково PubID збирається контейнером (Тег Менеджером) з сайтів та саме ID цього контейнера потрібно вказувати при завантаженні.

Оновлено 12 жовтня, 2023