Bradmax Analytics

This document provides an overview of how analytics data are send to and processed by Bradmax.

Error Response Format

BE provides data for FE player contentMeta (see: https://bradmax.com/static/player-doc/dataprovider.html#contentMeta-object)

In BE code, it is dode in app/serializers/api/v3/client/ott/event_serializer.rb, under metadata attribute.

Handling on Bradmax side (PL):

Przepływ danych:

1. Aplikacja Web/Flutter pobiera z backendu informacje o materiale jak: URL do strumienia, tytuł, identyfikator, długość (dla powtórek), oraz tagi.
2. Aplikacja Web/Flutter wyświetla player oraz przekazuje mu powyższe metadane o materiale. Dane są trzymane, ale jeszcze nigdzie nie wysyłane.
3. Użytkownik startuje odtwarzanie materiału. Po wystartowaniu wysyłane jest zdarzenie ze metadanymi materiału na adress https://stats.bradmax.com/* i zliczane jest rozpoczęcie oglądania. Liczone jako jeden "Views".
4. Podczas oglądania materiału zbierane są dane które sekundy materiału zostały odtworzone użytkownikowi. Tak zebrane dane oglądania są wysyłane co 60 sec, lub na akcję użytkownika (np seeking) lub na zamknięcie playera.
Spójność i aktualizacja danych:
- Dane na temat materiału przesyłane są tylko podczas oglądania materiału.
- To co identyfikuje materiał to jego unikalne ID. To nie może się zmieniać dla materiału. Pozostałe metdata mogą być aktualizowane, a system powinien się dostosować.
- Jeśli metadane materiału zostaną zaktualizowane po stronie serwisu (np. korekta tytułu, tagów) nie będą od razu widoczne w syatystykach.
-- Muszą zostać wysłane razem ze startem odtwarzania materiału.
-- Statystyki Bramdax przy każdym odtworzeniu sprawdzają spójność metadatnych otrzymanych z nowymi. Wybierane są te które przychodzą częściej.
np. 10 odtworzeń było dla Tytuł1, wówczas aby zaktualizować go musi być conajmniej 11 odtworzeń z "Nowy Tytuł 1", aby zaktualizować go w systemie.
- Obecnie dla Tisa dane są tylko przesyłane podczas odtwarzania video. Dla tego po zakończeniu wydarzenia Live aktualizacja metadanych nie będzie miała efektu, bo nikt już nie będzie go oglądał i zaktualizowane dane nie są przesyłane.
- Możliwa jest aktualizacja metadanych bezpośrednio w systemie Bradmax dla przeszłych wydażeń Live, starych materiałów VOD, jednak nie została ona wdrożona dla Tisy (konieczność dodatkowej integracji).