DocumentatieAnalyticsHandleiding voor het streamen van mediaverzameling

JavaScript 2.x instellen

Laatst bijgewerkt: 14 juli 2025
  • Onderwerpen:

Gemaakt voor:

  • Gebruiker
  • Beheerder
  • Ontwikkelaar

Vereisten

  • verkrijg geldige configuratieparameters
    Deze parameters kunt u verkrijgen van een Adobe-medewerker nadat u uw analyseaccount hebt ingesteld.

  • voer AppMeasurement voor JavaScript in uw media toepassing uit
    Voor meer informatie over de documentatie van Adobe Mobile SDK, zie het Uitvoeren Analytics die JavaScript gebruiken.

  • verstrek de volgende mogelijkheden in uw media speler:

    • API om aan spelergebeurtenissen in te tekenen - de Media SDK vereist dat u een reeks eenvoudige APIs roept wanneer de gebeurtenissen in uw speler voorkomen.
    • API die spelerinformatie verstrekt - Deze informatie omvat details zoals de media naam en de positie van het spelhoofd.

  1. Voeg uw gedownloadbibliotheek aan uw project toe. Maak lokale verwijzingen naar de klassen voor het gemak.

    1. Vouw het MediaSDK-js-v2.*.zip -bestand uit dat u hebt gedownload.

    2. Controleer of het bestand MediaSDK.min.js aanwezig is in de map libs :

    3. Het MediaSDK.min.js -bestand hosten.

      Dit JavaScript-kernbestand moet worden gehost op een webserver die toegankelijk is voor alle pagina's op uw site. Voor de volgende stap hebt u het pad naar deze bestanden nodig.

    4. Verwijzing MediaSDK.min.js op alle sitepagina's.

      Neem MediaSDK op voor JavaScript door de volgende coderegel toe te voegen in de tag <head> of <body> op elke pagina. Bijvoorbeeld:

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

    5. Instantieer de klasse ADB.va.MediaHeartbeatConfig om snel te controleren of de bibliotheek is geïmporteerd.

      NOTE
      Vanaf versie 2.1.0 voldoet de JavaScript SDK aan de specificaties van de AMD- en CommonJS-module en kan VideoHeartbeat.min.js ook worden gebruikt met compatibele moduleloaders.

  2. Voor eenvoudige toegang tot de API's maakt u lokale verwijzingen naar de MediaHeartbeat -klassen.

    var MediaHeartbeat = ADB.va.MediaHeartbeat;
var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig;
var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate;

  3. Maak een MediaHeartbeatConfig -instantie.

    Deze sectie helpt u MediaHeartbeat configuratieparameters te begrijpen en hoe te om correcte configuratiewaarden op uw MediaHeartbeat instantie, voor nauwkeurige het volgen te plaatsen.

    Hier volgt een voorbeeld van initialisatie van MediaHeartbeatConfig:

    //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. Implementeer het protocol MediaHeartbeatDelegate .

    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. Maak de MediaHeartbeat -instantie.

    Gebruik MediaHeartbeatConfig en MediaHeartbeatDelegate om de instantie MediaHeartbeat te maken.

    this.mediaHeartbeat = new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurement);
    IMPORTANT
    Zorg ervoor dat uw MediaHeartbeat -instantie toegankelijk is en pas aan het einde van de mediasessie wordt gedealiteerd. Deze instantie wordt gebruikt voor alle volgende gebeurtenissen tracking.
    TIP
    MediaHeartbeat vereist een instantie van AppMeasurement om aanroepen naar Adobe Analytics te verzenden. Hier volgt een voorbeeld van een instantie AppMeasurement :
    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";

Migreren van JavaScript 1.x naar 2.x

In versie 2.x worden alle methoden van het type public geconsolideerd in de klasse ADB.va.MediaHeartbeat , zodat ontwikkelaars deze eenvoudiger kunnen gebruiken. Bovendien worden alle configuraties nu geconsolideerd in de klasse ADB.va.MediaHeartbeatConfig .

Raadpleeg de documentatie bij Legacy Implementation voor informatie over het migreren van 1.x naar 2.x.

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