Webdaten mit dem Adobe Experience Platform Web SDK an Edge senden

Ab Version 2.20.0 können Sie mit der Komponente streamingMedia des Adobe Experience Platform Web SDK Daten im Zusammenhang mit Mediensitzungen auf Ihrer Website erfassen. Die erfassten Daten können Informationen zu Medienwiedergaben, Pausen, Beendigungen und anderen damit zusammenhängenden Ereignissen enthalten.

Nachdem die Daten erfasst wurden, können Sie sie an Adobe Experience Platform und/oder Adobe Analytics senden, um Berichte zu erstellen. Diese Funktion bietet eine umfassende Lösung zum Verfolgen und Verstehen des Verhaltens der Mediennutzung auf Ihrer Website.

Für Kunden, die das Media JS SDK verwenden, bietet das Web SDK einen Migrationspfad für den Wechsel vom Media JS SDK zum Web SDK. Gleichzeitig wird Unterstützung für vorhandene Media JS-Funktionen wie die Verarbeitung von Medienereignissen bereitgestellt.

Voraussetzungen prerequisites

Um die Komponente streamingMedia des Web SDK zu verwenden, müssen Sie die folgenden Voraussetzungen erfüllen:

Führen Sie die auf dieser Seite beschriebenen Schritte aus, um Ihre Implementierung des Streaming Media Collection Add-ons von Media JS zu Web SDK zu migrieren.

Schritt 1: Installieren des Experience Platform Web SDK

Informationen zur Installation des Web SDK in Ihren Webeigenschaften finden Sie in der dedizierten Dokumentation .

Schritt 2: Konfigurieren Sie die Komponente Web SDK streamingMedia .

Beispiel

Das folgende Snippet zeigt, wie Sie die Mediensammlung in Media JS konfigurieren.

var mediaConfig = new ADB.MediaConfig();
mediaConfig.trackingServer = "company.hb-api.omtrdc.net";
mediaConfig.playerName = "player_name";
mediaConfig.channel = "sample_channel";
mediaConfig.appVersion = "app_version";
mediaConfig.debugLogging = true;
mediaConfig.ssl = true;

ADB.Media.configure(mediaConfig, appMeasurement);

Stattdessen müssen Sie die Komponente streamingMedia im Web SDK wie unten dargestellt konfigurieren.

alloy("configure", {
  streamingMedia: {
    channel: "sample_channel",
    playerName: "player_name",
    appVersion: "app_version",
    mainPingInterval: 10,
    adPingInterval: 10
  }
});

Ausführliche Informationen zur Konfiguration finden Sie in der Dokumentation zur Web SDK streamingMedia-Komponente Dokumentation .

Schritt 3: Abrufen der Media-Tracker-Instanz bei der Migration vom Media JS SDK

Für Kunden, die das Media JS SDK verwenden, bietet das Web SDK einen Migrationspfad für den Wechsel vom Media JS SDK zum Web SDK. Gleichzeitig wird Unterstützung für vorhandene Media JS-Funktionen wie die Verarbeitung von Medienereignissen bereitgestellt.

Web SDK enthält einen Befehl zum Abrufen eines Media Analytics-Trackers. Mit diesem Befehl können Sie eine Objektinstanz erstellen und dann mithilfe derselben APIs, die von der Medien-JS-Bibliothek bereitgestellt werden, Medienereignisse verfolgen.

Vollständige Details zu den unterstützten Methoden finden Sie in der Dokumentation zu getMediaAnalyticsTracker .

Der nachstehende Ausschnitt zeigt, wie Sie die Media-Tracker-Instanz in Media JS abrufen.

var tracker = ADB.Media.getInstance();

Verwenden Sie stattdessen den Befehl getMediaAnalyticsTracker im Web SDK, um dasselbe Ergebnis zu erzielen, wie unten dargestellt.

// aquire Media Analytics APIs
const Media = await window.alloy("getMediaAnalyticsTracker", {});
// create a media tracker instance
const trackerInstance = Media.getInstance();

Alle Hilfsmethoden sind für das Objekt Media verfügbar. Die Tracker-Methoden sind in der Tracker-Instanz verfügbar, wie unten dargestellt.

const mediaInfo = Media.createMediaObject(
  "video name",
  "player video",
  60,
  Media.StreamType.VOD,
  Media.MediaType.Video
);

const contextData = {
  isUserLoggedIn: "false",
  tvStation: "Sample TV station",
  programmer: "Sample programmer",
  assetID: "/uri-reference"
};

// Set standard Video Metadata
contextData[Media.VideoMetadataKeys.Episode] = "Sample Episode";
contextData[Media.VideoMetadataKeys.Show] = "Sample Show";

trackerInstance.trackSessionStart(mediaInfo, contextData);