DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Tracking der Erlebnisqualität in Chromecast track-quality-of-experience-on-chromecast

Last update: Mon Jul 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Benutzende
  • Admin
  • Entwickler

Mit den folgenden Anweisungen können Sie die Implementierung der 2.x-SDKs vornehmen.

IMPORTANT
Wenn Sie Version 1.x des SDK implementieren möchten, können Sie hier die 1.x-Entwicklerhandbücher herunterladen: SDKs herunterladen.

Überblick overview

Das Tracking der Erlebnisqualität (QoE) beinhaltet Servicequalität (QoS) und Fehler-Tracking. Diese beiden Elemente sind optional und nicht für die Implementierung des Core-Medien-Tracking erforderlich. Sie können die Medienplayer-API verwenden, um die Variablen für QoS- und Fehler-Tracking zu ermitteln.

Player-Ereignisse player-events

Bei allen Ereignissen zu Bitratenänderungen

  • Erstellen/aktualisieren Sie die QoS-Objektinstanz für die Wiedergabe, qosObject.
  • Aufruf trackEvent(Media.Heartbeat.Event.BitrateChange, qosObject);

Bei Player-Fehlern

Aufruf trackError("media error id");

Implementierung implement

  1. Ermitteln Sie, wann sich die Bitrate während der Medienwiedergabe ändert, und erstellen Sie die MediaObject-Instanz mithilfe der QoS-Informationen.

    QoSObject-Variablen:

    note tip
    TIP
    Diese Variablen sind nur erforderlich, wenn Sie die Servicequalität (QoS) verfolgen möchten.
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center
    Variable Beschreibung erforderlich
    bitrate Aktuelle Bitrate Ja
    startupTime Startzeit Ja
    fps FPS-Wert Ja
    droppedFrames Anzahl der Dropped Frames Ja

    Erstellung von QoS-Objekten: createQoSObject

    code language-none 
    qosInfo = ADBMobile.media.createQoSObject(50000, 0, 24, 10);

  2. Wenn sich die Bitrate der Wiedergabe ändert, rufen Sie das BitrateChange-Ereignis in der Media Heartbeat-Instanz auf: trackEvent

    code language-none 
    ADBMobile.media.trackEvent(ADBMobile.media.Event.BitrateChange);
    note important
    IMPORTANT
    Aktualisieren Sie das QoS-Objekt und rufen Sie das Ereignis zur Bitratenänderung bei jeder Bitratenänderung auf. So erhalten Sie möglichst präzise Daten.

  3. Stellen Sie sicher, dass die getQoSObject()-Methode die neuesten QoS-Informationen zurückgibt.

  4. Wenn im Medienplayer ein Fehler auftritt und das Fehlerereignis der Player-API zur Verfügung steht, verwenden Sie trackError(), um die Fehlerinformationen zu erfassen. (Siehe Übersicht.)

    note tip
    TIP
    Das Tracking von Fehlern im Medienplayer stoppt die Medien-Tracking-Sitzung nicht. Wenn der Medienplayer-Fehler verhindert, dass die Wiedergabe fortgesetzt wird, müssen Sie sicherstellen, dass die Medien-Tracking-Sitzung geschlossen wird. Rufen Sie dazu trackSessionEnd() nach trackError() auf.
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb