Интеграция с MiStats

Инструкцию по установке и настройке MiStats можно найти тут.

В админке Smarty представлен базовый функционал MiStats, а именно — статистика по просмотрам каналов и передач в разделе «Статистика». Этот функционал ранее была реализован с рамках устаревшего модуля ViewStats, работающего на MongoDB, и сохранён в админке ради совместимости.

Статистика смотрения фильмов и сериалов, а также остальной функционал MiStats доступен в отдельной панели администрирования.

В данном разделе представлен функционал по просмотру статистики для каждого отдельно взятого канала. Функционал удобен для формирования ответа для правообладателя на тему телесмотрения отдельно взятого канала, а также сравнения с остальными каналами в его нише.

Пример готового отчёта по каналу:

Помимо получения численных метрик доступно построение рейтингов с участием данного канала относительно других в различных разрезах, а также график просмотров телеканала в разрезе дней.

В отдельной вкладке с рейтингом телеканалов доступно построение графиков в разрезе категорий, тарифов и устройств. Данные рейтинги уже более полезны для выявления общих лидеров телесмотрения в сервисе для принятия продуктовых решений оператором: о запуске рекламы, об удалении несмотрибельных каналов из сервиса и других.

Готовый график отображается в админке, а также доступен для выгрузки в csv- и xlsx-файлы.

Функционал аналогичен предыдущему, но строит график уже непосредственно по телесмотрению передач: как в Live, так и в записи.

Результаты также можно выгрузить в табличные файлы.

MiStats позволяет автоматически создавать подборку на основе полученной статистики:

При выполнении данной команды создается сортировка каналов на основании статистики телесмотрения, исходя из указанных параметров в команде.

Необходимые параметры для выполнения данной команды:

--client_id – список идентификаторов клиентов, через запятую, для которых нужно провести кеширование;

--days_number — количество дней, в течение которых стоит учитывать телесмотрение;

--criterion — характеристика, по которой оценивать популярность. Возможные значения:
watch_time — по общему времени просмотра канала;
watch_sessions — по количеству включений канала;
average_watch_time — по среднему времени просмотра канала;
median_watch_time — по медианному времени просмотра канала.

Дополнительные параметры команды:
--devices — список устройств, для которых стоит учитывать статистику телесмотрения (передаются системные имена устройств, по умолчанию — все);
--tariffs — список тарифов для которых стоит учитывать статистику телесмотрения (передаются идентификаторы тарифов, по умолчанию — все);
--accounts_active — учитывать статистику только с активных аккаунтов.

Параметры:
--client_id – данный параметр обязателен и определяет идентификатор Client, для которого будет создана подборка.
--days_number – данный параметр обязателен и определяет количество дней, в течение которых стоит учитывать телесмотрение.
--criterion – данный параметр обязателен и определяет характеристику, по которой будет создана подборка. Возможные значения: watch_time (общее время просмотра каналов), watch_sessions (количество сессий просмотра каналов), average_watch_time (среднее время просмотра каналов), median_watch_time (медианное время просмотра).
--devices – параметр для создания подборки по определенным устройствам (по умолчанию подборка создается по всем устройствам).
--accounts_active – параметр позволяет создать подборку только на основе активных аккаунтов. Возможные значения: true, false. По умолчанию false.
--tariffs – выборка определенных тарифов для создания подборки (по умолчанию учитываются все тарифы).
--selection_size – параметр определяет размер создаваемой подборки. При отсутствии информации о достаточном количестве каналов происходит добавление каналов без статистики до нужного количества. По умолчанию 17.

Пример использования команды:

Создание для Client=1 подборки недельных популярных каналов по времени просмотра:

smarty_manage create_channel_selection_by_popularity —client_id=1 —days_number=7 —criterion=watch_time —settings=settings.<settings name>

Параметры:
--client_id – данный параметр обязателен и определяет идентификатор Client, для которого будет создана подборка.
--days_number – данный параметр обязателен и определяет количество дней, в течение которых собирается информация по передачам.
--devices – параметр для создания подборки по определенным устройствам (по умолчанию подборка создается по всем устройствам).
--tariffs – выборка определенных тарифов для создания подборки (по умолчанию учитываются все тарифы).
--selection_size – параметр определяет размер создаваемой подборки. При отсутствии информации о достаточном количестве передач происходит добавление передач без статистики до нужного количества. По умолчанию 17.
--categories – параметр для создания подборки по определенным категориям каналов (по умолчанию учитываются все категории), id категорий можно увидеть в разделе Настройки контента — Категории ТВ.
--channels – учитываются передачи только тех каналов, id которых указаны в данном параметре.
--selection_name – название подборки. Если не указано, то подборка будет иметь название «Название подборки $days_number ($selection_size)».

Пример использования команды:

Создание подборки 27 популярных передач для Client=1 за 30 дней с категориями «Детские» (id=2) и «Познавательные» (id=7):

Команда:

Команда создаёт подборку популярных видео из архивной видеотеки на основании телесмотрения пользователей.

Обязательные параметры:

--client_id – определяет идентификатор Client, в рамках которого будет произведено формирование подборки.

--days_number – количество дней, за которые берется статистика телесмотрения.

Необязательные параметры:

--channels – список каналов, по передачам которых учитывается статистика телесмотрения.

--categories — список категорий каналов, по передачам которых учитывается статистика телесмотрения.

--selection_size — максимальное количество контента в подборке. По умолчанию 17.

--selection_name — название подборки. По умолчанию «Популярные фильмы X (Y)» или «Popular videos X (Y)», где X — значение days_number, а Y — selection_size.

--exclude_epg_channels_ids – идентификаторы EPG-каналов (EpgChannel), контент которых нужно исключить из подборки. Можно указать несколько раз, например: --exclude_epg_channels_ids=1 --exclude_epg_channels_ids=2. В подборку не попадут архивные видео, у которых хотя бы один ассет связан с передачей исключённого EPG-канала.

--selection_id – идентификатор существующей подборки. Если параметр указан, команда обновляет контент этой подборки: название не меняется, меняется только состав. Если подборки с таким идентификатором нет, команда завершится с ошибкой. Если одновременно переданы --selection_id и --selection_name, приоритет у --selection_id. Если параметр не указан, поведение прежнее: создаётся новая подборка (или обновляется подборка с тем же названием).

Пример использования команды:

MiStats позволяет автоматически создавать подборки фильмов и сериалов на основе статистики видеосмотрения.

Команда:

Команда создаёт подборку популярных фильмов и/или сериалов на основании статистики видеосмотрения пользователей. Для работы команды необходим модуль статистики видеосмотрения MiStats.

Обязательные параметры:

--client_id – идентификатор Client, для которого будет создана подборка.

--days_number – количество дней, за которые берётся статистика видеосмотрения.

--criterion – характеристика, по которой оценивается популярность. Возможные значения:
watch_time — по общему времени просмотра;
sessions — по количеству запусков;
average_watch_time — по среднему времени просмотра;
median_watch_time — по медианному времени просмотра.

Для сериалов метрики считаются иначе, чем для фильмов: общее, среднее и медианное время просмотра берутся как среднее значение среди серий. Количество запусков (sessions) — это количество уникальных абонентов, которые посмотрели хотя бы одну серию сериала.

Необязательные параметры:

--is_series – тип контента в подборке. Возможные значения: 1 — только сериалы, 0 — только фильмы. Если параметр не указан, в подборку попадают и фильмы, и сериалы.

--tariffs – список тарифов, по которым учитывается видеосмотрение. Можно указать несколько раз, например: --tariffs=1 --tariffs=2. По умолчанию учитываются все тарифы.

--selection_size – максимальное количество единиц контента в подборке. По умолчанию 17.

--selection_name – название создаваемой подборки.

--selection_id – идентификатор существующей подборки. Если параметр указан, команда обновляет контент этой подборки: название не меняется, меняется только состав. Если подборки с таким идентификатором нет, команда завершится с ошибкой. Если одновременно переданы --selection_id и --selection_name, приоритет у --selection_id. Если параметр не указан, поведение прежнее: создаётся новая подборка (или обновляется подборка с тем же названием).

Пример использования команды:

Создание для Client=1 подборки популярных фильмов за 7 дней по общему времени просмотра:

Создание подборки популярных сериалов по количеству уникальных зрителей:

Обновление конкретной подборки по идентификатору (название подборки не изменится):