Senden von Web-Daten an Edge mit Adobe Experience Platform Web SDK

Ab Version 2.20.0 können Sie mit der streamingMedia der Adobe Experience Platform Web SDK Daten zu Mediensitzungen auf Ihrer Website erfassen. Die erfassten Daten können Informationen zu Medienwiedergaben, Pausen, Beendigungen und anderen zugehörigen Ereignissen enthalten.

Nachdem die Daten erfasst wurden, können Sie sie an Adobe Experience Platform und/oder Adobe Analytics senden, um Berichte zu generieren. Diese Funktion bietet eine umfassende Lösung zum Tracking und zum Verständnis des Medienkonsumverhaltens auf Ihrer Website.

Für Kunden, die die Media JS-SDK verwenden, bietet Web SDK einen Migrationspfad, um von Media JS-SDK zu Web SDK zu wechseln, wobei bestehende Media JS-Funktionen, z. B. die Verarbeitung von Medienereignissen, unterstützt werden.

Voraussetzungen prerequisites

Um die streamingMedia von Web SDK verwenden zu können, müssen Sie die folgenden Voraussetzungen erfüllen:

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

Schritt 1: Installieren von Experience Platform Web SDK

In der dedizierten Dokumentation erfahren Sie, wie Sie Web SDK in Ihren Web-Eigenschaften installieren.

Schritt 2: Konfigurieren Sie die Web SDK-streamingMedia.

Beispiel

Der folgende Ausschnitt zeigt, wie Sie die Mediensammlung in Media JS konfigurieren würden.

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 wie unten dargestellt in der Web-SDK konfigurieren.

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

Vollständige Details zur Konfiguration finden Sie in DokumentationWeb SDK-streamingMedia .

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

Für Kunden, die die Media JS-SDK verwenden, bietet Web SDK einen Migrationspfad, um von Media JS-SDK zu Web SDK zu wechseln, wobei bestehende Media JS-Funktionen, z. B. die Verarbeitung von Medienereignissen, unterstützt werden.

Web SDK enthält einen Befehl zum Abrufen eines Media Analytics-Trackers. Sie können diesen Befehl verwenden, um eine Objektinstanz zu erstellen, und dann mit denselben APIs wie in der Media JS Library Medienereignisse verfolgen.

In der getMediaAnalyticsTracker-Dokumentation finden Sie vollständige Details zu den unterstützten Methoden.

Der folgende Ausschnitt zeigt, wie Sie die Medien-Tracker-Instanz in Media JS abrufen würden.

var tracker = ADB.Media.getInstance();

Verwenden Sie stattdessen den Befehl getMediaAnalyticsTracker in 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 Media verfügbar. Die Tracker-Methoden sind auf 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);