Gegevens

Videometrics

Met Mave metrics krijg je inzicht in videogebruik zonder cookies of kijkers tussen bezoeken te volgen. Analytics zijn ingebouwd in Mave Core en beschikbaar in zowel beheerd Mave als zelfgehoste installaties.

Beheerd of zelfgehost

Bij beheerd Mave verzorgen wij het platform en de analyticsinfrastructuur voor je. Open Data in je dashboard om je videometrics te bekijken.

Als je Mave Core zelf host, draaien analytics naast je dashboard, uploads, encoding en API. De Docker Compose-bundel bevat ClickHouse voor de opslag van analytics. Je hoeft de voormalige losse metricsapplicatie niet te installeren.

Hoe het werkt

De speler registreert afspeelevents met een willekeurig gegenereerd sessie-ID. Events bevatten onder meer de video, afspeelpositie, het tijdstip en de bron-URL. Een nieuwe spelersessie krijgt een nieuw ID; dit identificeert geen persoon tussen bezoeken.

De @maveio/data-client buffert events en verstuurt JSON-batches via HTTP POST naar /v1/events. Tijdens het afspelen worden events normaal elke vijf seconden verstuurd, of eerder wanneer een batch vol is. Wanneer de pagina verborgen wordt of sluit, probeert de client de resterende events via sendBeacon of fetch met keepalive te versturen. Aflevering bij het verlaten van een pagina is niet gegarandeerd: het laatste event kan ontbreken.

Metrics instellen

Metrics staan standaard aan. Behoud voor beheerd Mave het standaardendpoint. Gebruik voor zelfgehoste Core de embed die je installatie genereert, zodat de configuratie naar je eigen services verwijst.

Configureer je webcomponenten handmatig, stel dan vóór het initialiseren van de weergave metrics.endpoint in op de volledige HTTP-URL voor het ontvangen van events:

<script crossorigin type="module">
  import { Player, setConfig } from "https://cdn.video-dns.com/npm/@maveio/components/+esm";

  setConfig({
    metrics: {
      enabled: true,
      endpoint: "https://video.example.com/v1/events",
    },
  });
</script>

Vervang video.example.com door de hostnaam van je Core-installatie. Dit voorbeeld wijzigt alleen de bestemming van metrics; het configureert niet de API- of media-URL’s voor een volledige zelfgehoste spelerintegratie. Gebruik daarvoor de embed die je installatie genereert als uitgangspunt.

Wil je metrics uitschakelen voor componenten die zo geconfigureerd zijn, stel dit dan in vóór het initialiseren van de weergave:

setConfig({ metrics: { enabled: false } });

Deze componenten versturen dan geen afspeelevents meer. Bestaande analytics blijven beschikbaar; nieuwe weergaven vanuit deze componenten verschijnen niet in het dashboard.

Beschikbare inzichten

• Weergaven: bekijk hoe vaak je video’s in de loop van de tijd worden bekeken.
• Bronnen: bekijk welke pagina’s of sites voor weergaven zorgen.
• Betrokkenheid: bekijk welke delen van een video worden bekeken en waar kijkers afhaken.

Events worden in batches verstuurd. Geef nieuwe activiteit daarom een paar seconden om in het dashboard te verschijnen.

Zelf hosten

Draai het volledige open-source Mave Core-platform, inclusief analytics, op je eigen infrastructuur. Core bevat het endpoint voor events en ClickHouse-opslag. Volg de handleiding voor zelf hosten om te beginnen.