Webgegevens naar Edge verzenden met de Adobe Experience Platform Web SDK
Vanaf versie 2.20.0 worden de streamingMedia
onderdeel van de Adobe Experience Platform Web SDK kunt u gegevens verzamelen die betrekking hebben op mediasessies op uw website. De verzamelde gegevens kunnen informatie over media playbacks, pauzes, voltooiing, en andere verwante gebeurtenissen omvatten.
Nadat gegevens zijn verzameld, kunt u deze naar Adobe Experience Platform en/of Adobe Analytics verzenden om rapporten te genereren. Deze functie biedt een uitgebreide oplossing voor het bijhouden en begrijpen van het gedrag van het mediaconsumptie op uw website.
Voor klanten die de Media JS SDK gebruiken, verstrekt het Web SDK een migratieweg om van Media JS SDK aan Web SDK te bewegen, terwijl het omvat steun voor bestaande de functionaliteit van Media JS, zoals het behandelen van media gebeurtenissen.
Vereisten prerequisites
Als u de opdracht streamingMedia
component van Web SDK, moet u aan de volgende voorwaarden voldoen:
- Voordat u streaming mediagegevens naar Edge kunt verzenden, voert u eerst de stappen in De invoegtoepassing voor streaming media Collection installeren met Experience Platform Edge.
- Zorg ervoor dat u toegang hebt tot Adobe Experience Platform en/of Adobe Analytics.
- U moet Web SDK versie 2.20.0 of later gebruiken. Zie de Overzicht van de installatie van Web SDK voor informatie over het installeren van de nieuwste versie.
- De optie Media Analytics voor de gegevensstroom die u gebruikt.
- Zorg ervoor dat het schema dat door uw gegevensstroom wordt gebruikt de het schemagebieden van de Inzameling van Media omvat.
- Vorm de Streaming eigenschap van Media in de configuratie van SDK van het Web, zoals aangetoond in deze pagina, of door tagextensie of via de JavaScript-bibliotheek.
Voer de stappen uit die in deze pagina worden beschreven om uw invoegtoepassing voor het streamen van media-verzamelingen te migreren van Media JS naar Web SDK.
Stap 1: SDK van Web Experience Platform installeren
Zie de speciale documentatie voor meer informatie over het installeren van Web SDK op uw wegeigenschappen.
Stap 2: Vorm SDK van het Web streamingMedia
component.
Voorbeeld
In het onderstaande fragment ziet u hoe u mediaconcering in Media JS configureert.
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);
In plaats daarvan, moet u vormen streamingMedia
in de Web SDK zoals hieronder wordt geïllustreerd.
alloy("configure", {
streamingMedia: {
channel: "sample_channel",
playerName: "player_name",
appVersion: "app_version",
mainPingInterval: 10,
adPingInterval: 10
}
});
Zie de Web SDK streamingMedia
component documentatie voor volledige details over hoe te om het te vormen.
Stap 3: Haal de instantie van de mediatracker op wanneer u migreert van de Media JS SDK
Voor klanten die de Media JS SDK gebruiken, verstrekt het Web SDK een migratieweg om van Media JS SDK aan Web SDK te bewegen, terwijl het omvat steun voor bestaande de functionaliteit van Media JS, zoals het behandelen van media gebeurtenissen.
Web SDK bevat een opdracht om een Media Analytics Tracker op te halen. U kunt deze opdracht gebruiken om een objectinstantie te maken en vervolgens dezelfde API's te gebruiken als de API's die door de Media JS-bibliotheek, media-gebeurtenissen volgen.
Zie de getMediaAnalyticsTracker
documentatie voor volledige informatie over de ondersteunde methoden.
In het onderstaande fragment ziet u hoe u de instantie van de mediatracker in Media JS kunt ophalen.
var tracker = ADB.Media.getInstance();
Gebruik in plaats daarvan de opdracht getMediaAnalyticsTracker
bevel in Web SDK om het zelfde resultaat, zoals hieronder getoond te bereiken.
// aquire Media Analytics APIs
const Media = await window.alloy("getMediaAnalyticsTracker", {});
// create a media tracker instance
const trackerInstance = Media.getInstance();
Alle hulpmethoden zijn beschikbaar op de Media
object. De trackermethoden zijn beschikbaar op de tracker-instantie, zoals hieronder wordt weergegeven.
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);