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:
- Bevor Sie Streaming-Mediendaten an Edge senden können, führen Sie zunächst die Schritte unter Installieren des Streaming Media Collection Add-ons mit Experience Platform Edge.
- Stellen Sie sicher, dass Sie Zugriff auf Adobe Experience Platform und/oder Adobe Analytics haben.
- Sie müssen die Web SDK-Version 2.20.0 oder höher verwenden. Siehe Übersicht über die Installation des Web SDK , um zu erfahren, wie Sie die neueste Version installieren.
- Aktivieren Sie die Media Analytics -Option für den verwendeten Datastream.
- Stellen Sie sicher, dass das von Ihrem Datastream verwendete Schema die Schemafelder für die Mediensammlung enthält.
- Konfigurieren Sie die Streaming-Medien-Funktion in der Web SDK-Konfiguration, wie auf dieser Seite gezeigt, entweder über das Tag-Erweiterung oder durch JavaScript-Bibliothek.
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);