DokumentationExperience PlatformTaggar

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

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Utvecklare
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. I följande dokument finns en konsoliderad referens till de ändrade terminologin.

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 ljud- och videotillä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 funktionalitet för att lägga till spårningsinstansen Media 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å spårningsinstansen Media. 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 (3.x SDK) 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:

Konfiguration av MA-tillägg

Konfigurationsalternativ:

Alternativ
Beskrivning
Collection API Server
Definierar Media Collection API Server (kontakta Adobe för att få tag i 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 objektet 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 medie-API:erna i det globala fönsterobjektet genom att aktivera inställningen Exportera API:er till fönsterobjekt på sidan Configuration. Den exporterar API:erna under det konfigurerade variabelnamnet. Om till exempel variabelnamnet är konfigurerat till 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 inte åsidosätter 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: En Media spårningsinstans för att spåra en mediasession.

    code language-javascript 
    var Media = window["CONFIGURED_VARIABLE_NAME"].Media;

var tracker = Media.getInstance();

  3. Använd Media Tracker-instansen och följ JS API-dokumentationen för att implementera mediespårning.

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.

Använda från andra tillägg

MA-tillägget visar media som en delad modul för andra tillägg. (Mer information om delade moduler finns i Dokumentation om 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: En Media spårningsinstans för att spåra en mediasession.

    code language-javascript 
    var Media =
  turbine.getSharedModule('adobe-media-analytics', 'media');

var tracker = Media.getInstance();

  3. Använd Media Tracker-instansen och följ JS API-dokumentationen för att implementera mediespårning.

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