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 extensie Media Analytics (MA) voegt de core JavaScript Media SDK (Media 2.x SDK) toe. Deze extensie biedt de functionaliteit voor het toevoegen van de MediaHeartbeat
tracker-instantie aan 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:
MediaHeartbeat
API's van uw webtoepassing gebruiken- Neem een spelerspecifieke extensie op of maak een Player-specifieke extensie die specifieke media Player-gebeurtenissen toewijst aan de API's in de
MediaHeartbeat
tracker-instantie. Deze instantie wordt blootgesteld door de uitbreiding van MA.
De extensie MA installeren en configureren
-
installeer - om de uitbreiding van MA te installeren, open uw uitbreidingsbezit, uitgezochte Extensions > Catalog, beweegt over de Adobe Media Analytics for Audio and Video uitbreiding, en selecteert Install.
-
vormt - om de uitbreiding van MA te vormen, open het Extensions lusje, over de uitbreiding te bewegen, en dan te selecteren Configure:
Configuratieopties:
window
-objectHerinnering: de uitbreiding van MA vereist de Analyticsen identiteitskaart van het Experience Clouduitbreidingen. 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 op de pagina Configuration . Het exporteert de API's onder de naam van de geconfigureerde variabele. Als de variabelenaam bijvoorbeeld is ingesteld op ADB
, kan MediaHeartbeat worden benaderd door window.ADB.MediaHeartbeat
.
window["CONFIGURED_VARIABLE_NAME"]
ongedefinieerd is en bestaande variabelen niet overschrijft.-
creeer MediaHeartbone Instantie:
window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat.getInstance
Params: Een geldig afgevaardigde voorwerp dat deze functies blootstelt.
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 de huidige QoS-informatie 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. Waarde van de Terugkeer: Een belofte die of met a
MediaHeartbeat
instantie of verwerpt met een foutenmelding lost. -
De Constanten van MediaHeartbeat van de Toegang:
window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat
Dit stelt alle constanten en statische methodes van de
MediaHeartbeat
klasse bloot.U kunt de steekproefspeler hier verkrijgen: Speler van de Steekproef 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 gedeelde get-instance
en media-heartbeat
modules beschikbaar voor andere extensies. (Voor extra informatie over Gedeelde Modules, zie Gedeelde documentatie van Modules.)
turbine
(zie het codevoorbeeld hieronder) buiten een extensie gebruiken.-
creeer de Instantie MediaHeartbeat:
get-instance
Gedeelde ModuleParams:
-
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 de MediaObject
-instantie die de huidige QoS-informatie 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.
Waarde van de Terugkeer: Een belofte die of met a
MediaHeartbeat
instantie of verwerpt met een foutenmelding lost. -
-
De Constanten van MediaHeartbeat van de Toegang:
media-heartbeat
Gedeelde ModuleDeze module stelt alle constanten en statische methodes van deze klasse bloot: 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. }); ...
-
Gebruikend de instantie van de Hartslag van Media, volg de documentatie van SDK van Media JSen JS API documentatieom media het volgen uit te voeren.