Adobe Media Analytics (3.x SDK) for Audio and Video extension overview

NOTE
Adobe Experience Platform Launch har omklassificerats som en serie datainsamlingstekniker i Adobe Experience Platform. Som ett resultat av detta har flera terminologiska förändringar införts i produktdokumentationen. Se följande dokument för en konsoliderad hänvisning till terminologiska förändringar.

Använd den här dokumentationen om du vill ha information om hur du installerar, konfigurerar och implementerar Adobe Media Analytics (3.x SDK) för Audio- och Video-tillägg (Media Analytics-tillägg). 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 3.x SDK). Det här tillägget innehåller funktioner för att lägga till Media spårningsinstans till en tagghanterad webbplats eller ett tagghanterat projekt. MA-tillägget kräver ytterligare två tillägg:

IMPORTANT
Det här tillägget distribueras med Media 3.x SDK, som inte är bakåtkompatibelt med Media 2.x SDK. Eftersom 2.x har tagits bort bör du uppdatera till 3.x.

När du har inkluderat alla tre av de tillägg som nämns ovan i det tagghanterade projektet kan du fortsätta på ett av två sätt:

  • Använd Media API:er från ditt webbprogram
  • Inkludera, eller bygg, ett spelarspecifikt tillägg som mappar specifika mediespelarhändelser till API:erna på Media spårarinstans. 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 och väljer Extensions > Catalog, hovra över Adobe Media Analytics (3.x SDK) for Audio and Video och markera Install.

  • Konfigurera: Om du vill konfigurera MA-tillägget öppnar du Extensions hovra över tillägget och välj Configure:

Konfiguration av MA-tillägg

Konfigurationsalternativ:

Alternativ
Beskrivning
Collection API Server
Definierar API-servern för mediainsamling (kontakta Adobe för att få tillgång till den här servern)
Programversion
Versionen av mediespelarappen/SDK
Spelarnamn
Namnet på den mediespelare som används (t.ex. "AVPlayer", "HTML5 Player", "My Custom VideoPlayer")
Kanal
Egenskapen Kanalnamn
Felsökningsloggning
Aktivera eller inaktivera loggning
Aktivera SSL
Aktivera eller inaktivera sändning av ping via HTTPS
Exportera API:er till Window-objekt
Aktivera eller inaktivera export av Media Analytics-API:er till globalt omfång
Variabelnamn
En variabel som du använder för att exportera Media Analytics-API:er under window object

Påminnelse: MA-tillägget kräver Analyser och Experience Cloud ID tillägg. 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 medie-API:erna i det globala fönsterobjektet genom att aktivera inställningen "Exportera API:er till fönsterobjekt" i dialogrutan Configuration sida. Den exporterar API:erna under det konfigurerade variabelnamnet. Om till exempel variabelnamnet är konfigurerat att ADB, kan medie-API:er nås av window.ADB.Media.

IMPORTANT
MA-tillägget exporterar bara API:erna när window["CONFIGURED_VARIABLE_NAME"] är odefinierad och åsidosätter inte befintliga variabler.
  1. Media-API  window["CONFIGURED_VARIABLE_NAME"].Media

    Detta visar alla API:er och konstanter från Media SDK: https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html

  2. Skapa mediespårarinstans:  window["CONFIGURED_VARIABLE_NAME"].Media.getInstance

    Returvärde: A Media spårningsinstans för att spåra en mediesession.

    code language-javascript
    var Media = window["CONFIGURED_VARIABLE_NAME"].Media;
    
    var tracker = Media.getInstance();
    
  3. Använd Media Tracker-instansen för att följa JS API-dokumentation för att implementera mediespårning.

Du kan hämta exempelspelaren här: MA Sample Player. 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.

Använda från andra tillägg

MA-tillägget visar media som en delad modul till andra tillägg. (Mer information om delade moduler finns i Dokumentation för delade moduler.)

IMPORTANT
Delade moduler kan bara nås från andra tillägg. Det innebär att en webbsida/JavaScript-app inte kan komma åt de delade modulerna eller använda turbine (se kodexempel nedan) utanför ett tillägg.
  1. Media-API  media Delad modul

    Detta visar alla API:er och konstanter från Media SDK: https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html

  2. Skapa Media Tracker-instansen enligt följande:

    Returvärde: A Media spårningsinstans för att spåra en mediesession.

    code language-javascript
    var Media =
      turbine.getSharedModule('adobe-media-analytics', 'media');
    
    var tracker = Media.getInstance();
    
  3. Använd Media Tracker-instansen för att följa JS API-dokumentation för att implementera mediespårning.

NOTE
Testning: För att testa tillägget i den här versionen måste du överföra det till Plattform, där du har tillgång till alla beroende tillägg.
recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743