Шаблоны, экспорт и импорт потоков
Как сохранить настройки потока в личную библиотеку и перенести поток в другую кампанию или другой трекер через JSON-файл.
Настройки потока можно сохранить как шаблон или скачать JSON-файлом, а затем создать по ним поток в любой кампании. Шаблон хранится в вашей личной библиотеке, файл нужен для передачи коллеге и переноса в другую установку. Кнопки Шаблоны и ⋯ есть там, где вы можете менять кампанию: в кампании с меткой «только просмотр» их нет.
Сохранить поток как шаблон
- Откройте кампанию на вкладке Потоки.
- Нажмите ⋯ в карточке потока — кнопка между Копия и шестерёнкой. Откроется окно Шаблон потока.
- Проверьте поле Название шаблона. По умолчанию там название потока. Длина — от 1 до 120 символов.
- Нажмите Сохранить шаблон.
Появится сообщение «Шаблон сохранён. Он доступен в «Шаблоны» любой вашей кампании.»
Шаблон хранит настройки на момент сохранения: поздние правки потока в него не попадают. Перед сохранением поток проходит ту же проверку, что и при импорте; сообщение об ошибке появится в этом же окне, разбор — в разделе Ограничения файла.
Скачать поток в файл
- Нажмите ⋯ в карточке потока.
- Нажмите Скачать JSON.
Браузер скачает файл stream-<ID потока>.json.
Создать поток из шаблона или файла
- Откройте нужную кампанию на вкладке Потоки.
- Нажмите Шаблоны над списком потоков. Откроется окно Шаблоны потоков.
- Выберите источник настроек:
- найдите шаблон через поле Найти шаблон и нажмите Выбрать;
- или нажмите Загрузить JSON и выберите файл
.jsonразмером до 256 КиБ.
- Дождитесь окончания проверки — на это время в окне написано «Проверка…». Затем откроется окно Настройки потока с заполненными полями.
- Пройдите вкладки Основное, Фильтры, Ротация, Расписание и исправьте то, что в этой кампании должно быть другим.
- Чтобы поток сразу принимал трафик, на вкладке Расписание включите Поток активен. В черновике флажок снят.
- Нажмите Сохранить поток.
Пока не нажата кнопка Сохранить поток, поток не создан: если закрыть окно, в кампании ничего не изменится. Если после нажатия окно не закрылось, поток не сохранён: текст ошибки выводится вверху страницы кампании, под окном. Закройте окно, прочитайте ошибку и повторите импорт.
Проверка
- Новый поток стоит последним в списке кампании.
- Если флажок Поток активен не включали, у названия потока стоит метка «пауза». Включить поток можно переключателем слева в его карточке.
Что переносится
В шаблон и в файл попадают:
- название, тип потока, действие и вес;
- параметры действия: Способ редиректа, Когда выбрать оффер, URL назначения, HTML, текст и Alias целевой кампании;
- условия вкладки Фильтры и связки И / ИЛИ между ними;
- расписание и лимиты кликов с их часовыми поясами;
- офферы и лендинги потока: их идентификаторы и доли.
Не попадают:
- состояние — черновик всегда на паузе;
- место в списке;
- флажок Скрывать счётчик кликов — в черновике он снят;
- учтённые клики по лимитам — новый поток считает с нуля;
- сами офферы и лендинги и файлы их страниц.
Офферы и лендинги при импорте
Офферы и лендинги записаны в шаблоне и в файле по полному идентификатору (UUID), а не по номеру #… из колонки ID. При проверке каждый из них должен существовать в этом трекере и быть доступен вам, иначе черновик не откроется. Проверка повторяется при нажатии Сохранить поток.
- У офферов и лендингов, созданных в другой установке, другие UUID, и файл с ними там проверку не пройдёт.
- В потоках с действиями Прямой URL, HTML, Показать текст, Передать в кампанию, Заглушка 404 и Ничего (204) офферов и лендингов нет, и эта проверка их не касается.
- При действии Передать в кампанию alias переносится как есть. Проверьте в черновике поле Alias целевой кампании.
Библиотека шаблонов
- Шаблоны личные: вы видите только свои, другие сотрудники команды их не видят. Чтобы передать настройки коллеге, скачайте JSON и отправьте файл. Офферы и лендинги из файла должны быть доступны и ему.
- Новые шаблоны стоят в списке первыми. У шаблона две строки: его название и название потока, с которого он сохранён.
- Поле Найти шаблон ищет по названию шаблона.
Чтобы удалить шаблон, нажмите × в его строке и подтвердите вопрос «Удалить шаблон «…»? Существующие потоки останутся.»
Ограничения файла
Файл — JSON-объект с тремя полями: format со значением tracker-stream, version со значением 1 и stream с настройками потока. Поля stream описаны на странице Admin API: потоки, образец — любой файл, скачанный кнопкой Скачать JSON. Поля id, campaign_id, position и state при импорте не учитываются.
Списки offers и landers могут быть пустыми. Тогда офферы и лендинги выбираются в черновике на вкладке Ротация.
Шаблон и файл проверяются по одним правилам. При нарушении в окне появляется одно из сообщений:
| Сообщение | Правило |
|---|---|
| «Файл больше 256 КиБ», «Шаблон больше 256 КиБ» | Размер файла и настроек потока — до 256 КиБ |
| «Нужен шаблон tracker-stream версии 1» | В format стоит tracker-stream, в version — 1 |
| «Название потока: от 1 до 160 символов» | Название не пустое и не длиннее 160 символов |
| «Неизвестный тип потока», «Неизвестное действие потока» | В type и action_type — значения из объекта потока |
| «Превышен размер настроек потока» | Вес от 0 до 1 000 000 000, до 64 условий, до 200 офферов и до 200 лендингов |
| «неизвестный тип или оператор фильтра: …» | Поле и оператор условия — из фильтров потока |
| «Некорректная или повторяющаяся цель потока» | У каждого оффера и лендинга указан id, повторов нет, доля от 0 до 1 000 000 000 |
| «Лимиты кликов: целые числа от 0 до 1 000 000 000 000» | Лимиты в час, в день и всего |
| «Неизвестный часовой пояс расписания», «Неизвестный часовой пояс лимита» | Название зоны из базы IANA, например Europe/Warsaw |
| «Дни расписания: от 1 до 7» | Дни — числа от 1 (понедельник) до 7 (воскресенье) |
| «Некорректное время расписания» | Время начала и окончания — в формате ЧЧ:ММ |
Если не получилось
«Не удалось прочитать JSON-файл» и «Не удалось прочитать файл шаблона»
Файл повреждён или изменён вручную с ошибкой. Первое сообщение — файл не разбирается как JSON. Второе — в файле не JSON-объект или значение поля записано не того типа, например число в кавычках. Скачайте поток заново кнопкой Скачать JSON.
«оффер недоступен: …» и «лендинг недоступен: …»
После двоеточия стоит UUID оффера или лендинга из файла. Такой страницы нет в этом трекере, она в корзине или недоступна вам. Чтобы сверить UUID, наведите курсор на номер #… в колонке ID раздела Офферы или Лендинги: UUID показан в подсказке, клик по номеру копирует его.
- Удалённую страницу восстановите из корзины.
- К чужому лендингу попросите открыть доступ.
- С чужим оффером так не получится: поделиться создаёт копию с новым ID. Создайте поток вручную или очистите в файле список
offersи выберите свой оффер в черновике на вкладке Ротация.