Аналитика

Аналитика Kinescope собирает данные об общем количестве просмотров и загрузок плеера, глубине просмотра, географии аудитории, платформах, ОС и браузерах зрителей. Эти данные помогают понять, как аудитория взаимодействует с вашим контентом, и оптимизировать стратегии работы с видео.

Кому подходит эта статья

• Маркетологам — нужно отслеживать эффективность видеоконтента и анализировать поведение аудитории
• Контент-менеджерам — требуется понять, какие видео популярны и почему
• Разработчикам — нужно интегрировать аналитику в свои системы через API
• Создателям курсов — требуется отслеживать прогресс учащихся и вовлечённость

Доступ к аналитике

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

• Для конкретного видео

  • Откройте каталог, найдите нужное видео и дважды кликните по его названию.
  • Перейдите на вкладку «Аналитика».

  

• Для всех видео в рабочей зоне

  • Кликните на иконку «Аналитика» в левом меню: она доступна из любой части платформы.

  

Общая аналитика также включает топ-25 самых популярных видео. Найти её можно в конце страницы.

Ключевые метрики

Просмотры Отображает количество запусков видео. Просмотр засчитывается после 5 секунд непрерывного воспроизведения.

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

Процент просмотра

Метрика условно отражает интерес к видео, эффективность размещения плеера или привлекательность постера.

• График: соотношение просмотров к загрузкам плеера.
• Процент: общее отношение всех просмотров ко всем загрузкам плеера за всё время. На скриншоте вверху 20 просмотров/85 загрузок = 24% (процент округляется в большую сторону).

Уникальные показы Плеер запоминает сессию на устройстве и считает уникальность по ней.

Вовлеченность или глубина просмотра Показывает среднее время просмотра (сколько минут пользователь посмотрел из всего видео) и изменение этого значения за выбранный интервал времени.

Просмотр считается в рамках одной сессии: за сессию можно просмотреть видео несколько раз, но это будет засчитано как один просмотр.

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

Эта метрика демонстрирует, насколько контент качественный, а значит, способен удержать внимание зрителей.

Популярные страны, платформы и ОС Данные о просмотрах по странам, платформам (десктоп, планшет, смартфон) и операционным системам.

Расширенная аналитика для разработчиков

Для более глубокого анализа и интеграции аналитики в ваши системы доступны два подхода:

IFrame Player API — для клиентской аналитики

IFrame Player API помогает собирать события на стороне клиента и отправлять их в вашу аналитику вместе с контекстом (например, ID пользователя, курс, урок, устройство, браузер). Обычно это используют, если нужно:

• В LMS — отслеживать прогресс, время просмотра и повторные просмотры.
• В интерактивных сценариях — понимать, как пользователи взаимодействуют с видео (паузы, перемотки и т.д.).
• В корпоративных порталах — логировать активность сотрудников вокруг видеоконтента.
• В интеграциях — передавать события в ваши системы аналитики, CRM или LMS.

Через IFrame Player API вы можете учитывать не только просмотры, но и подробные события (паузы, перемотки, повторные просмотры) и реагировать на них в реальном времени.

Подробнее о возможностях IFrame Player API читайте в статье «IFrame Player API».

REST API аналитики

Все аналитические данные также доступны через REST API. Возможности включают:

• Сортировку данных по дате, идентификатору видео
• Индивидуальную группировку по полям и параметрам
• Получение статистики за любой период времени

API аналитики (для разработчиков):

Общая статистика за период:

curl -X GET "https://api.kinescope.io/v1/analytics/overview?from=2024-01-01&to=2024-01-31" \
  -H "Authorization: Bearer ${KINESCOPE_API_TOKEN}"

Параметры запроса:

• from (обязательный) — начало периода в формате YYYY-MM-DD или YYYY-MM-DDTHH:MM:SSZ (RFC3339)
• to (обязательный) — конец периода в формате YYYY-MM-DD или YYYY-MM-DDTHH:MM:SSZ (RFC3339)
• project_id (опционально) — фильтр по проекту
• video_id (опционально) — фильтр по видео

Детализированная статистика с группировкой:

curl -X GET "https://api.kinescope.io/v1/analytics?from=2024-01-01&to=2024-01-31&group_by=video_id&order=views.desc&per_page=10" \
  -H "Authorization: Bearer ${KINESCOPE_API_TOKEN}"

Параметры запроса:

• from (обязательный) — начало периода в формате YYYY-MM-DD или YYYY-MM-DDTHH:MM:SSZ
• to (обязательный) — конец периода в формате YYYY-MM-DD или YYYY-MM-DDTHH:MM:SSZ
• group_by (обязательный) — группировка данных. Доступные значения:
  • video_id — по видео
  • project_id — по проекту
  • date — по дням
  • country — по странам
• project_id (опционально) — фильтр по проекту
• video_id (опционально) — фильтр по видео
• page (опционально) — номер страницы (по умолчанию 1)
• per_page (опционально) — элементов на странице (по умолчанию 10)
• order (опционально) — сортировка в формате field.direction (например, views.desc). Подробнее о сортировке в общих правилах API

Обработка ошибок:

При неверных параметрах API вернёт ошибку валидации с кодом 400400. Например, если не указать обязательные параметры from или to, или указать недопустимое поле для сортировки (код 400216). Подробнее об обработке ошибок в общих правилах API.

Дополнительную ценность можно получить, если связать данные о просмотрах в плеере с пользовательскими сессиями. Такой подход позволяет собирать аналитику не только вокруг видео, но и в вокруг конкретных зрителей.

Чтобы персонализировать аналитику, встраивайте плеер с использованием IFrame API, а при создании плеера на странице передавайте идентификатор пользователя (например, почту или ID) через параметр externalId.

Что дальше?

После изучения аналитики рекомендуем:

1. Оптимизировать контент — используйте данные аналитики для улучшения постеров и описаний
2. IFrame Player API — используйте IFrame Player API для расширенной аналитики с обогащением данных контекстной информацией
3. Настроить интеграцию с аналитикой — подключите аналитику к вашим системам через REST API
4. Встраивание — настройка плеера для сбора аналитики

Остались вопросы? Напишите в чат поддержки — специалисты помогут!