# Управление аудиторными сегментами
Аудиторный сегмент — это ML-классификатор «пользователь принадлежит к группе X», который учится по выбранному набору признаков и целей. CRUD позволяет программно заводить сегменты.
База: https://api.sales-ninja.me/public/api/v1/manage/audience-segments
| HTTP | Что делает |
|---|---|
GET / | Список сегментов. |
POST /list | Список со сложным фильтром. |
GET /{id} | Полная сущность. |
POST / | Создать. |
PUT /{id} | Обновить. |
DELETE /{id} | Удалить. |
# Тело
{
"title": "Готовые купить премиум-тариф",
"state": "Working",
"targetGoalIds": ["299837db-9b51-45a4-996b-844d3fd05bbd"],
"featureGoalIds": [
"11112222-3333-4444-5555-666677778888",
"aaaa1111-2222-3333-4444-555566667777"
]
}
# Поля
| Поле | Описание |
|---|---|
title | Название. |
state | Working / Active / Stopped / Paused / Archived. |
targetGoalIds[] | Цели, по которым сегмент учится отличать «своих» от «чужих». |
featureGoalIds[] | Цели-признаки, на которых строятся фичи модели. |
Старт обучения и переучивание управляются автоматически — программных триггеров нет.
# Ответ
{
"audienceSegmentId": "8f3a1e4b-…"
}
# Связанные страницы
- Сигналы для ML — список платформ, по которым строятся сегменты.
- Яндекс.Аудитория — выгрузка сегментов в Директ.
- Каталог интеграций.