Tracking von Core-Wiedergaben in Chromecast

Diese Dokumentation behandelt das Tracking in der Version 2.x des SDK.

1. Tracking-Ersteinrichtung

   Identifizieren Sie, wenn der Benutzer die Wiedergabe auslöst (Benutzer klickt auf „Abspielen“ und/oder die automatische Wiedergabe ist aktiviert), und erstellen Sie eine MediaObject-Instanz.

   MediaObjectAPI-Referenz:

   createMediaObject

   mediaObject = ADBMobile.media.createMediaObject(<name>, <id>, <duration>, <streamType>, <mediaType>);
   

   StreamType-Konstanten:

   ADBMobile Media

   MediaType-Konstanten:

   ADBMobile Media

2. Video-Metadaten anhängen

   Optional können Standard- bzw. benutzerdefinierte Video-Metadatenobjekte über Kontextdatenvariablen an die Video-Tracking-Sitzung angehängt werden.

   • Standard-Video-Metadaten

     Standard-Metadaten in Chromecast implementieren

     HINWEIS

     Das Anhängen des Standard-Video-Metadatenobjekts an das Medienobjekt ist optional.

   • Benutzerspezifische Metadaten

     Erstellen Sie ein Variablenobjekt für die benutzerdefinierten Variablen und fügen Sie die Daten für dieses Video ein. Beispiel:

     /* Set custom context data */
     var customVideoMetadata = {
         isUserLoggedIn: "false",
         tvStation: "Sample TV station",
         programmer: "Sample programmer"
     };
     

3. Absicht, die Wiedergabe zu starten, verfolgen

   Rufen Sie trackSessionStart im media-Objekt auf, um eine Mediensitzung zu verfolgen.

   ADBMobile.media.trackSessionStart(mediaObject, customVideoMetadata);
   

   WICHTIG

   trackSessionStart verfolgt die Absicht des Benutzers, die Wiedergabe zu starten, und nicht den Anfang der Wiedergabe. Mit dieser API können Sie die Videodaten/-Metadaten laden und die QoS-Metrik zur Ladezeit (zeitlicher Abstand zwischen trackSessionStart () und trackPlay) schätzen.

   HINWEIS

   Der zweite Wert ist der Name des benutzerdefinierten Video-Metadatenobjekts, den Sie in Schritt 2 erstellt haben. Wenn Sie keine benutzerdefinierten Video-Metadaten verwenden, senden Sie einfach ein leeres Objekt für das data-Argument in trackSessionStart, wie in der Kommentarzeile im obigen iOS-Beispiel gezeigt.

4. Tatsächlichen Wiedergabebeginn verfolgen

   Identifizieren Sie das Ereignis für den Anfang der Videowiedergabe im Videoplayer, sobald der erste Frame des Videos auf dem Bildschirm angezeigt wird, und rufen Sie trackPlay auf:

   ADBMobile.media.trackPlay();
   

5. Abspielkopfwert aktualisieren

   Aktualisieren Sie den Positionswert von mediaUpdatePlayhead mehrmals, wenn sich der Abspielkopf ändert.
   Bei Video-on-demand (VOD) wird der Wert in Sekunden ab Beginn des Medienelements angegeben.
   Wenn der Player beim Livestreaming keine Informationen zur Inhaltsdauer bereitstellt, kann der Wert als Anzahl der Sekunden seit Mitternacht (UTC) des Tages angegeben werden.

   ADBMobile().media.updatePlayhead(position)
   

   HINWEIS

   Beachten Sie Folgendes beim Aufrufen der media.updatePlayhead API:

   • Bei Verwendung von Fortschrittsmarken ist die Inhaltsdauer erforderlich und die Abspielleiste muss als Anzahl von Sekunden ab Anfang des Medienelements aktualisiert werden, beginnend mit 0.
   • Bei Verwendung von Medien-SDKs müssen Sie die media.updatePlayhead API mindestens einmal pro Sekunde

6. Ende der Wiedergabe verfolgen

   Identifizieren Sie das Ereignis für den Abschluss der Videowiedergabe im Videoplayer, wenn der Inhalt bis zum Ende angesehen wurde, und rufen Sie trackComplete auf:

   ADBMobile.media.trackComplete();
   

7. Ende der Sitzung verfolgen

   Identifizieren Sie das Ereignis für das Entladen/Schließen der Videowiedergabe im Videoplayer, wenn der Benutzer das Video schließt bzw. das Video abgeschlossen ist und entladen wird, und rufen Sie trackSessionEnd auf:

   ADBMobile.media.trackSessionEnd();
   

   WICHTIG

   trackSessionEnd markiert das Ende einer Video-Tracking-Sitzung. Wenn die Sitzung erfolgreich bis zum Ende wiedergegeben wurde und der Anwender den Inhalt bis zum Schluss angesehen hat, müssen Sie trackComplete vor trackSessionEnd aufrufen. Jeder andere track*-API-Aufruf nach trackSessionEnd wird ignoriert, mit Ausnahme von trackSessionStart für eine neue Video-Tracking-Sitzung.

8. Alle möglichen Pausenszenarien verfolgen

   Identifizieren Sie das Ereignis im Videoplayer für angehaltene Videos und rufen Sie trackPause auf:

   ADBMobile.media.trackPause();
   

   Pausenszenarien

   Identifizieren Sie alle Szenarios, in denen der Videoplayer angehalten wird, und stellen Sie sicher, dass trackPause korrekt aufgerufen wird. In allen folgenden Szenarios muss Ihre App trackPause() () aufrufen:

   • Der Benutzer drückt in der App die Pausetaste.
   • Die Wiedergabe wird vom Player selbst pausiert.
   • (Mobile Apps) - Der Benutzer bewegt die App in den Hintergrund, aber Sie möchten, dass die Sitzung der App geöffnet bleibt.
   • (Mobile Apps) - Eine beliebige Systemunterbrechung tritt ein, die dazu führt, dass eine App im Hintergrund ausgeführt wird. Wenn der Benutzer beispielsweise einen Anruf erhält oder eine Popup-Nachricht einer anderen App angezeigt wird, die Anwendung die Sitzung jedoch aktiv halten soll, damit der Benutzer das Video fortsetzen kann.

9. Identifizieren Sie das Ereignis aus dem Player bei wiedergegebenen und/oder nach einer Pause wiederaufgenommenen Videos und rufen Sie trackPlay auf:

   ADBMobile.media.trackPlay();
   

   TIPP

   Diese Ereignisquelle kann mit der in Schritt 4 verwendeten identisch sein. Stellen Sie sicher, dass jeder trackPause()-API-Aufruf mit einem nachfolgenden trackPlay()-API-Aufruf gepaart wird, wenn die Videowiedergabe wiederaufgenommen wird.

• Tracking-Szenarien: VOD-Wiedergabe ohne Anzeigen
• Der im Chromecast-SDK enthaltene Beispiel-Player zeigt ein komplettes Tracking-Beispiel.