DokumentationAnalyticsAnvändarhandbok för insamling av direktuppspelade medier

Äldre - installationsöversikt för Media SDK setup-overview

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

Skapat för:

  • Användare
  • Administratör
  • Utvecklare

När du har laddat ned Media SDK för din videoapp eller spelare följer du informationen i det här avsnittet för att konfigurera och implementera Media SDK.

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

Det finns tre SDK-huvudkomponenter som används för att spåra med tillägget Streaming Media Collection:

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

Implementera Streaming Media SDK

Slutför följande implementeringssteg om du vill konfigurera och använda Streaming Media SDK:

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

    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 mediaobjektets början.
    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 videospelare i HTML 5:

    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 startanrop 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
    Det krävs en RDC-spårningsserver eller CNAME som kan matchas till en RDC-server för Experience Cloud Visitor ID-tjänsten.

    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:

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