Übersicht über die Einrichtung älterer Streaming Media SDKs der Version 2.x setup-overview
Die Anweisungen in diesem Abschnitt gelten für die älteren Media SDKs der Version 2.x.
-
Wenn Sie Version 1.x des Media SDK implementieren, lesen Sie dazu bitte die Dokumentation zum Media SDK 1.x.
-
Primetime-Integratoren lesen bitte die Primetime-Dokumentation für Media SDKs.
Unterstützte Mindestplattformversionen minimum-platform-version
In der folgenden Tabelle werden die für jedes SDK ab dem 19. Februar 2019 unterstützten Mindestplattformversionen beschrieben.
Allgemeine Implementierungsrichtlinien general-implementation-guidelines
Das Medien-Tracking umfasst drei grundlegende SDK-Komponenten:
- Media Heartbeat Config - Die Konfiguration enthält die Grundeinstellungen für Berichte.
- Media Heartbeat Delegate - Der Delegate steuert die Wiedergabedauer und das QoS-Objekt.
- Media Heartbeat - Die primäre Bibliothek, die Elemente und Methoden enthält.
Führen Sie die folgenden Implementierungsschritte aus:
-
Erstellen Sie eine
MediaHeartbeatConfig
-Instanz und legen Sie Ihre Konfigurationsparameterwerte fest.table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 3-align-center 8-align-center 13-align-center 18-align-center 23-align-center 28-align-center 33-align-center 38-align-center Variablenname Beschreibung erforderlich Standardwert trackingServer
Tracking-Server für Medienanalyse. Dies unterscheidet sich von Ihrem Analytics-Tracking-Server. Ja Leere Zeichenfolge channel
Kanalname Nein Leere Zeichenfolge ovp
Name der Online-Medienplattform, über die der Inhalt verteilt wird. Nein Leere Zeichenfolge appVersion
Version der Medienplayer-App bzw. des SDK Nein Leere Zeichenfolge playerName
Name des verwendeten Medienplayers, d. h. „AVPlayer“, „HTML5-Player“, „Mein benutzerspezifischer Player“. Nein Leere Zeichenfolge ssl
Gibt an, ob HTTPS-Aufrufe durchgeführt werden sollen Nein false debugLogging
Gibt an, ob die Debug-Protokollierung aktiviert ist Nein false -
Implementieren des
MediaHeartbeatDelegate
.table 0-row-3 1-row-3 2-row-3 3-align-center 7-align-center 11-align-center Name der Methode Beschreibung erforderlich getQoSObject()
Gibt die MediaObject
-Instanz zurück, die die aktuellen Informationen zur Servicequalität enthält. Diese Methode wird mehrmals während einer Wiedergabesitzung aufgerufen. Die Player-Implementierung muss stets die aktuellsten verfügbaren Servicequalitätsdaten zurückgeben.Ja getCurrentPlaybackTime()
Gibt die aktuelle Position der Abspielleiste zurück.
Bei VOD-Tracking 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.
Hinweis: Bei Verwendung von Fortschrittsmarken ist die Inhaltsdauer erforderlich und der Abspielkopf muss als Anzahl von Sekunden ab Beginn des Medienelements aktualisiert werden, beginnend mit 0.Ja note tip TIP Das Quality-of-Service (QoS)-Objekt ist optional. Wenn QoS-Daten für Ihren Player verfügbar sind und Sie diese Daten tracken möchten, sind die folgenden Variablen erforderlich: 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 Variablenname Beschreibung erforderlich bitrate
Die Bitrate von Medien in Bits pro Sekunde. Ja startupTime
Die Zeitdauer bis zum Beginn von Medien in Millisekunden. Ja fps
Die pro Sekunde angezeigten Frames. Ja droppedFrames
Die Anzahl der bisherigen Dropped Frames. Ja -
Erstellen Sie die
MediaHeartbeat
-Instanz.Verwenden Sie
MediaHertbeatConfig
undMediaHertbeatDelegate
, um dieMediaHeartbeat
-Instanz zu erstellen.note important IMPORTANT Stellen Sie sicher, dass die MediaHeartbeat
-Instanz zugänglich ist und ihre Zuweisung nicht vor Ende der Sitzung aufgehoben wird. Diese Instanz wird für alle der folgenden Medien-Tracking-Ereignisse verwendet.note tip TIP MediaHeartbeat
erfordert eineAppMeasurement
-Instanz, um Aufrufe an Adobe Analytics senden zu können. -
Kombinieren Sie alle Teile.
Der folgende Beispielcode nutzt unser JavaScript 2.x-SDK für einen HTML5-Videoplayer:
code language-javascript // Create local references to the heartbeat classes var MediaHeartbeat = ADB.va.MediaHeartbeat; var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig; var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate; //Media Heartbeat Config var mediaConfig = new MediaHeartbeatConfig(); mediaConfig.trackingServer = "[your_namespace].hb.omtrdc.net"; mediaConfig.playerName = "HTML5 Basic"; mediaConfig.channel = "Video Channel"; mediaConfig.debugLogging = true; mediaConfig.appVersion = "2.0"; mediaConfig.ssl = false; mediaConfig.ovp = ""; // Media Heartbeat Delegate var mediaDelegate = new MediaHeartbeatDelegate(); // Set mediaDelegate CurrentPlaybackTime mediaDelegate.getCurrentPlaybackTime = function() { return video.currentTime; }; // Set mediaDelegate QoSObject - OPTIONAL mediaDelegate.getQoSObject = function() { return MediaHeartbeat.createQoSObject(video.bitrate, video.startuptime, video.fps, video.droppedframes); } // Create mediaHeartbeat instance this.mediaHeartbeat = new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurementInstance);
Überprüfen validate
Media Analytics-Tracking-Implementierungen generieren zwei Arten von Tracking-Aufrufen:
-
Medien- und Anzeigenstartaufrufe werden direkt an den Adobe Analytics-Server (AppMeasurement) gesendet.
-
Heartbeat-Aufrufe werden an den Media Analytics-Tracking-Server (Heartbeats) gesendet, dort verarbeitet und an den Adobe Analytics-Server weitergeleitet.
-
Adobe Analytics-Server (AppMeasurement) Weitere Informationen zu den Optionen für Tracking-Server finden Sie unter Korrektes Ausfüllen der Variablen trackingServer und trackingServerSecure.
note important IMPORTANT Für den Experience Cloud Visitor ID-Dienst ist ein RDC-Tracking-Server oder CNAME erforderlich, der in einen RDC-Server aufgelöst wird. Der Analytics-Tracking-Server sollte auf „
.sc.omtrdc.net
“ enden oder ein CNAME sein. -
Media Analytics-Server (Heartbeats)
Dieser hat immer das Format „[your_namespace].hb.omtrdc.net
“. Der Wert „[your_namespace]
“gibt Ihr Unternehmen an und wird von Adobe bereitgestellt.
Das Medien-Tracking verhält sich auf allen Plattformen – Desktop oder Mobilgeräte – gleich. Das Audio-Tracking funktioniert derzeit auf mobilen Plattformen. Es gibt einige universelle Variablen, die für alle Tracking-Aufrufe überprüft werden müssen:
Dokumentation zum SDK 1.x sdk-1x-documentation
- Android: Media Analytics-Konfiguration
- DHLS: Media Analytics-Konfiguration
- iOS: Media Analytics-Konfiguration