Nachverfolgen der grundlegenden Wiedergabe mit JavaScript 2.x track-core-playback-on-javascript

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.

createMediaObject API

StreamType-Konstanten:

MediaType-Konstanten:

var mediaObject =
  MediaHeartbeat.createMediaObject(<MEDIA_NAME>,
                                  <MEDIA_ID,
                                  <MEDIA_LENGTH>,
                                  MediaHeartbeat.StreamType.VOD,
                                  <MEDIA_TYPE>);

Metadaten anhängen

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

• Standard-Metadaten

  Standard-Metadaten in JavaScript implementieren

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

  • Medien-Metadatenschlüssel API-Referenz: Standard-Metadatenschlüssel - JavaScript

    Hier sehen Sie den umfassenden Satz der verfügbaren Metadaten: Audio- und Videoparameter

• Benutzerspezifische Metadaten

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

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

Absicht, die Wiedergabe zu starten, verfolgen

Rufen Sie trackSessionStart in der Media Heartbeat-Instanz auf, um eine Mediensitzung zu verfolgen:

mediaHeartbeat.trackSessionStart(mediaObject, customVideoMetadata);

Tatsächlichen Wiedergabebeginn verfolgen

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

mediaHeartbeat.trackPlay();

Ende der Wiedergabe verfolgen

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

mediaHeartbeat.trackComplete();

Ende der Sitzung verfolgen

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

mediaHeartbeat.trackSessionEnd();

Alle möglichen Pausenszenarien verfolgen

Identifizieren Sie das Ereignis im Medienplayer für Anhalten und rufen Sie trackPause auf:

mediaHeartbeat.trackPause();

Pausenszenarien

Identifizieren Sie alle Szenarios, in denen der Medienplayer 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. Beispielsweise erhält der Benutzer einen Anruf oder ein Pop-up aus einer anderen App, aber Sie möchten, dass die App-Sitzung fortgeführt wird, damit der Benutzer die Medien ab dem Zeitpunkt der Unterbrechung wieder fortsetzen kann.

Identifizieren Sie das Ereignis aus dem Player bei Wiedergabe und/oder Fortsetzen nach Pause und rufen Sie trackPlay auf:

mediaHeartbeat.trackPlay();