Skicka webbdata till Edge med Adobe Experience Platform Web SDK

Från och med version 2.20.0 gör komponenten streamingMedia i Adobe Experience Platform Web SDK att du kan samla in data relaterade till mediesessioner på din webbplats. De insamlade data kan innehålla information om medieuppspelningar, pauser, slutföranden och andra relaterade händelser.

När data har samlats in kan du skicka dem till Adobe Experience Platform och/eller Adobe Analytics för att generera rapporter. Den här funktionen är en heltäckande lösning för att spåra och förstå hur medieanvändningen fungerar på din webbplats.

För kunder som använder Media JS SDK erbjuder Web SDK en migreringsväg från Media JS SDK till Web SDK, med stöd för befintliga Media JS-funktioner, som hantering av mediahändelser.

Förutsättningar prerequisites

Om du vill använda komponenten streamingMedia i Web SDK måste du uppfylla följande krav:

Följ stegen som beskrivs på den här sidan för att migrera implementeringen av tillägget Streaming Media Collection från Media JS till Web SDK.

Steg 1: Installera Experience Platform Web SDK

Läs den dedikerade dokumentationen om du vill lära dig hur du installerar Web SDK på dina webbegenskaper.

Steg 2: Konfigurera Web SDK streamingMedia-komponenten.

Exempel

I utdraget nedan visas hur du konfigurerar mediesamlingen i Media JS.

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);

I stället måste du konfigurera komponenten streamingMedia i Web SDK enligt exemplet nedan.

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

Mer information om hur du konfigurerar Web SDK streamingMedia-komponenten finns i-dokumentationen för Web SDK-komponenten.

Steg 3: Hämta instansen av mediespåraren när du migrerar från mediets JS SDK

För kunder som använder Media JS SDK erbjuder Web SDK en migreringsväg från Media JS SDK till Web SDK, med stöd för befintliga Media JS-funktioner, som hantering av mediahändelser.

Web SDK innehåller ett kommando för att hämta en Media Analytics-spårare. Du kan använda det här kommandot för att skapa en objektinstans och sedan, med samma API:er som de som finns i Media JS-biblioteket, spåra mediahändelser.

Mer information om vilka metoder som stöds finns i dokumentationen för getMediaAnalyticsTracker.

I kodutdraget nedan visas hur du hämtar mediaspårningsinstansen i Media JS.

var tracker = ADB.Media.getInstance();

Använd i stället kommandot getMediaAnalyticsTracker i Web SDK för att uppnå samma resultat, vilket visas nedan.

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

Alla hjälpmetoder är tillgängliga för objektet Media. Spårningsmetoderna är tillgängliga för spårningsinstansen, vilket visas nedan.

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);