Бан видео у партнёра

Что это

Инструмент в админке (admin.tubecrown.com), которым можно разом забанить (скрыть) или, наоборот, разбанить заданную долю в процентах видео одного партнёра — сразу на всех подключённых сиджах. Видео не выбираются вручную по одному — задаётся только процент, а какие именно видео скрыть, каждый сидж решает сам. Это не удаление видео из базы — для полного удаления конкретного видео используется парсер, см. Удаление видео из базы.

Бан видео ≠ отключение туба

Даже бан 100% видео не убирает сам туб (каналы) с сиджей. Чтобы полностью отключить туб партнёра, нужно снять галочку Visible в парсере — см. Как отключить туб.

Когда применяется

  • Нужно временно снизить долю показываемых видео партнёра (например, из-за проблем с трафиком/качеством).
  • Ранее забаненные видео нужно вернуть обратно (разбанить) — полностью или частично.

Где находится и как туда попасть

  1. Зайти в раздел Партнёрства и открыть нужного партнёра (страница партнёра, где обычно кнопки Update / Delete).
  2. Нажать кнопку Videos — откроется страница со счётчиками видео этого партнёра по каждому сиджу.
  3. На странице Videos справа сверху — кнопка Ban videos, она ведёт на список уже созданных инструкций по этому партнёру.
  4. На странице списка справа сверху — кнопка Create, ей создаётся новая инструкция (бан или разбан).

Страница Videos — здесь же видно текущее состояние по каждому сайту (сколько видео активно, сколько забанено):

Список созданных инструкций по партнёру (кнопка Create — вверху справа):

Форма создания инструкции

ПолеЧто означаетОбязательноеЗначение по умолчанию
PercentДоля видео в процентах, к которой применится действие. Целое число от 1 до 100Дапусто (нужно ввести)
ActionЧто сделать: Ban — забанить (скрыть), Unban — разбанить (показать обратно)ДаBan
Percent baseОт чего считать процент — «от всех видео» или «от оставшихся». Подробности нижеДаPercent of all videos (от всех видео)

Ставить 0% нельзя (система откажет — такая инструкция ничего не сделает). Максимум — 100%.

От чего считается процент: «от всех видео» vs «от оставшихся»

Это самое важное поле, от него зависит результат.

Percent of all videos (от всех видео) — процент задаёт итоговую целевую долю в том состоянии, которое выбрано в Action:

  • Ban + 20% + от всех видео → на сайте после применения должно остаться забанено примерно 20% всего каталога партнёра. Если сейчас забанено меньше — довалит недостающее до 20%. Если уже забанено больше 20% — систем не даст сохранить такую инструкцию (см. раздел про ограничения ниже), потому что это фактически означало бы разбанить часть видео, хотя выбран Ban.
  • Unban + 100% + от всех видео → полностью снимает бан со всех видео партнёра (это самый частый способ «отменить всё и начать заново»).

Percent of remaining videos (от оставшихся) — процент берётся не от всего каталога, а только от той части, которая ещё не в нужном состоянии:

  • Для Ban — это процент от видео, которые сейчас ещё активны (не забанены). Например, если активно 417 видео и указать Ban 10% от оставшихся, будет дополнительно забанено ~10% именно от этих 417 (а не от всего каталога).
  • Для Unban — это процент от видео, которые сейчас ещё забанены. Указали Unban 10% от оставшихся — разбанится ~10% от текущего числа забаненных.

Этот режим только добавляет к текущему состоянию (добавляет в бан или добавляет в разбан) и никогда не «перескакивает» в обратную сторону — поэтому для него нет ограничения на минимальный процент, которое есть у режима «от всех видео» с Ban.

Что происходит после сохранения

  1. Сразу после нажатия Save админка создаёт инструкцию и ставит задачу на доставку на каждый подключённый и включённый сайт партнёра. Появится сообщение вида «Ban videos record created and queued for 2 of 2 site(s)» — сколько сайтов приняли задачу в очередь.
  2. Доставка на сайты происходит в фоне, не мгновенно на странице, но обычно занимает от пары секунд до нескольких минут — зависит от загруженности очереди и от того, доступен ли сайт партнёра в этот момент.
  3. Каждый сайт, применив инструкцию, присылает обратно актуальные цифры: сколько всего видео у партнёра на этом сайте и сколько из них сейчас забанено.
  4. Как понять, что инструкция применилась: открыть саму инструкцию (клик по её ID в списке) — там таблица по каждому сайту со статусом.

Пример уже доставленной инструкции (оба сайта — «Delivered»):

Статусы в таблице:

СтатусЗначение
Pendingещё в очереди, ждёт доставки на этот сайт
Deliveredсайт применил инструкцию, цифры получены
Failedсайт не смог применить (ошибка, недоступен и т.п.)
Skippedсайт пропущен (например, у него не настроен адрес админки)

Пример инструкции, где часть сайтов не применилась (Failed) — рядом с ними появляется кнопка Retry:

Если статус Failed — не обязательно делать что-то сразу: система сама повторяет попытку доставки в фоне (несколько раз в течение примерно суток). Если за это время ничего не изменилось и статус так и остался Failed — нажмите кнопку Retry на этой строке. Если и после ручного Retry не получается — стоит показать эту страницу разработчику (текст ошибки под статусом обычно подсказывает причину, например сайт временно недоступен).

Как посмотреть текущее состояние (сколько всего видео и сколько забанено)

Актуальные счётчики по партнёру (не по конкретной инструкции, а в целом) — на странице Videos этого партнёра (кнопка Videos со страницы партнёра). Там отдельная строка на каждый сайт: активно / забанено / всего / % забанено, плюс итоговая строка по всем сайтам партнёра, когда сайтов больше одного.

Note

Если партнёру ни разу не создавали инструкцию бана, на странице Videos может быть пусто — счётчики появляются после первой инструкции по этому партнёру или после автоматического ежедневного обновления счётчиков. Это нормально, ждать не нужно ничего специально делать.

Общего списка «все партнёры с процентом забаненного» с сортировкой по этому проценту в разделе Партнёрства сейчас нет — долю забаненных видео можно посмотреть только по одному партнёру за раз, на его странице Videos.

Как разбанить видео / изменить или отменить инструкцию

У инструкции нет редактирования и удаления — это разовая запись «что сделали в такой-то момент», её нельзя откорректировать задним числом. Если нужно изменить результат:

  • Чтобы разбанить всё — создать новую инструкцию: Action = Unban, Percent = 100, Percent base = Percent of all videos.
  • Чтобы разбанить только часть — новая инструкция с Action = Unban и нужным процентом (от всех видео — если знаете, какая итоговая доля забаненных должна остаться, или от оставшихся — если нужно снять бан с определённой доли именно от того, что сейчас забанено).
  • Отменить/удалить уже созданную (в том числе ошибочную) инструкцию нельзя — только «перекрыть» её новой с противоположным действием.

Ограничения и нюансы

  • Процент — только целое число от 1 до 100, дробные и отрицательные значения форма не примет.
  • Нельзя выбрать конкретные видео — только процент, дальше сайт сам решает, какие именно видео скрыть/показать.
  • Ban с базой «от всех видео» не даст указать процент меньше, чем уже забанено хотя бы на одном сайте — иначе это бы означало часть видео разбанить, хотя выбран Ban. В этом случае форма покажет ошибку прямо под полем Percent с подсказкой, какой минимальный процент допустим — либо увеличьте процент, либо используйте Unban.
  • Для Unban и для режима «от оставшихся» такого ограничения нет.
  • Порядок инструкций имеет значение: если создать подряд «Ban 10%» и «Unban 100%», применится именно в этом порядке — более новая инструкция может полностью перекрыть эффект предыдущей.
  • Доставка на разные сайты партнёра идёт независимо: одна инструкция может быть уже Delivered на одном сайте и всё ещё Pending/Failed на другом.

Типичные ошибки и что делать

«Percent must be at least N% — the least banned site already has X% of this partnership’s videos banned, so a smaller share would unban videos instead. Use the unban action for that.» Пример:

Значит: выбран Ban + «от всех видео», а указанный процент меньше, чем уже забанено на одном из сайтов. Решение — либо ввести процент не меньше подсказанного в сообщении, либо, если цель именно снизить долю бана, создать инструкцию с Action = Unban.

Статус Failed на одном или нескольких сайтах в карточке инструкции — сначала подождать (система повторяет попытки сама), затем нажать Retry на этой строке; если не помогает — обратиться к разработчику с этой страницей.

На странице Videos пусто / «No counts collected yet for this partnership» — по этому партнёру ещё не было ни одной инструкции и не прошло автоматическое ежедневное обновление; ничего делать не нужно, само появится.

Ошибка про формат процента (пустое поле / не целое число) — просто ввести целое число от 1 до 100.

🔗 Связанные заметки


Источник: внутренняя инструкция по панели admin.tubecrown.com, раздел Партнёрства → Videos → Ban videos.