Для создания нового сегмента в сегментной группе используйте такой POST-метод:

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

В GET-запросе укажите следующие параметры:

Параметр Описание Примечание
name Название сегмента, уникальное в разрезе сегментной группы Максимальное количество символов – 256
groupId ID сегментной группы, в которой создается сегмент
idType Тип идентификаторов пользователей в сегменте

Например,

https://dmpapi.admixer.net/AudienceAPI/Segment?name=NewSegment&groupId=1234&idType=6

где

NewSegment название нового сегмента
1234 ID сегментной группы, в которой создается сегмент
6 тип идентификаторов пользователей в этом сегменте (в этом случае тип PubID)

Типы идентификаторов пользователей

Тип Значение
Cookie 0
IDFA 1
PubID 6
AAID 7
ClientId 8
Email 9
Phone 10
EmailMD5 12
EmailSHA256 13
PhoneMD5 14
PhoneSHA256 15

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

Показать пример JSON-ответа с ID созданного сегмента
{
    "data": 3546,
    "message": "Segment was created successfully"
}

Если вы хотите получить список всех существующих сегментов, используйте POST-метод

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

Показать пример JSON-ответа со списком всех существующих сегментов
{
"groupId": 1234,
"groupName": "MySegmentGroup",
"groupCpmPrice": 5.00,
"id": 5678,
"name": "NewSegment",
"idType": 6,
"userIds": 5
}

где

groupId ID сегментной группы
groupName название сегментной группы
groupCpmPrice ее CPM в валюте провайдера
id ID сегмента
name название сегмента
idType тип идентификаторов в сегменте
userIds количество уникальных пользовательских идентификаторов в сегменте

 

Чтобы получить список сегментов одной или нескольких сегментных групп, укажите в GET-запросе ID этой группы/этих групп через массив. Например,

https://dmpapi.admixer.net/AudienceAPI/Segments?groupIds=[‘1234’]’1234’] (в разрезе одной сегментной группы)

https://dmpapi.admixer.net/AudienceAPI/Segments?groupIds=[‘1234’, ‘1235’]’1234’, ‘1235’] (в разрезе нескольких сегментных групп)

Показать пример JSON-ответа со списком сегментов одной или нескольких сегментных групп
[ {
            "groupId": 1234,
            "groupName": "Look-alike",
            "groupCpmPrice": 0.0,
            "id": 311,
            "name": "Segment 1",
            "idType": 0,
            "userIds": 56
    },
    {
            "groupId": 1235,
            "groupName": "Created segments",
            "groupCpmPrice": 0.02000000,
            "id": 297,
            "name": "Segment 2",
            "idType": 0,
            "userIds": 321
    },
    {
            "groupId": 1235,
            "groupName": "Created segments",
            "groupCpmPrice": 0.02000000,
            "id": 303,
            "name": "Segment 3",
            "idType": 0,
            "userIds": 122
    } ]
Обновлено 01 февраля, 2023