Каналы и слоты размещения
Справочник раздела «Каналы». Описывает структуру каналов, слотов и операции с ними.
Что это
Раздел «Каналы» отображает все цифровые каналы, в которых могут показываться офферы. Каждый канал содержит набор слотов — конкретных мест размещения контента.
📸 [Скриншот: раздел «Каналы». Канал Homepage — 4 слота, 5 офферов, 3 активных, статус «Активен». Карточки слотов: Default, Главная страница, Сторис на главной странице, Баннер на странице Профиль. Внизу — карточка «Создать слот». У слота «Баннер на странице Профиль» открыто контекстное меню: Редактировать, Удалить]
Канал
Канал — это цифровая точка контакта с клиентом: мобильное приложение, интернет-банк, веб-сайт, SMS-рассылки, push-уведомления.
Параметры канала
| Параметр | Обязательно | Описание |
|---|---|---|
| Системное имя | Да | Техническое имя канала. Формат: lowercase, snake_case. Не изменяется после создания. Примеры: homepage, sms_channel, push_notifications |
| Отображаемое название | Да | Человекочитаемое название для интерфейса. Примеры: Homepage, SMS рассылки, Push уведомления |
| Описание | Нет | Краткое описание назначения канала |
| Метаданные (JSON) | Нет | JSON-объект с дополнительными параметрами. Например: {"icon": "home", "color": "#FF5733"} |
| Статус | Да | Активный или Неактивный |
Создание канала
Нажмите «+ Создать канал» в правом верхнем углу раздела.
📸 [Скриншот: модальное окно «Создать канал». Поля: Системное имя (плейсхолдер: homepage, sms_channel, push_notifications; подсказка: «Lowercase, snake_case, не изменяется после создания»). Отображаемое название (плейсхолдер: Homepage, SMS рассылки, Push уведомления). Описание (плейсхолдер: Краткое описание назначения канала). Метаданные JSON (плейсхолдер: {"icon": "home", "color": "#FF5733"}; подсказка: «Опционально: JSON объект с дополнительными параметрами»). Статус: Активный. Кнопки: Отмена, Сохранить]
Типичные ошибки при создании канала
❌ Использовать пробелы или кириллицу в системном имени ✅ Только латиница, цифры и подчёркивания: homepage, mobile_app, sms_channel
❌ Забывать, что системное имя нельзя изменить после создания ✅ Тщательно продумайте имя заранее — оно используется в интеграциях и API
Слот
Слот — это конкретное место на экране, где показывается оффер. Внутри одного канала может быть несколько слотов.
Параметры слота
| Параметр | Обязательно | Описание |
|---|---|---|
| Канал | Да | К какому каналу относится слот (заполняется автоматически) |
| Системное имя слота | Да | Техническое имя. Строчные буквы, цифры и подчёркивания. Уникально в пределах канала. Примеры: main_page, profile_top_banner, main_top_stories |
| Отображаемое название | Да | Название слота в интерфейсе. Примеры: «Главная страница», «Баннер на странице Профиль» |
| Слот по умолчанию | Нет | Чекбокс. Только один слот в канале может быть по умолчанию. Офферы без явной привязки к слоту попадают сюда |
| Добавлять баннер в выдачу сторис | Нет | Чекбокс. Если включено, offers-api автоматически добавляет баннер перед сторисами в выдаче этого слота |
| Описание | Нет | Текстовое описание расположения слота |
| Метаданные (JSON) | Нет | JSON-объект с техническими параметрами: размеры, позиция, ограничения. Например: {"width": 1200, "height": 400, "position": "top"} |
| Порядок сортировки | Нет | Числовое значение. Меньше значение = выше приоритет отображения. По умолчанию 0 |
| Статус | Да | Активный или Неактивный |
📸 [Скриншот: модальное окно «Редактировать слот». Канал: Homepage. Системное имя: profile_top_banner. Отображаемое название: Баннер на странице Профиль. Чекбоксы: «Слот по умолчанию» (подсказка: «Только один слот в канале может быть по умолчанию»), «Добавлять баннер в выдачу сторис» (подсказка: «Если включено, offers-api будет автоматически добавлять баннер перед сторисами в выдаче этого слота»). Описание: Баннер на странице Профиль. Метаданные: {"width": 1200, "height": 400, "position": "top"}]
📸 [Скриншот: нижняя часть окна «Редактировать слот». Порядок сортировки: 0 (подсказка: «Меньше значение = выше приоритет»). Статус: выпадающий список — Активный (выбрано ✓), Неактивный. Кнопки: Отмена, Сохранить]
Создание слота
Внутри канала нажмите карточку «Создать слот» (с иконкой ⊕). Заполните параметры и нажмите «Сохранить».
Операции со слотом
Через контекстное меню (три точки на карточке слота) доступны:
- Редактировать — изменить параметры слота
- Удалить — удалить слот (возможно только если к нему не привязаны активные офферы)
Счётчики на карточке слота
| Иконка | Значение |
|---|---|
| 🟢 (зелёный) | Активные офферы |
| 🟡 (жёлтый) | Офферы на паузе |
| ✅ (зелёная галка) | Завершённые офферы |
| 📅 (синий) | Запланированные офферы |
Кнопка «Просмотр» открывает список офферов, привязанных к данному слоту.
Типичные ошибки
❌ Создавать слоты с неинформативными именами (slot1, test) ✅ Имя должно отражать расположение: main_top_banner, profile_top_banner
❌ Не заполнять метаданные JSON с размерами ✅ Указывайте width/height/position — это помогает фронтенду корректно отображать контент
❌ Привязывать все офферы к одному слоту ✅ Распределяйте офферы по разным слотам, чтобы они не конкурировали без необходимости
Следующие шаги
- Выбрать слоты при создании оффера → Шаг 1: Основное
- Привязать контент к офферу → Связь с контентом
- Настроить инсайты → Инсайты