Есть несколько возможных вариантов добавления пользователей к ранее созданной аудиторной группе, в соответствии с ее типом идентификаторов.

Добавление пользователей массивом
https://dmpapi.admixer.net/AudienceAPI/UploadUsersToAudienceGroup

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

Параметр Описание
id ID аудиторной группы
userIds ID пользователей, объединенные в массив

В запросе список ID пользователей нужно объединить в массив.

Например,

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

где

123456 ID аудиторной группы
[‘6f70132d58ec4321845367dd94898544’,
‘3a45fe3d2f56d429e84ef78dd84ae780’]
ID пользователей, объединены в массив

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


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

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

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

В Body

id – ID аудиторной группы,
url – ссылка на файл.

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

Загрузка пользователей c определенным типом 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

Загрузите образец заполненной строки таблицы с примерами хешированных строк данных здесь.

Обновлено 12 октября, 2023