Äldre 2.x Streaming Media SDK Setup Overview setup-overview

Instruktionerna i det här avsnittet gäller äldre 2.x-medie-SDK:er.

  • Mer information om hur du implementerar en 1.x-version av Media SDK finns i 1.x Media SDK Documentation.

  • Information om Primetime-integratörer finns i Primetime Media SDK Documentation.

IMPORTANT
När stödet för version 4 Mobile SDK upphör den 31 augusti 2021 upphör även stödet för Media Analytics SDK för iOS och Android. Mer information finns i Vanliga frågor och svar om SDK End-of-Support i Media Analytics.

Stöd för minst plattformsversion minimum-platform-version

I följande tabell beskrivs de lägsta plattformsversioner som stöds för varje SDK från och med den 19 februari 2019.

OS/webbläsare
Min version krävs
iOS
iOS 6+
Android
Android 5.0+ - Lollipop
Chrome
v22+
Mozilla
v27+
Safari
v7+
IE
v11+

Allmänna riktlinjer för genomförandet general-implementation-guidelines

Det finns tre huvudkomponenter i SDK för mediespårning:

  • Konfiguration för pulsslag i media - Konfigurationen innehåller de grundläggande inställningarna för rapportering.
  • Media Heartbeat Delegate - Delegaten styr uppspelningstiden och QoS-objektet.
  • Mediepulsslag - Det primära biblioteket som innehåller medlemmar och metoder.

Utför följande implementeringssteg:

  1. Skapa en MediaHeartbeatConfig-instans och ange parametervärden för config.

    table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 3-align-center 8-align-center 13-align-center 18-align-center 23-align-center 28-align-center 33-align-center 38-align-center
    Variabelnamn Beskrivning Obligatoriskt Standardvärde
    trackingServer Spårningsserver för medieanalys. Detta skiljer sig från analysspårningsservern. Ja Tom sträng
    channel Kanalnamn Nej Tom sträng
    ovp Namnet på onlinemedieplattformen som innehållet distribueras via Nej Tom sträng
    appVersion Version av mediespelarappen/SDK Nej Tom sträng
    playerName Namnet på den mediespelare som används, dvs."AVPlayer","HTML5 Player","My Custom Player" Nej Tom sträng
    ssl Anger om anrop ska göras via HTTPS Nej falskt
    debugLogging Anger om felsökningsloggning är aktiverat Nej falskt
  2. Implementera MediaHeartbeatDelegate.

    table 0-row-3 1-row-3 2-row-3 3-align-center 7-align-center 11-align-center
    Metodnamn Beskrivning Obligatoriskt
    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. Ja
    getCurrentPlaybackTime() Returnerar spelhuvudets aktuella position.
    För VOD-spårning anges värdet i sekunder från början av medieobjektet.
    Om spelaren inte anger information om innehållets varaktighet för direktuppspelning kan värdet anges som antalet sekunder sedan midnatt UTC den dagen.
    Obs! När du använder förloppsmarkörer krävs innehållets varaktighet och spelhuvudet måste uppdateras som antal sekunder från början av medieobjektet, med början från 0.
    Ja
    note tip
    TIP
    QoS-objektet (Quality of Service) är valfritt. Om QoS-data är tillgängliga för spelaren och du vill spåra dessa data, krävs följande variabler:
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center
    Variabelnamn Beskrivning Obligatoriskt
    bitrate Mediets bithastighet i bitar per sekund. Ja
    startupTime Starttiden för media i millisekunder. Ja
    fps Bildrutorna som visas per sekund. Ja
    droppedFrames Antalet uteslutna bildrutor hittills. Ja
  3. Skapa instansen MediaHeartbeat.

    Använd MediaHertbeatConfig och MediaHertbeatDelegate för att skapa MediaHeartbeat-instansen.

    note important
    IMPORTANT
    Se till att din MediaHeartbeat-instans är tillgänglig och inte tas bort förrän i slutet av sessionen. Den här instansen kommer att användas för alla följande mediespårningshändelser.
    note tip
    TIP
    MediaHeartbeat kräver en instans av AppMeasurement för att kunna skicka anrop till Adobe Analytics.
  4. Kombinera alla bitar.

    I följande exempelkod används JavaScript 2.x SDK för en HTML5-videospelare:

    code language-javascript
    // Create local references to the heartbeat classes
    var MediaHeartbeat = ADB.va.MediaHeartbeat;
    var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig;
    var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate;
    
    //Media Heartbeat Config
    var mediaConfig = new MediaHeartbeatConfig();
    mediaConfig.trackingServer = "[your_namespace].hb.omtrdc.net";
    mediaConfig.playerName = "HTML5 Basic";
    mediaConfig.channel = "Video Channel";
    mediaConfig.debugLogging = true;
    mediaConfig.appVersion = "2.0";
    mediaConfig.ssl = false;
    mediaConfig.ovp = "";
    
    // Media Heartbeat Delegate
    var mediaDelegate = new MediaHeartbeatDelegate();
    
    // Set mediaDelegate CurrentPlaybackTime
    mediaDelegate.getCurrentPlaybackTime = function() {
        return video.currentTime;
    };
    
    // Set mediaDelegate QoSObject - OPTIONAL
    mediaDelegate.getQoSObject = function() {
        return MediaHeartbeat.createQoSObject(video.bitrate,
                                              video.startuptime,
                                              video.fps,
                                              video.droppedframes);
    }
    // Create mediaHeartbeat instance
    this.mediaHeartbeat =
      new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurementInstance);
    

Validera validate

Spåra implementeringar med Media Analytics genererar två typer av spårningsanrop:

  • Media- och startsamtal skickas direkt till Adobe Analytics-servern (AppMeasurement).

  • Anrop till pulsslag skickas till Media Analytics-spårningsservern (hjärtslag) som bearbetas där och skickas vidare till Adobe Analytics-servern.

  • Adobe Analytics-server (AppMeasurement)
    Mer information om alternativ för spårning av serveralternativ finns i Fylla i variablerna trackingServer och trackingServerSecure korrekt.

    note important
    IMPORTANT
    En RDC-spårningsserver eller CNAME som löser problem med en RDC-server krävs för tjänsten Experience Cloud Visitor ID.

    Analysspårningsservern ska avslutas med .sc.omtrdc.net eller vara en CNAME.

  • ​ Media Analytics-server (Heartbeats)
    Det här har alltid formatet [your_namespace].hb.omtrdc.net. Värdet [your_namespace] anger ditt företag och tillhandahålls av Adobe.

Mediespårning fungerar likadant på alla plattformar, både datorer och mobila enheter. Ljudspårning fungerar för närvarande på mobilplattformar. För alla spårningsanrop finns det några viktiga universella variabler som ska valideras:

SDK 1.x - dokumentation sdk-1x-documentation

Video Analytics 1.x SDKs
Utvecklarhandböcker (endast PDF-filer)
Android
Konfigurera för Android
APPLE TV
Konfigurera för Apple TV
Kromecast
Konfigurera för Chromecast
iOS
Konfigurera för iOS
JavaScript
Konfigurera för JavaScript
Primetime
TVML
Konfigurera för TVML

Primetime Media SDK Documentation primetime-docs

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