Adobe Media Analytics för ljud- och videotillägg - översikt
Använd den här dokumentationen om du vill ha information om hur du installerar, konfigurerar och implementerar tillägget Adobe Media Analytics för ljud och video (tillägget Media Analytics). Här finns alternativ som är tillgängliga när du använder det här tillägget för att skapa en regel, tillsammans med exempel och länkar till exempel.
Tillägget Media Analytics (MA) lägger till JavaScript Media SDK (Media 2.x SDK). Det här tillägget innehåller funktioner för att lägga till spårningsinstansen MediaHeartbeat
till en taggplats eller ett -projekt. MA-tillägget kräver ytterligare två tillägg:
När du har inkluderat alla tre av tilläggen som nämns ovan i taggprojektet kan du fortsätta på ett av två sätt:
- Använd
MediaHeartbeat
API:er från ditt webbprogram - Inkludera, eller bygg, ett spelarspecifikt tillägg som mappar specifika mediespelarhändelser till API:erna på spårningsinstansen
MediaHeartbeat
. Den här instansen visas genom MA-tillägget.
Installera och konfigurera MA-tillägget
-
Installera - Om du vill installera MA-tillägget öppnar du tilläggsegenskapen, väljer Extensions > Catalog, håller pekaren över Adobe Media Analytics for Audio and Video-tillägget och väljer Install.
-
Konfigurera - Om du vill konfigurera MA-tillägget öppnar du fliken Extensions, hovrar över tillägget och väljer Configure:
Konfigurationsalternativ:
window
Påminnelse: För MA-tillägget krävs tilläggen Analytics och Experience Cloud ID. Du måste också lägga till dessa tillägg i tilläggsegenskapen och konfigurera dem.
Använda MA-tillägget
Använda från en webbsida/JS-app
MA-tillägget exporterar MediaHeartbeat-API:er i det globala fönsterobjektet genom att aktivera inställningen Exportera API:er till Window-objekt på sidan Configuration. Den exporterar API:erna under det konfigurerade variabelnamnet. Om till exempel variabelnamnet är konfigurerat till ADB
kan MediaHeartbeat användas av window.ADB.MediaHeartbeat
.
window["CONFIGURED_VARIABLE_NAME"]
är odefinierad och inte åsidosätter befintliga variabler.-
Skapa MediaHeartbeat-instans:
window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat.getInstance
Parametrar: Ett giltigt delegatobjekt som visar dessa funktioner.
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 Metod Beskrivning getQoSObject()
Returnerar theMediaObject
-instans som innehåller aktuell QoS-information. Den här metoden anropas flera gånger under en uppspelningssession. Spelarimplementeringen måste alltid returnera de senast tillgängliga QoS-data.getCurrentPlaybackTime()
Returnerar spelhuvudets aktuella position. För VOD-spårning anges värdet i sekunder från mediaobjektets början. För LIVE/LIVE-spårning anges värdet i sekunder från programmets början. Returvärde: Ett löfte som antingen löses med en
MediaHeartbeat
-instans eller avvisas med ett felmeddelande. -
Åtkomst till MediaHeartbeat-konstanter:
window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat
Då visas alla konstanter och statiska metoder från klassen
MediaHeartbeat
.Du kan hämta exempelspelaren här: MA-exempelspelaren. Exempelspelaren fungerar som en referens för att visa hur man använder MA-tillägget för att stödja Media Analytics direkt från en webbapp.
-
Skapa spårningsinstansen för MediaHeartbeat enligt följande:
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. });
Använda från andra tillägg
MA-tillägget visar de delade modulerna get-instance
och media-heartbeat
för andra tillägg. (Mer information om delade moduler finns i Dokumentation om delade moduler.)
turbine
(se kodexempel nedan) utanför ett tillägg.-
Skapa MediaHeartbeat-instans:
get-instance
Delad modulParametrar:
-
Ett giltigt delegatobjekt som visar dessa funktioner:
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 Metod Beskrivning getQoSObject()
Returnerar instansen MediaObject
som innehåller aktuell QoS-information. Den här metoden anropas flera gånger under en uppspelningssession. Spelarimplementeringen måste alltid returnera de senast tillgängliga QoS-data.getCurrentPlaybackTime()
Returnerar spelhuvudets aktuella position. För VOD-spårning anges värdet i sekunder från mediaobjektets början. För LIVE/LIVE-spårning anges värdet i sekunder från programmets början. -
Ett valfritt config-objekt som visar dessa egenskaper:
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 Egenskap Beskrivning Obligatoriskt Onlinevideoprovider Namnet på onlinevideoplattformen som innehållet distribueras via. Nej. Om det finns åsidosätter det värde som definierats under tilläggskonfigurationen. Spelarnamn Namnet på den mediespelare som används (t.ex. "AVPlayer", "HTML5 Player", "My Custom VideoPlayer") Nej. Om det finns åsidosätter det värde som definierats under tilläggskonfigurationen. Kanal Egenskapen Kanalnamn Nej. Om det finns åsidosätter det värde som definierats under tilläggskonfigurationen.
Returvärde: Ett löfte som antingen löses med en
MediaHeartbeat
-instans eller avvisas med ett felmeddelande. -
-
Åtkomst till MediaHeartbeat-konstanter:
media-heartbeat
Delad modulDen här modulen visar alla konstanter och statiska metoder från den här klassen: https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript/MediaHeartbeat.html.
-
Skapa spårningsinstansen för MediaHeartbeat enligt följande:
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. }); ...
-
Använd Media Heartbeat-instansen och följ dokumentationen för Media SDK JSoch JS APIför att implementera mediespårning.