Разделы документации

Шаблоны, экспорт и импорт потоков

Как сохранить настройки потока в личную библиотеку и перенести поток в другую кампанию или другой трекер через JSON-файл.

Настройки потока можно сохранить как шаблон или скачать JSON-файлом, а затем создать по ним поток в любой кампании. Шаблон хранится в вашей личной библиотеке, файл нужен для передачи коллеге и переноса в другую установку. Кнопки Шаблоны и ⋯ есть там, где вы можете менять кампанию: в кампании с меткой «только просмотр» их нет.

Сохранить поток как шаблон

  1. Откройте кампанию на вкладке Потоки.
  2. Нажмите ⋯ в карточке потока — кнопка между Копия и шестерёнкой. Откроется окно Шаблон потока.
  3. Проверьте поле Название шаблона. По умолчанию там название потока. Длина — от 1 до 120 символов.
  4. Нажмите Сохранить шаблон.

Появится сообщение «Шаблон сохранён. Он доступен в «Шаблоны» любой вашей кампании.»

Шаблон хранит настройки на момент сохранения: поздние правки потока в него не попадают. Перед сохранением поток проходит ту же проверку, что и при импорте; сообщение об ошибке появится в этом же окне, разбор — в разделе Ограничения файла.

Скачать поток в файл

  1. Нажмите ⋯ в карточке потока.
  2. Нажмите Скачать JSON.

Браузер скачает файл stream-<ID потока>.json.

Создать поток из шаблона или файла

  1. Откройте нужную кампанию на вкладке Потоки.
  2. Нажмите Шаблоны над списком потоков. Откроется окно Шаблоны потоков.
  3. Выберите источник настроек:
    • найдите шаблон через поле Найти шаблон и нажмите Выбрать;
    • или нажмите Загрузить JSON и выберите файл .json размером до 256 КиБ.
  4. Дождитесь окончания проверки — на это время в окне написано «Проверка…». Затем откроется окно Настройки потока с заполненными полями.
  5. Пройдите вкладки Основное, Фильтры, Ротация, Расписание и исправьте то, что в этой кампании должно быть другим.
  6. Чтобы поток сразу принимал трафик, на вкладке Расписание включите Поток активен. В черновике флажок снят.
  7. Нажмите Сохранить поток.

Пока не нажата кнопка Сохранить поток, поток не создан: если закрыть окно, в кампании ничего не изменится. Если после нажатия окно не закрылось, поток не сохранён: текст ошибки выводится вверху страницы кампании, под окном. Закройте окно, прочитайте ошибку и повторите импорт.

Проверка

  • Новый поток стоит последним в списке кампании.
  • Если флажок Поток активен не включали, у названия потока стоит метка «пауза». Включить поток можно переключателем слева в его карточке.

Что переносится

В шаблон и в файл попадают:

  • название, тип потока, действие и вес;
  • параметры действия: Способ редиректа, Когда выбрать оффер, 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 и выберите свой оффер в черновике на вкладке Ротация.
Обновлено Нужна помощь? ↗