Назад к Обзору платформы
Глоссарий
API
Статистические API
Аудиторные API

Чтобы добавить пользователей в сегмент, используйте метод

https://dmpapi.admixer.net/AudienceAPI/UploadUsersToSegment

В POST-запросе укажите такие параметры:

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

Например,

https://dmpapi.admixer.net/AudienceAPI/UploadUsersToSegment?id=1234&userIds=[‘6f70132d58ec4321845367dd94898544’,‘3a45fe3d2f56d429e84ef78dd84ae780’]

где

1234 ID сегмента
[‘6f70132d58ec4321845367dd94898544’,
‘3a45fe3d2f56d429e84ef78dd84ae780’]		 ID пользователей, объединены в массив
При создании POST-запроса, необходимо ввести application/x-www-form-urlencoded в поле значения Content-Type.

В ответ вы получите JSON с ID сегмента, в который вы добавили пользователей, и сообщением об успешном завершении.

Показать пример JSON-ответа с ID сегмента, в который вы добавили пользователей
{
    "data": 3546,
    "message": "2 users were uploaded"
}

Добавление пользователей по ссылке

Вы также можете добавить пользователей с помощью URL, ведущий к файлу со списком пользователей. Поддерживаются только файлы .csv. Например,

https://dmpapi.admixer.net/AudienceAPI/UploadUsersToSegment?id=1001234&url=http://example.com/NewUsersForSegment.csv

где

id – ID сегмента,
url – ссылка на файл.

В ответ вы получите JSON с ID сегмента, в который вы добавили пользователей, и сообщением об успешном завершении.

Загрузка пользователей c определенным типом ID из файла на компьютере

Чтобы загрузить файл со списком пользователей, выберите опцию загрузки файла в POST интерфейсе, а затем выберите файл .csv из вашей локальной директории.

Файл, который вы загрузили с компьютера или на который вы указали ссылку должен указывать ID типа формата в верхней строке. Например, первая строка может содержать значения Idfa, AAID и т.д. Если ввести другие значения, файл может считываться не корректно. Интервал между запросами должен быть не менее 30 секунд.

Загрузка пользователей типа 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 Email Phone PubId EmailMD5 PhoneMD5 EmailSHA256 PhoneSHA256

Пример заполненного ряда таблицы с примерами хешированных данных вы можете скачать здесь.

Обновлено 04 января, 2024