Додавання користувачів до сегменту
Щоб додати користувачів до сегменту, використовуйте метод
https://dmpapi.admixer.net/AudienceAPI/UploadUsersToSegment
У запиті POST вкажіть такі параметри:
| Параметр | Опис |
|---|---|
| id | ID сегмента |
| data | Файл .csv для завантаження |
Наприклад,
https://dmpapi.admixer.net/AudienceAPI/UploadUsersToSegment?id=1234&userIds= [‘6f70132d58ec4321845367dd94898544’,‘3a45fe3d2f56d429e84ef78dd84ae780’]
де
| 1234 | ID сегмента |
| [‘6f70132d58ec4321845367dd94898544’, ‘3a45fe3d2f56d429e84ef78dd84ae780’] |
ID користувачів, об'єднаних в масив |
У відповідь ви отримаєте JSON з ID сегмента, в який ви додали користувачів, і повідомлення про успішне завершення.
- Показати приклад JSON-відповіді з ID сегмента, до якої ви додали користувачів
Додавання користувачів за посиланням
Також ви можете додавати користувачів за допомогою URL, яка веде до файлу зі списком користувачів. Підтримуються тільки .csv файли. . Наприклад,
де
id – ID сегмента,
url – посилання на файл.
У відповідь ви отримаєте JSON з ID сегмента, до якої ви додали користувачів, та повідомленням про успішне завершення.
Додавання користувачів з певним типом ID з файлу на комп'ютері
Щоб завантажити файл зі списком користувачів, виберіть опцію завантаження файлу в POST інтерфейсі, а потім виберіть файл .csv з вашої локальної директорії.
Додавання MultiID типу користувачів з файлу на комп'ютері
Додавання користувачів до сегменту
Щоб додати користувачів до сегменту, використовуйте метод
https://dmpapi.admixer.net/AudienceAPI/UploadUsersToSegment
У запиті POST вкажіть такі параметри:
| Параметр | Опис |
|---|---|
| id | ID сегмента |
| data | Файл .csv для завантаження |
Приклад завантаження через Postman інтерфейс:
Важливо!
Необхідно використовувати для завантаження файл, що відповідає прикладу, наведеному у прикріпленому файлі (як і для загрузки через інтерфейс).При мультизавантаженні даних, таблиця з даними користувачів повинна точно відповідати формату, наведеному у прикладі файлу, інакше, дані не завантажаться коректно. Порядок колонок має бути збережений, але допускається відсутність деяких із них. Також допускається порожні значення у рядках відповідних колонок. При некоректному введенні даних рядок пропускається (не зчитуватиметься і не записуватиметься). При завантаженні таблиці чутливості до регістру немає.
Завантажені дані мають відповідати цим форматам:
- Колонка даних 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 | Phone | PubId | EmailMD5 | PhoneMD5 | EmailSHA256 | PhoneSHA256 |
Завантажте зразок заповненого рядка таблиці з прикладами хешованих рядків даних тут.