Inviare dati web ad Edge con Adobe Experience Platform Web SDK
A partire dalla versione 2.20.0 di, streamingMedia
componente di Adobe Experience Platform SDK per web 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 streamingMedia
componente di Web SDK, è necessario soddisfare i seguenti prerequisiti:
- Prima di poter inviare dati multimediali in streaming ad Edge, completa i passaggi descritti in Installare il componente aggiuntivo Streaming Media Collection con Experience Platform Edge.
- Assicurati di avere accesso a Adobe Experience Platform e/o Adobe Analytics.
- È necessario utilizzare Web SDK versione 2.20.0 o successiva. Consulta la Panoramica sull’installazione di Web SDK per scoprire come installare la versione più recente.
- Abilita Media Analytics per lo stream di dati in uso.
- Assicurati che lo schema utilizzato dallo stream di dati includa i campi dello schema di Media Collection.
- Configura la funzione Streaming Media nella configurazione dell’SDK Web, come mostrato in questa pagina, tramite estensione tag o tramite Libreria JavaScript.
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 l’SDK web streamingMedia
componente.
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 streamingMedia
nell’SDK per web, come illustrato di seguito.
alloy("configure", {
streamingMedia: {
channel: "sample_channel",
playerName: "player_name",
appVersion: "app_version",
mainPingInterval: 10,
adPingInterval: 10
}
});
Consulta Web SDK streamingMedia
componente documentazione per informazioni complete su come configurarlo.
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 Media Analytics. È possibile utilizzare questo comando per creare un'istanza dell'oggetto e quindi, utilizzando le stesse API fornite da Libreria JS per contenuti multimediali, tieni traccia degli eventi multimediali.
Consulta la getMediaAnalyticsTracker
la documentazione per i dettagli completi sui metodi supportati.
Lo snippet seguente mostra come recuperare l’istanza di tracciamento dei contenuti multimediali in Media JS.
var tracker = ADB.Media.getInstance();
Invece, utilizza getMediaAnalyticsTracker
nell’SDK per web 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 sul Media
oggetto. 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);