Adobe Media Analytics for Audio and Video extension overview
Använd den här dokumentationen för information om hur du installerar, konfigurerar och implementerar Adobe Media Analytics för ljud- och videotillägg (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.
Media Analytics-tillägget (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
MediaHeartbeatAPI: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:
windowPå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.getInstanceParametrar: 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 början av medieobjektet. 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"].MediaHeartbeatDå 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-instanceDelad 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 MediaObjectsom 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 början av medieobjektet. 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-heartbeatDelad 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 SDK JS och JS API för att implementera mediespårning.