Inviare dati web ad Edge con Adobe Experience Platform Web SDK

A partire dalla versione 2.20.0, il componente streamingMedia di Adobe Experience Platform Web SDK consente di raccogliere i dati relativi alle sessioni multimediali sul sito Web. I dati raccolti possono includere informazioni su riproduzioni multimediali, pause, completamenti e altri eventi correlati.

Una volta raccolti i dati, puoi inviarli a Adobe Experience Platform e/o Adobe Analytics per generare rapporti. Questa funzione fornisce una soluzione completa per il tracciamento e la comprensione del comportamento di consumo dei contenuti multimediali sul sito web.

Per i clienti che utilizzano Media JS SDK, Web SDK fornisce un percorso di migrazione per passare da Media JS SDK a Web SDK, includendo al contempo il supporto per le funzionalità Media JS esistenti, come la gestione degli eventi multimediali.

Prerequisiti prerequisites

Per utilizzare il componente streamingMedia di Web SDK, è necessario soddisfare i seguenti prerequisiti:

Segui i passaggi descritti in questa pagina per migrare l’implementazione del componente aggiuntivo Streaming Media Collection da Media JS a Web SDK.

Passaggio 1: installare Experience Platform Web SDK

Consulta la documentazione dedicata per scoprire come installare Web SDK nelle proprietà web.

Passaggio 2: configurare il componente Web SDK streamingMedia.

Esempio

Lo snippet seguente mostra come configurare la raccolta multimediale in 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);

È invece necessario configurare il componente streamingMedia nell'SDK Web come esemplificato di seguito.

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

Per informazioni dettagliate su come configurarlo, consulta la documentazione del componente streamingMedia dell'SDK Web.

Passaggio 3: ottieni l’istanza di tracciamento dei contenuti multimediali durante la migrazione dall’SDK Media JS

Per i clienti che utilizzano Media JS SDK, Web SDK fornisce un percorso di migrazione per passare da Media JS SDK a Web SDK, includendo al contempo il supporto per le funzionalità Media JS esistenti, come la gestione degli eventi multimediali.

Web SDK include un comando per recuperare un tracciatore di Media Analytics. È possibile utilizzare questo comando per creare un'istanza dell'oggetto e quindi, utilizzando le stesse API fornite dalla libreria Media JS, tenere traccia degli eventi multimediali.

Per informazioni complete sui metodi supportati, consulta la documentazione di getMediaAnalyticsTracker.

Lo snippet seguente mostra come recuperare l’istanza di tracciamento dei contenuti multimediali in Media JS.

var tracker = ADB.Media.getInstance();

Utilizzare invece il comando getMediaAnalyticsTracker in Web SDK per ottenere lo stesso risultato, come illustrato di seguito.

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

Tutti i metodi helper saranno disponibili sull'oggetto Media. I metodi di tracciamento sono disponibili nell’istanza di tracciamento, come illustrato di seguito.

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