DocumentatieAnalyticsHandleiding voor het streamen van media

JavaScript 2.x instellen set-up-javascript

Last update: Fri Nov 11 2022 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Gebruiker
  • Beheerder
  • Ontwikkelaar

Vereisten

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

  • Implementeren AppMeasurement voor JavaScript in uw mediatoepassing
    Voor meer informatie over de documentatie van Adobe Mobile SDK, zie Analyses implementeren met JavaScript.

  • Biedt de volgende mogelijkheden in uw mediaspeler:

    • Een API die zich moet abonneren op spelergebeurtenissen - De SDK van Media vereist dat u een set eenvoudige API's oproept wanneer gebeurtenissen in de speler plaatsvinden.
    • Een API die spelerinformatie biedt - Deze informatie bevat details zoals de medianaam en de positie van de afspeelkop.

  1. Voeg uw gedownload bibliotheek naar uw project. Maak lokale verwijzingen naar de klassen voor het gemak.

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

    2. Controleer of de MediaSDK.min.js bestand bestaat in het dialoogvenster libs map:

    3. De gastheer van MediaSDK.min.js bestand.

      Dit kern-JavaScript-bestand 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. Referentie MediaSDK.min.js op alle sitepagina's.

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

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

    5. Als u snel wilt controleren of de bibliotheek is geïmporteerd, instantieert u het dialoogvenster ADB.va.MediaHeartbeatConfig klasse.

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

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

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

  3. Een MediaHeartbeatConfig -instantie.

    Deze sectie helpt u begrijpen MediaHeartbeat config parameters en hoe te om correcte config waarden op uw te plaatsen MediaHeartbeat voor nauwkeurige tracering.

    Hier volgt een voorbeeld van initialisatie van MediaHeartbeatConfig:

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

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

    Gebruik de MediaHeartbeatConfig en MediaHeartbeatDelegate om de MediaHeartbeat -instantie.

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

Migreren van JavaScript 1.x naar 2.x

In versie 2.x worden alle methoden van het type public geconsolideerd in de ADB.va.MediaHeartbeat om het voor ontwikkelaars gemakkelijker te maken. Bovendien worden alle configuraties nu geconsolideerd in de ADB.va.MediaHeartbeatConfig klasse.

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