Overzicht van Adobe Media Analytics voor audio- en video-extensie
Gebruik deze documentatie voor informatie over het installeren, het vormen, en het uitvoeren van de Adobe Media Analytics voor Audio en Video uitbreiding (de uitbreiding van de Analyse van Media). Omvat zijn de opties beschikbaar wanneer het gebruiken van deze uitbreiding om een regel, samen met voorbeelden en verbindingen aan steekproeven te bouwen.
De uitbreiding Media Analytics (MA) voegt de kernJavaScript Media SDK (Media 2.x SDK) toe. Deze extensie biedt de functionaliteit voor het toevoegen van de MediaHeartbeat
tracker-instantie naar een tagsite of -project. De extensie MA vereist twee extra extensies:
Nadat u alle drie bovengenoemde uitbreidingen in uw markeringsproject hebt omvat, kunt u op één van twee manieren te werk gaan:
- Gebruiken
MediaHeartbeat
API's van uw webtoepassing - Neem een spelerspecifieke extensie op of maak een extensie die specifieke media Player-gebeurtenissen toewijst aan de API's op het tabblad
MediaHeartbeat
tracker. Deze instantie wordt blootgesteld door de uitbreiding van MA.
De extensie MA installeren en configureren
-
Installeren - Als u de extensie MA wilt installeren, opent u de eigenschap voor extensie Extensions > Catalog, boven de Adobe Media Analytics for Audio and Video en selecteert u Install.
-
Configureren - Om de uitbreiding van MA te vormen, open Extensions , plaatst u de cursor boven de extensie en selecteert u vervolgens Configure:
Configuratieopties:
window
objectHerinnering: De extensie MA vereist de Analyse en Experience Cloud-id extensies. U moet deze uitbreidingen aan uw uitbreidingsbezit ook toevoegen en hen vormen.
De extensie MA gebruiken
Werken via een webpagina/JS-app
De extensie MA exporteert de MediaHeartbone-API's in het algemene vensterobject door de instelling "API's exporteren naar vensterobject" in te schakelen in het dialoogvenster Configuration pagina. Het exporteert de API's onder de naam van de geconfigureerde variabele. Bijvoorbeeld, als de veranderlijke naam wordt gevormd om te zijn ADB
dan kan MediaHeartbone door worden betreden window.ADB.MediaHeartbeat
.
window["CONFIGURED_VARIABLE_NAME"]
is ongedefinieerd en overschrijft bestaande variabelen niet.-
MediaHeartbone-instantie maken:
window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat.getInstance
Param: Een geldig gedelegeerd object dat deze functies toegankelijk maakt.
table 0-row-2 1-row-2 2-row-2 1-align-left 2-align-left 4-align-left 5-align-left 7-align-left 8-align-left Methode Beschrijving getQoSObject()
Retourneert theMediaObject
instantie die huidige informatie QoS bevat. Deze methode wordt meerdere keren aangeroepen tijdens een afspeelsessie. De implementatie van de speler moet altijd de recentst beschikbare gegevens terugkeren QoS.getCurrentPlaybackTime()
Retourneert de huidige positie van de afspeelkop. Voor het bijhouden van VOD wordt de waarde opgegeven in seconden vanaf het begin van het media-item. Voor het bijhouden van LIVE-/LIVE-waarden wordt de waarde opgegeven in seconden vanaf het begin van het programma. Retourwaarde: Een belofte die ofwel met een
MediaHeartbeat
-instantie of wordt door een foutbericht geweigerd. -
Toegang tot MediaHeartbone-constanten:
window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat
Hiermee worden alle constanten en statische methoden van de
MediaHeartbeat
klasse.U kunt de voorbeeldspeler hier verkrijgen: Voorbeeldspeler van MA. De voorbeeldspeler fungeert als een referentie waarmee u kunt laten zien hoe u de extensie MA kunt gebruiken om Media Analytics rechtstreeks vanuit een webapp te ondersteunen.
-
Maak als volgt de instantie van MediaHeartbone tracker:
code language-javascript var MediaHeartbeat = window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat; var delegate = { getCurrentPlaybackTime: this._getCurrentPlaybackTime.bind(this), getQoSObject: this._getQoSObject.bind(this), }; var config = { playerName: "Custom Player", ovp: "Custom OVP", channel: "Custom Channel" }; var self = this; MediaHeartbeat.getInstance(delegate, config).then(function(instance) { self._mediaHeartbeat = instance; // Do Tracking using the MediaHeartbeat instance. }).catch(function(err){ // Getting MediaHeartbeat instance failed. });
Werken met andere extensies
De extensie MA stelt de get-instance
en media-heartbeat
gedeelde modules aan andere uitbreidingen. (Voor extra informatie over Gedeelde Modules, zie Documentatie van gedeelde modules.)
turbine
(zie codevoorbeeld hieronder) buiten een extensie.-
MediaHeartbone-instantie maken:
get-instance
Gedeelde moduleParam:
-
Een geldig gedelegeerd object dat deze functies toegankelijk maakt:
table 0-row-2 1-row-2 2-row-2 1-align-left 2-align-left 4-align-left 5-align-left 7-align-left 8-align-left Methode Beschrijving getQoSObject()
Hiermee wordt het MediaObject
instantie die de huidige informatie QoS bevat. Deze methode wordt meerdere keren aangeroepen tijdens een afspeelsessie. De spelerimplementatie moet altijd de laatst beschikbare gegevens terugkeren QoS.getCurrentPlaybackTime()
Retourneert de huidige positie van de afspeelkop. Voor het bijhouden van VOD wordt de waarde opgegeven in seconden vanaf het begin van het media-item. Voor het bijhouden van LIVE-/LIVE-waarden wordt de waarde opgegeven in seconden vanaf het begin van het programma. -
Een optioneel config-object dat deze eigenschappen toegankelijk maakt:
table 0-row-3 1-row-3 2-row-3 3-row-3 1-align-left 2-align-left 3-align-left 5-align-left 6-align-left 7-align-left 9-align-left 10-align-left 11-align-left 13-align-left 14-align-left 15-align-left Eigenschap Beschrijving Vereist Onlinevideoprovider Naam van het online videoplatform waarmee inhoud wordt gedistribueerd. Nee. Indien aanwezig, treedt de waarde met voeten die tijdens uitbreidingsconfiguratie wordt bepaald. Naam speler Naam van de mediaspeler in gebruik (bijvoorbeeld "AVPlayer", "HTML5 Player", "My Custom VideoPlayer") Nee. Indien aanwezig, treedt de waarde met voeten die tijdens uitbreidingsconfiguratie wordt bepaald. Kanaal Channel name, eigenschap Nee. Indien aanwezig, treedt de waarde met voeten die tijdens uitbreidingsconfiguratie wordt bepaald.
Retourwaarde: Een belofte die ofwel met een
MediaHeartbeat
-instantie of wordt door een foutbericht geweigerd. -
-
Toegang tot MediaHeartbone-constanten:
media-heartbeat
Gedeelde moduleDeze module stelt alle constanten en statische methoden van deze klasse beschikbaar: https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript/MediaHeartbeat.html.
-
Maak als volgt de instantie van MediaHeartbone tracker:
code language-javascript var getMediaHeartbeatInstance = turbine.getSharedModule('adobe-video-analytics', 'get-instance'); var MediaHeartbeat = turbine.getSharedModule('adobe-video-analytics', 'media-heartbeat'); ... var delegate = { getCurrentPlaybackTime: this._getCurrentPlaybackTime.bind(this), getQoSObject: this._getQoSObject.bind(this), } var config = { playerName: "Custom Player", ovp: "Custom OVP", channel: "Custom Channel" } ... var self = this; getMediaHeartbeatInstance(delegate, config).then(function(instance) { self._mediaHeartbeat = instance; ... // Do Tracking using the MediaHeartbeat instance. }).catch(function(err){ // Getting MediaHeartbeat instance failed. }); ...
-
Gebruik de Media Heartboard-instantie om de JS-documentatie van Media SDK en JS API-documentatie om mediatracering te implementeren.