Show Menu
TOPICS×

Setup-Übersicht

Die folgenden Anweisungen gelten für die 2.x Media SDKs. Wenn Sie eine 1.x-Version des Medien-SDK implementieren, lesen Sie die Dokumentation zum Medien-SDK 1.x. Informationen zu Primetime-Integratoren finden Sie weiter unten in der
Primetime Media SDK-Dokumentation
.

Unterstützte Mindestplattformversionen

In der folgenden Tabelle werden die für jedes SDK ab dem 19. Februar 2019 unterstützten Mindestplattformversionen beschrieben.
OS/Browser
Erforderliche Mindestversion
iOS
iOS 6+
Android
Android 5.0+ - Lollipop
Chrome
v22+
Mozilla
v27+
Safari
v7+
IE
v11+

Allgemeine Implementierungsrichtlinien

Es gibt drei Hauptkomponenten des SDK, die für die Medienverfolgung relevant sind:
  • Media Heartbeat Config: Diese Konfiguration enthält die grundlegenden Reporting-Einstellungen.
  • Media Heartbeat Delegate: Der Delegate kontrolliert die Wiedergabezeit und das QoS-Objekt.
  • Media Heartbeat: Die primäre Bibliothek enthält Mitglieder und Methoden.
Führen Sie die folgenden Implementierungsschritte aus:
  1. Erstellen Sie eine
    MediaHeartbeatConfig
    -Instanz und legen Sie Ihre Konfigurationsparameterwerte fest.
     Variablenname 
    Beschreibung 
    erforderlich
     Standardwert 
    trackingServer
    Tracking-Server für die Medienanalyse. Dieser Server unterscheidet sich vom 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/des SDK
    Nein
    Leere Zeichenfolge
    playerName
    Name des verwendeten Medienplayers, wie „AVPlayer“, „HTML5-Player“, „Mein anwenderspezifischer Player“.
    Nein
    Leere Zeichenfolge
    ssl
    Gibt an, ob die Aufrufe über HTTPS erfolgen sollen
    Nein
    false
    debugLogging
    Gibt an, ob die Debugging-Protokollierung aktiviert ist.
    Nein
    false
  2. Implementieren des
    MediaHeartbeatDelegate
    .
     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. Beim Tracking von linearen oder Live-Assets wird der Wert in Sekunden ab Beginn des Programms angegeben.
    Ja
    Das Quality-of-Service (QoS)-Objekt ist optional. Wenn QoS-Daten für Ihren Player verfügbar sind und Sie diese Daten verfolgen möchten, sind die folgenden Variablen erforderlich:
    Variablenname
    Beschreibung  
    erforderlich
    bitrate
    Die Bitrate von Medien in Bits pro Sekunde.
    Ja
    startupTime
    Die Startzeit von Medien in Millisekunden.
    Ja
    fps
    Die pro Sekunde angezeigten Frames.
    Ja
    droppedFrames
    Die Anzahl der bisher abgebrochenen Bilder.
    Ja
  3. Erstellen Sie die
    MediaHeartbeat
    -Instanz.
    Verwenden Sie
    MediaHertbeatConfig
    und
    MediaHertbeatDelegate
    , um die
    MediaHeartbeat
    -Instanz zu erstellen.
    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.
    MediaHeartbeat
    erfordert eine
    AppMeasurement
    -Instanz, um Aufrufe an Adobe Analytics senden zu können.
  4. Kombinieren Sie die verschiedenen Elemente.
    Der folgende Beispielcode nutzt das JavaScript 2.x-SDK für einen HTML5-Videoplayer:
    // 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

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.
    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

Video Analytics-SDKs 1.x 
 Entwicklerhandbücher (nur PDFs)
Android
Apple TV
Chromecast
iOS
JavaScript
Primetime
TVML

Primetime Medien-SDK-Dokumentation