Сохранение сегмента, созданного из файла

Сохраняет сегмент, созданный из файла с данными.

Request

POST

https://api-audience.yandex.ru/v1/management/segment/{segmentId}/confirm

Path parameters

Name

Description

segmentId*

Type: integer<int32>

Идентификатор сегмента, который вы хотите сохранить.

Query parameters

Name

Description

check_size

Type: boolean

Параметр позволяет создавать сегменты меньше 100 записей. Такие сегменты нельзя использовать для продвижения в Директе, пока их размер не превысит 100 записей.

Default: true

Body

application/json

{
    "segment": {
        "id": 0,
        "name": "string",
        "hashed": false,
        "hashing_alg": "string",
        "content_type": "string"
    }
}

Name

Description

segment*

Type: SegmentRequestUploading

Сегмент с заданными параметрами.

SegmentRequestUploading

Сегмент с заданными параметрами.

Name	Description
content_type*	Type: string Вид содержимого файла. Допустимые значения: `idfa_gaid` — идентификаторы устройств. `mac` — MAC-адреса. `crm` — CRM-данные.
name*	Type: string Название сегмента
hashed	Type: boolean Является ли захешированной каждая строка загруженного файла. Допустимые значения: `true` — строка захеширована. `false` — строка не захеширована.
hashing_alg	Type: string Алгоритм хеширования примененный для данных, отправляется для `hashed: true`. Допустимые значения: `MD5`. `SHA256`. Примечание Начиная с января 2025 года загрузка новых хешей MD5 перестанет поддерживаться. Пожалуйста, используйте SHA256 для загрузки данных.
id	Type: integer<int32> Идентификатор сегмента. Укажите данный параметр при обновлении сегмента.

Responses

200 OK

Body

application/json

{
    "segment": {
        "type": "string",
        "id": 0,
        "name": "string",
        "status": "string",
        "create_time": "2022-12-29T18:02:01Z",
        "owner": "string",
        "hashed": false,
        "used_hashing_alg": "string",
        "content_type": "string",
        "device_matching_type": "string"
    }
}

Name

Description

segment

Type: UploadingSegment

Сегмент, созданный из файла с пользовательскими данными.
Тип для описания сегмента.

UploadingSegment

Сегмент, созданный из файла с пользовательскими данными.

Name	Description
name*	Type: string Название сегмента.
used_hashing_alg*	Type: string Алгоритм хеширования примененный для данных, отправляется для `hashed: true`. Допустимое значение: `SHA256`. С 1 января 2025 года загрузка новых хешей MD5 не поддерживается. Для загрузки данных используйте SHA‑256.
content_type	Type: string Вид содержимого файла. Допустимые значения: `idfa_gaid` — идентификаторы устройств. `mac` — MAC-адреса. `crm` — CRM-данные.
create_time	Type: string<date-time> Время создания сегмента.
device_matching_type	Type: string Режим поиска устройств для сегмента. Допустимые значения: `CROSS_DEVICE` — включает в сегмент другие устройства того же пользователя, связанные с загруженным ID. Значение по-умолчанию, если режим поиска не выбран. `IN_DEVICE` — сегмент строится только по загруженным устройствам, без расширения на другие устройства. На данный момент режим `IN_DEVICE` доступен только для `idfa_gaid` сегментов.
hashed	Type: boolean Является ли захешированной каждая строка загруженного файла. Допустимые значения: `true` — строка захеширована. `false` — строка не захеширована.
id	Type: integer<int32> Идентификатор сегмента. Укажите данный параметр при обновлении сегмента.
owner	Type: string Логин владельца сегмента.
status	Type: string Статус обработки сегмента. Допустимые значения: `uploaded` — сегмент с данными пользователя загружен. `is_processed` — сегмент с заданными параметрами обрабатывается. `processed` — загрузка и обработка сегмента завершена. Сегмент готов для работы. `processing_failed` — обработка сегмента завершилась с ошибкой. `is_updated` — сегмент обновляется. `few_data` — сегмент содержит мало данных для работы.
type	Type: string Тип сегмента. Допустимые значения: `uploading` — сегмент, созданный из файла с пользовательскими данными. `metrika` — сегмент, импортируемый из Яндекс Метрики. `appmetrica` — сегмент, импортируемый из AppMetrica. `lookalike` — сегмент из пользователей, «похожих» на другой сегмент клиента (технология Look-alike). `geo` — сегмент на основе данных о геолокации по полигонам и по окружностям. `pixel` — сегмент, созданный по пикселю.

Была ли статья полезна?

Изменение данных сегмента, созданного из файла

Сохранение сегмента из ClientId Метрики, созданного из файла