Show Menu
TOPICS×

Configuration de JavaScript

Conditions préalables

  • Obtention de paramètres de configuration valides
     Vous pouvez vous procurer ces paramètres auprès d’un représentant Adobe après avoir configuré votre compte Analytics.
  • Mise en œuvre
    AppMeasurement
    pour JavaScript dans votre application multimédia
    Pour plus d’informations sur la documentation du SDK Adobe Mobile, reportez-vous à la rubrique Mise en œuvre d’Analytics à l’aide de JavaScript.
  • Fournissez les informations suivantes à votre lecteur multimédia :
    • Une API pour vous abonner aux événements du lecteur
      - Le SDK Media exige d’appeler un ensemble d’API simples lorsque des événements se produisent dans votre lecteur.
    • Une API qui fournit des informations au lecteur
      - Ces informations incluent des éléments tels que le nom du média et la position de la tête de lecture.
  1. Ajoutez la bibliothèque que vous avez téléchargée à votre projet. Créez des références locales aux classes pour des raisons pratiques.
    1. Développez le fichier
      MediaSDK-js-v2.*.zip
      que vous avez téléchargé.
    2. Vérifiez que le répertoire
      MediaSDK.min.js
      contient le fichier
      libs
       :
    3. Hébergez le fichier
      MediaSDK.min.js
      .
      Ce fichier JavaScript principal doit être hébergé sur un serveur web accessible par toutes les pages de votre site. Vous avez besoin du chemin d’accès à ces fichiers pour l’étape suivante.
    4. Référencez
      MediaSDK.min.js
      sur toutes les pages du site.
      Insérez
      MediaSDK
      pour JavaScript en ajoutant la ligne de code suivante dans la balise
      <head>
      ou
      <body>
      de chaque page. Par exemple :
      <script type="text/javascript" src="https://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/MediaSDK.min.js"></script>
    5. Pour vérifier rapidement que la bibliothèque a bien été importée, instanciez la classe
      ADB.va.MediaHeartbeatConfig
      .
      À partir de la version 2.1.0, le kit SDK JavaScript est conforme aux spécifications du module AMD et CommonJS, et
      VideoHeartbeat.min.js
      peut également être utilisé avec les chargeurs de module compatibles.
  2. Pour faciliter l’accès aux API, créez des références locales aux classes
    MediaHeartbeat
    .
    var MediaHeartbeat = ADB.va.MediaHeartbeat; var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig; var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate;
  3. Créez une instance
    MediaHeartbeatConfig
    .
    Cette section vous aide à comprendre les paramètres de configuration
    MediaHeartbeat
    et à comprendre comment définir les bonnes valeurs de configuration sur votre instance
    MediaHeartbeat
    pour un suivi précis.
    Voici un exemple d’
    MediaHeartbeatConfig
    initialisation :
    //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. Mettez en œuvre le protocole
    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. Créez l’instance
    MediaHeartbeat
    .
    Utilisez les instances
    MediaHeartbeatConfig
    et
    MediaHeartbeatDelegate
    pour créer l’instance
    MediaHeartbeat
    .
    this.mediaHeartbeat = new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurement);
    Assurez-vous que votre instance
    MediaHeartbeat
    est accessible et reste attribuée jusqu’à la fin de la session multimédia. Cette instance sera utilisée pour tous les événements de suivi suivants.
    MediaHeartbeat
    requiert une instance de
    AppMeasurement
    pour envoyer des appels à Adobe Analytics. Voici un exemple d’une instance
    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";

Migration de la version 1.x vers 2.x dans JavaScript

Dans la version 2.x, toutes les méthodes publiques sont consolidées dans la classe
ADB.va.MediaHeartbeat
pour faciliter le travail des développeurs. De plus, toutes les configurations sont désormais consolidées dans la classe
ADB.va.MediaHeartbeatConfig
.
Pour plus d’informations sur la migration de 1.x vers 2.x, voir Migration de VHL 1.x vers 2.x.