DokumentationAnalyticsAnvändarhandbok för insamling av direktuppspelade medier

Konfigurera JavaScript 2.x set-up-javascript

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

Skapat för:

  • Användare
  • Administratör
  • Utvecklare

Förutsättningar

  • Hämta giltiga konfigurationsparametrar
    Dessa parametrar kan hämtas från en Adobe-representant när du har konfigurerat ditt analyskonto.

  • Implementera AppMeasurement för JavaScript i ditt medieprogram
    Mer information om Adobe Mobile SDK-dokumentationen finns i Implementera analys med JavaScript.

  • Tillhandahåll följande funktioner i din mediespelare:

    • Ett API för att prenumerera på spelarhändelser - Media SDK kräver att du anropar en uppsättning enkla API:er när händelser inträffar i spelaren.
    • Ett API som tillhandahåller spelarinformation - Den här informationen innehåller information som medienamnet och spelhuvudets position.

  1. Lägg till ditt hämtade-bibliotek i ditt projekt. Skapa lokala referenser till klasserna.

    1. Expandera filen MediaSDK-js-v2.*.zip som du hämtade.

    2. Kontrollera att filen MediaSDK.min.js finns i katalogen libs:

    3. Värd för filen MediaSDK.min.js.

      Den här JavaScript-huvudfilen måste finnas på en webbserver som är tillgänglig för alla sidor på webbplatsen. Du behöver sökvägen till de här filerna för nästa steg.

    4. Referens MediaSDK.min.js på alla webbplatssidor.

      Inkludera MediaSDK för JavaScript genom att lägga till följande kodrad i taggen <head> eller <body> på varje sida. Exempel:

      code language-none 
      <script type="text/javascript"
src="https://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/MediaSDK.min.js"></script>

    5. Du kan snabbt verifiera att biblioteket har importerats genom att instansiera klassen ADB.va.MediaHeartbeatConfig.

      note note
      NOTE
      Från och med version 2.1.0 är JavaScript SDK kompatibelt med modulspecifikationerna AMD och CommonJS, och VideoHeartbeat.min.js kan även användas med kompatibla modulinläsare.

  2. Skapa lokala referenser till klasserna MediaHeartbeat för enkel åtkomst till API:erna.

    code language-js 
    var MediaHeartbeat = ADB.va.MediaHeartbeat;
var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig;
var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate;

  3. Skapa en MediaHeartbeatConfig-instans.

    I det här avsnittet får du hjälp med att förstå MediaHeartbeat-konfigurationsparametrar och hur du ställer in rätt konfigurationsvärden för din MediaHeartbeat-instans för korrekt spårning.

    Här följer ett exempel på MediaHeartbeatConfig-initiering:

    code language-js 
    //Media Heartbeat initialization
var mediaConfig = new MediaHeartbeatConfig();
mediaConfig.trackingServer = Configuration.HEARTBEAT.TRACKING_SERVER;
mediaConfig.playerName = Configuration.PLAYER.NAME;
mediaConfig.channel = Configuration.HEARTBEAT.CHANNEL;
mediaConfig.debugLogging = true;
mediaConfig.appVersion = Configuration.HEARTBEAT.SDK;
mediaConfig.ssl = false;
mediaConfig.ovp = Configuration.HEARTBEAT.OVP;

  4. Implementera protokollet MediaHeartbeatDelegate.

    code language-js 
    var mediaDelegate = new MediaHeartbeatDelegate();

// Replace <currentPlaybackTime> with the video player current playback time
mediaDelegate.getCurrentPlaybackTime = function() {
    return <currentPlaybackTime>;
};

// Replace <bitrate>, <startuptime>, <fps> and <droppeFrames> with the current playback QoS values.
mediaDelegate.getQoSObject = function() {
    return MediaHeartbeat.createQoSObject(<bitrate>, <startuptime>, <fps>, <droppedFrames>);
};

  5. Skapa instansen MediaHeartbeat.

    Använd MediaHeartbeatConfig och MediaHeartbeatDelegate för att skapa MediaHeartbeat-instansen.

    code language-js 
    this.mediaHeartbeat = new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurement);
    note important
    IMPORTANT
    Se till att din MediaHeartbeat-instans är tillgänglig och inte tas bort förrän mediesessionen är slut. Den här instansen kommer att användas för alla följande spårningshändelser.
    note tip
    TIP
    MediaHeartbeat kräver en instans av AppMeasurement för att kunna skicka anrop till Adobe Analytics. Här är ett exempel på en AppMeasurement-instans:
    code language-js 
    var appMeasurement = new AppMeasurement();
appMeasurement.visitor = visitor;
appMeasurement.trackingServer = "<visitor_namespace>.sc.omtrdc.net";
appMeasurement.account = <rsid>;
appMeasurement.pageName = <page_name>;
appMeasurement.charSet = "UTF­8";

Migrera från JavaScript 1.x till 2.x

I version 2.x konsolideras alla publika metoder i klassen ADB.va.MediaHeartbeat så att det blir enklare för utvecklare. Dessutom konsolideras nu alla konfigurationer i klassen ADB.va.MediaHeartbeatConfig.

Mer information om hur du migrerar från 1.x till 2.x finns i dokumentationen för den äldre implementeringen.

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb