Daten

Videometriken

Mave-Metriken helfen Ihnen, die Videonutzung zu verstehen, ohne Cookies oder besuchsübergreifendes Tracking. Analytics sind in Mave Core integriert und sowohl in verwaltetem Mave als auch in selbstgehosteten Installationen verfügbar.

Verwaltet oder selbstgehostet

Bei verwaltetem Mave betreiben wir die Plattform und die Analytics-Infrastruktur für Sie. Öffnen Sie Data in Ihrem Dashboard, um Ihre Videometriken einzusehen.

Wenn Sie Mave Core selbst hosten, laufen Analytics zusammen mit Dashboard, Uploads, Encoding und API. Das Docker-Compose-Paket enthält ClickHouse für die Speicherung der Analytics. Sie müssen die frühere eigenständige Metrikanwendung nicht installieren.

Funktionsweise

Der Player erfasst Wiedergabeereignisse mit einer zufällig generierten Sitzungs-ID. Ereignisse enthalten unter anderem Video, Wiedergabeposition, Zeitstempel und Quell-URL. Eine neue Player-Sitzung erhält eine neue ID; diese identifiziert keine Person über mehrere Besuche hinweg.

Der @maveio/data-Client puffert Ereignisse und sendet JSON-Batches per HTTP POST an /v1/events. Während der Wiedergabe werden gepufferte Ereignisse normalerweise alle fünf Sekunden gesendet oder früher, wenn ein Batch voll ist. Wird die Seite ausgeblendet oder geschlossen, versucht der Client, verbleibende Ereignisse mit sendBeacon oder fetch mit keepalive zu senden. Die Zustellung beim Verlassen einer Seite ist nicht garantiert; das letzte Ereignis kann fehlen.

Metriken konfigurieren

Metriken sind standardmäßig aktiviert. Behalten Sie für verwaltetes Mave den Standardendpunkt bei. Verwenden Sie für selbstgehostetes Core den von Ihrer Installation generierten Embed, damit die Konfiguration auf Ihre eigenen Dienste verweist.

Wenn Sie Webkomponenten manuell konfigurieren, setzen Sie vor der Initialisierung der Wiedergabe metrics.endpoint auf die vollständige HTTP-URL für den Ereignisempfang:

<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>

Ersetzen Sie video.example.com durch den Hostnamen Ihrer Core-Installation. Dieses Beispiel ändert nur das Ziel der Metriken; es konfiguriert nicht die API- oder Medien-URLs für eine vollständige selbstgehostete Player-Integration. Verwenden Sie dafür den von Ihrer Installation generierten Embed als Ausgangspunkt.

Um Metriken für so konfigurierte Komponenten zu deaktivieren, setzen Sie vor der Initialisierung der Wiedergabe:

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

Diese Komponenten senden dann keine Wiedergabeereignisse mehr. Bestehende Analytics bleiben verfügbar; neue Wiedergaben dieser Komponenten erscheinen nicht im Dashboard.

Verfügbare Einblicke

• Wiedergaben: sehen Sie, wie oft Ihre Videos im Zeitverlauf angesehen werden.
• Quellen: sehen Sie, welche Seiten oder Websites Wiedergaben erzeugen.
• Engagement: sehen Sie, welche Teile eines Videos angesehen werden und wo Zuschauer abspringen.

Ereignisse werden in Batches gesendet. Warten Sie daher einige Sekunden, bis neue Aktivitäten im Dashboard erscheinen.

Selbst hosten

Betreiben Sie die vollständige Open-Source-Plattform Mave Core einschließlich Analytics auf Ihrer eigenen Infrastruktur. Core enthält den Ereignisendpunkt und ClickHouse-Speicher. Folgen Sie der Self-Hosting-Anleitung für den Einstieg.