Webdaten mit dem Adobe Experience Platform Web SDK an Edge senden

Ab Version 2.20.0 muss die Variable streamingMedia Adobe Experience Platform-Komponente Web SDK ermöglicht Ihnen die Erfassung von Daten zu Mediensitzungen auf Ihrer Website. 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

So verwenden Sie die streamingMedia -Komponente des Web SDK 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

Siehe dedizierte Dokumentation , um zu erfahren, wie Sie das Web SDK in Ihren Web-Eigenschaften installieren.

Schritt 2: Web SDK konfigurieren streamingMedia -Komponente.

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 streamingMedia -Komponente im Web SDK wie unten dargestellt.

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

Siehe Web SDK . streamingMedia component Dokumentation für ausführliche Informationen zur Konfiguration.

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 dieselben APIs wie die von der Media JS-Bibliothek, verfolgen Sie Medienereignisse.

Siehe getMediaAnalyticsTracker Dokumentation für vollständige Details zu den unterstützten Methoden.

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

var tracker = ADB.Media.getInstance();

Verwenden Sie stattdessen die getMediaAnalyticsTracker im Web SDK verwenden, 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 im Media -Objekt. 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);