Документация по эксплуатации

Руководство пользователя VP Cloud

«Программный модуль для видео-платформы VPCLOUD для осуществления оплат в мобильной коммерции»: от регистрации на платформе до аналитики подписок.

Введение

«Программный модуль для видео-платформы VPCLOUD для осуществления оплат в мобильной коммерции» является независимым микросервисом (надстройкой) над платформами контент-провайдеров в сети Интернет.

В данном руководстве его работа продемонстрирована на примере платформы Video Publisher Cloud — платформы для хранения, управления, монетизации и распространения видеоконтента. Платформа предоставляет все необходимые инструменты для загрузки, конвертации, монетизации и дистрибуции видео, делая процесс максимально удобным и эффективным, а программный модуль оплат в мобильной коммерции расширяет возможности монетизации пользователей.

В инструкции подробно описаны процесс регистрации, загрузки видео, возможные способы монетизации и дистрибуции видеоконтента.

Взаимодействие с модулем на примере видеоплатформы

Video Publisher Cloud — это многофункциональная платформа для размещения, управления и распространения видеоконтента: от личных видеоблогов и профессиональных видеофильмов до обучающих курсов. Ключевые характеристики платформы:

  • Управление контентом. Инструменты для редактирования видео, управления метаданными и настройки распространения. Видео можно таргетировать на разные страны и разные сайты внутри платформы.
  • Управление подписками. Создание, настройка и управление подписками: гибкая тарификация, автоматическое продление, пауза, отмена и переход между уровнями подписок — модель подписки легко адаптируется под бизнес-цели и потребности аудитории.
  • Монетизация. Различные способы монетизации видеоконтента: рекламные блоки, подписки и платный контент.
  • Аналитика. По каждому видео собирается детализированная статистика о просмотрах, аудитории и доходах.

Регистрация и вход

Регистрация

Шаги для создания учётной записи на платформе:

  1. Написать на почту support@orm-media.online или заполнить заявку.
  2. Когда заявка на регистрацию получена, менеджеры связываются с вами для получения более детальной информации.
  3. После общения с менеджером платформы заявку одобрят, и вы получите доступ на платформу: данные для авторизации придут ответным письмом.

Вход

  1. Перейти на страницу videopublisher.pro/admin.
  2. Ввести адрес электронной почты.
  3. Ввести пароль.
  4. Нажать кнопку «Войти».

Если данные введены корректно, вы попадёте на главную страницу платформы. В случае ошибки появится сообщение со всей информацией для исправления ситуации.

Восстановление доступа

Если вы не помните адрес электронной почты или пароль, напишите на support@orm-media.online — мы свяжемся с вами и поможем восстановить доступ.

Создание подписки

Модуль оплат отвечает за управление тарифами, подписками и платежами в системе. Он включает модели для хранения информации о тарифах, оплатах, подписках, разрешениях на доступ и интеграции с различными платёжными шлюзами.

Перед созданием подписки нужно провести подготовительную работу и загрузить список контента, к которому будет предоставляться доступ, — от ручного добавления контента до автоматической загрузки большого объёма. Основные шаги:

  1. Создание корзины контента.
  2. Создание тарифа.
  3. Создание и привязка тарифа к корзине контента.
В данном руководстве предполагается, что библиотека контента уже добавлена в систему.

Создание тарифа

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

  • рекуррентными — повторные платежи без участия пользователя — или разовыми (один раз заплатил и всё);
  • приватными (is_private=True) — недоступны в публичном интерфейсе.

Тарифы связаны с корзинами, которые группируют их для управления — например, для отображения разных наборов тарифов на сайте. Контент привязан к корзине, а к корзине привязываются разные тарифы.

Тарифы взаимодействуют с другими сущностями: для каждого тарифа может быть создан платёж. Платёж создаётся на основании выбранного пользователем тарифа, и при успешной оплате создаётся подписка или пользователь получает доступ к услугам.

Примеры сценариев

  • Разовый платёж: пользователь платит 100 рублей за доступ к контенту на 7 дней.
  • Рекуррентный платёж: пользователь подписывается на ежемесячную услугу стоимостью 500 рублей.

Если в настройках тарифа указан флаг подписки (is_subscription=True), то после успешной оплаты:

  • создаётся подписка с привязкой к тарифу;
  • состояние подписки устанавливается в ACTIVE;
  • подписка может быть отменена через шлюз или администратором.

Через тариф можно явно указать, каким образом платёж будет обработан на клиенте и через какого провайдера. Поддерживаются различные провайдеры (CloudPayments, YooMoney и др.) — тарифы привязываются к ним через поле payment_provider.

Основные ограничения

  • Тарифы не могут быть изменены после создания, если они уже используются.
  • Приватные тарифы недоступны в общем каталоге.
  • Удаление тарифа невозможно, если он используется в активных подписках.

Создание корзины контента

Корзина контента — объект, который объединяет список видео, сериалов, ТВ-каналов и других типов контента, доступных пользователю после оплаты тарифа или активации подписки. Корзина служит связующим звеном между тарифом и предоставлением доступа к контенту.

Основные функции корзины

  • Список продуктов. Корзина включает перечень доступного контента (фильмы, сериалы и другие продукты), который гибко настраивается для каждого пакета — можно формировать бандлы под разные категории пользователей.
  • Срок жизни корзины. Для каждой корзины устанавливается срок действия (например, месяц, год или до завершения лицензионных прав). После истечения срока доступ пользователя к контенту автоматически приостанавливается.
  • Информация для личного кабинета. Корзина предоставляет пользователю в личном кабинете состав корзины (список доступных продуктов) и базовую информацию о ней.
  • Тип корзины. Возможные типы доступа: paid — доступ к списку контента; ad_free — доступ ко всему контенту без рекламы.
  • Гибкость настройки. Привязка корзины к конкретному приложению, настройка и привязка разных тарифов, интеграция с промокодами для активации корзины.

Связи компонентов

При покупке тарифа, привязанного к корзине, пользователю генерируется PlayPermission — объект, который связывает факт оплаты тарифа с корзиной контента и подтверждает права доступа к воспроизведению. Это ключевой элемент авторизации на уровне контентной доставки (CDN), необходимый для доступа к платному контенту.

Функциональность

  • Связь оплаты и контента. При покупке тарифа, связанного с корзиной, автоматически создаётся PlayPermission: он фиксирует, что пользователь оплатил доступ и имеет право воспроизведения контента из корзины.
  • Авторизация на уровне CDN. При инициализации плееру передаётся PlayPermission, и он предъявляет его при запросе контента из корзины. Система проверяет валидность PlayPermission на уровне CDN: если разрешение действительно — пользователь получает доступ к просмотру, иначе контент остаётся заблокированным.
  • Отслеживание активности. PlayPermission фиксирует факт начала просмотра — это позволяет учитывать использование контента по подписке для аналитики и управления тарифами.

Сценарий использования

  1. Пользователь покупает подписку, связанную с корзиной контента.
  2. Система генерирует PlayPermission, связывая его с соответствующим тарифом и корзиной.
  3. Пользователь выбирает контент для просмотра в плеере.
  4. Плеер отправляет запрос на сервер за контентом; система для проверки получает PlayPermission.
  5. Сервер авторизует запрос через CDN: если разрешение действительно — контент доступен для воспроизведения; если отсутствует или истекло — плеер уведомляет пользователя о необходимости оплаты.
  6. Пользователь начинает просмотр, что фиксируется в системе.

Особенности

  • Без валидного PlayPermission пользователь не сможет воспроизвести платный контент.
  • Объект обеспечивает соблюдение условий подписки, предотвращение несанкционированного доступа и точный учёт использования контента.
  • Интеграция с CDN обеспечивает высокую скорость проверки разрешений и минимальную задержку при предоставлении доступа.

Управление подпиской

Жизненный цикл подписки — последовательность состояний, через которые проходит подписка пользователя от создания до завершения: активация, управление, продление и завершение.

Этапы жизненного цикла

Создание подписки:

  1. Пользователь выбирает корзину контента, подходящий тариф и оформляет подписку через сайт или мобильное приложение.
  2. После подтверждения оплаты создаётся объект подписки с её параметрами: срок действия, стоимость, ограничения и доступ к контенту.
  3. Пользователь получает доступ к контенту подписки через генерацию соответствующего PlayPermission.

Активация подписки. После успешной оплаты подписка переходит в статус ACTIVE, и пользователю предоставляется доступ к контенту.

Использование подписки. Пользователь воспроизводит контент в рамках параметров подписки (корзина контента, приложение). Система фиксирует действия пользователя: просмотр контента, паузу или отмену подписки.

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

Аналитика и статистика

Система аналитики подписок собирает и анализирует данные о статусах подписок пользователей, их поведении на платформе и ключевых метриках. Эти данные дают инсайты для оптимизации бизнес-процессов, повышения удержания пользователей и улучшений.

  • Данные по подпискам. Для каждого пользователя фиксируются все изменения статусов подписок, что позволяет отслеживать жизненный цикл и поведение: активные подписки, отмена или продление, ошибки платежей и их устранение.
  • Интеграция с BI-системами. Все данные подписок можно экспортировать в вашу BI-систему (например, Tableau, Power BI, Looker) для дальнейшей обработки и кастомизированных отчётов.
  • Доступ к данным через Redash. Готовая инфраструктура анализа с преднастроенными дашбордами: метрики удержания (Retention Rate), конверсии в платные подписки, причины отказов (отмены, ошибки списаний), динамика подписок в разных разрезах.
  • Запрос доступа. Для получения доступа к данным или настройки дополнительных дашбордов обратитесь к вашему менеджеру.

Если есть потребность в улучшении или добавлении функционала, обратитесь в отдел продаж: info@orm-media.online.

Поддержка и обратная связь

Чтобы связаться с технической поддержкой платформы, напишите на support@orm-media.online.

Если вы нашли проблему или видите ошибку при работе с платформой, сообщите нам об этом по форме обратной связи. В сообщении укажите скриншот, данные по устройству и удобный способ для обратной связи.

Контакты

Отдел продажinfo@orm-media.online
Техническая поддержкаsupport@orm-media.online
Монетизация и рекламаinfo@orm-media.online