Tracking von Inhaltswiedergabe
Core-Wiedergabe-Tracking umfasst das Laden, Starten, Pause, Fortsetzen, Abschließen und Sitzungsende von Medien. Die Pufferung und das Suchen-Tracking sind zwar nicht obligatorisch, sind aber auch Kernkomponenten einer vollständigen Wiedergabeimplementierung.
Player-Ereignisse
Implementierungsschritte
- Ermitteln Sie, wann der Benutzer die Wiedergabe hat (der Benutzer klickt auf Wiedergabe oder die automatische Wiedergabe löst aus). Erstellen Sie ein Medienobjekt mit Inhaltsname, ID, Länge, Stream-Typ und Medientyp. Siehe Inhaltsname, Inhalts-ID, Inhaltslänge, Stream-Typ und Content-Typ für Felddefinitionen.
- Optional Metadaten anhängen - Standard-Metadaten (Sendung, Staffel, Folge usw.) und benutzerdefinierte Kontextdatenvariablen. Siehe Anzeigen, Staffel, Folge, Genre und Netzwerk für Standard-Metadatenschlüsselverweise.
- Rufen Sie Sitzungsstart auf, um mit dem Tracking der Sitzung zu beginnen. Dadurch werden die Daten und Metadaten geladen und die QoS-Messung mit der Zeit bis zum Start gestartet. SessionStart verfolgt die Absicht, die wiedergegeben werden soll, nicht den ersten Frame.
- Rufen Sie Play auf, wenn der erste Frame mit Inhalten auf dem Bildschirm gerendert wird.
- Rufen Sie Start anhalten auf, wenn der Player pausiert. Die Wiedergabe wird erneut aufgerufen, wenn die Wiedergabe fortgesetzt wird. Es gibt kein separates Wiederaufnahmeereignis.
- Aufrufen Sitzung abgeschlossen wenn der Viewer das Ende des Inhalts erreicht.
- Aufruf Sitzungsende wenn der Player entladen wird oder der Viewer Inhalte abbricht, ohne das Ende zu erreichen. SessionEnd schließt die Sitzung sofort. Danach können keine weiteren Ereignisse mehr verfolgt werden.
SessionEnd markiert das Ende einer Tracking-Sitzung. Wenn die Sitzung erfolgreich bis zum Ende angeschaut wurde, rufen Sie SessionComplete vor dem SessionEnd auf. Alle anderen Tracking-Aufrufe werden nach der SessionEnd ignoriert, mit Ausnahme von SessionStart für eine neue Sitzung.Core-Wiedergabe
Die folgenden Beispiele zeigen einen vollständigen Sitzungsfluss - vom Sitzungsbeginn bis zum Abschluss des Inhalts und zum Sitzungsende.
Implementierungsdetails nach Plattform finden Sie unter Sitzungsstart, Play, Start anhalten, Sitzung abgeschlossen und Sitzung beendet.
Pufferung
Der Puffer-Start signalisiert, dass der Player auf Daten wartet. Das Ende des Puffers wird abgeleitet, wenn Sie nach dem BufferStart ein Play-Ereignis senden (XDM-basierte APIs). Rufen Sie auf Mobile SDK auch BufferComplete explizit auf.
Details zur Implementierung finden Sie unter Pufferstart.
Wird gesucht
Suchstartsignale, die der Viewer bereinigt. Auf das Suchende folgt die Wiedergabe, um die Inhaltswiedergabe fortzusetzen.
Weitere Informationen zur Implementierung finden Sie unter Start anhalten (Suchstart) und Abspielen (Suchende).
Behandeln von App-Interrupts
Die Wiedergabe in einer Medienanwendung kann auf verschiedene Weise unterbrochen werden: Der Benutzer klickt auf Pause, die App wechselt in den Hintergrund, ein Telefonanruf kommt an. Unabhängig von der Ursache sind die Tracking-Anweisungen dieselben:
- Rufen Sie PauseStart auf, wenn die Anwendung unterbrochen wird (geht in den Hintergrund, Medienpausen usw.).
- Rufen Sie Play auf, wenn die Anwendung in den Vordergrund zurückkehrt und/oder die Medienwiedergabe fortgesetzt wird.
Wann sollte eine angehaltene Sitzung enden? Wenn die Anwendung keine Hintergrundwiedergabe zulässt, rufen Sie sofort PauseStart und anschließend SessionEnd nach etwa einer Minute im Hintergrund auf. Die Anwendung kann nicht weiterhin Pause-Pings aus dem Hintergrund senden, und das unbegrenzte Halten der Sitzung bietet ein schlechtes Erlebnis. Wenn die Anwendung die Hintergrundwiedergabe unterstützt (Audio-Apps, Video-Podcast-Apps), senden Sie im Hintergrund weiterhin Pings.
Neustart nach einer langen Hintergrundperiode: Wenn die App lange genug im Hintergrund war, dass die Sitzung abgelaufen ist (30-minütige Inaktivität), rufen Sie SessionEnd auf, um alle verbleibenden Sitzungen sauber zu schließen, und rufen Sie SessionStart auf, um eine neue Sitzung zu beginnen, wenn der Viewer zurückkehrt.
Wiederaufnehmen von inaktiven Sitzungen
Eine Sitzung läuft automatisch ab, wenn für 10 Minuten keine Ereignisse empfangen werden oder wenn für 30 Minuten keine Abspielkopfbewegung stattfindet. Wenn der Benutzer nach Ablauf einer Sitzung zurückkehrt, rufen Sie SessionStart erneut auf, um eine neue Sitzung zu öffnen.
Geräteübergreifende Wiederaufnahme (geräteübergreifende Weiterleitung): Wenn ein Viewer die Wiedergabe zwischen Geräten überträgt (z. B. von einem Telefon auf ein Fernsehgerät), verwenden Sie das Wiederaufnahme-Flag, um die Sitzungen in Analytics-Berichten zusammenzufügen:
- Rufen Sie auf dem Quellgerät SessionEnd auf, wenn der Viewer die Umwandlung initiiert. SessionComplete nicht aufrufen - der Inhalt ist nicht abgeschlossen.
- Rufen Sie auf dem Zielgerät „SessionStart“ auf, wobei das Fortsetzungs-Flag auf “
true” gesetzt ist, und übergeben Sie dieselben Inhaltsmetadaten und die Abspielposition vom Quellgerät.
Durch Festlegen des Fortsetzungs-Flags erhöht Analytics für den zweiten Abschnitt der Übergabe Inhaltswiederaufnahmen anstatt Medienstarts“.
Manuelles Wiederaufnehmen einer zuvor geschlossenen Sitzung: Wenn die Anwendung Benutzerdaten speichert und eine zuvor geschlossene Sitzung fortsetzen kann, setzen Sie das Wiederaufnahme-Flag beim Sitzungsstart. Siehe Sitzungsstart für Implementierungsdetails auf allen Plattformen.