Entity: Аудитории
| Поле | Обязательно | Тип | Описание |
|---|---|---|---|
| Идентификатор | Требуется только при изменении существующего объекта. | Строка | Числовое значение идентификатора аудитории. Если оставить это поле пустым, будет создана новая аудитория и назначен уникальный идентификатор. |
| Имя | Да | Строка | Название аудитории. |
| Идентификатор рекламодателя (только для чтения) | Нет | Длинное целое | Числовое значение идентификатора рекламодателя, которому принадлежит аудитория. |
| Право собственности (только для чтения) | Нет | Перечисление | Тип принадлежности аудитории применительно к текущему рекламодателю. Возможные значения: "Собственное" | "Для всех". |
| Идентификатор действия Floodlight | Да | Строка | Числовое значение идентификатора родительского действия Floodlight. Вы можете указать любой буквенно-цифровой идентификатор для действия, которое вы создаете одновременно с аудиторией. |
| Название действия Floodlight (только для чтения) | Нет | Строка | Название действия Floodlight, связанного с аудиторией. |
| Тип аудитории | Нет | Перечисление | Тип правила, действующего для аудитории. Возможные значения: "Все посетители" | "Персонализированное правило" | "Другое". |
| Срок участия | Нет | Длинное целое | Количество дней, через которое пользователь будет удален из аудитории, если не станет выполнять никаких действий. Значение по умолчанию – 30 дней. |
| Описание | Нет | Строка | Описание аудитории. |
| Статус | Нет | Перечисление | Статус аудитории. После архивирования (деактивации) списка в него не добавляются новые пользователи, но показ связанного с ним объявления не прекращается. Имеющиеся пользователи будут указаны в списке, пока не истечет срок их участия. Возможные значения: "Активен" | "В архиве". |
| Источник (только для чтения) | Нет | Перечисление | Источник аудитории. |
| Количество участников (только для чтения) | Нет | Длинное целое | Количество пользователей в аудитории. |
| Идентификаторы рекламодателей с общим доступом | Нет | Список значений | Числовые значения идентификаторов рекламодателей, которым предоставлен доступ к аудитории. При обновлении имеющейся аудитории добавлять рекламодателей можно с помощью их обычных идентификаторов, а удалять – с помощью отрицательных идентификаторов. В скачанном листе это поле может содержать до 1000 идентификаторов. Если доступ к аудитории предоставлен более чем 1000 рекламодателей, к полю будет добавлен префикс "СОКРАЩЕНО". |