Show Menu
TOPICS×

Configuration de JavaScript 3.x

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.
  • Implémentez
    AppMeasurement
    et
    Experience Cloud Identity Service
    pour JavaScript dans votre application multimédia
    Pour plus d’informations, reportez-vous aux sections Mise en œuvre d’Analytics à l’aide de JavaScript et Mise en œuvre d’Experience Cloud Identity Service.
  • 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 sur le lecteur
       : elle inclut des informations sur les médias en cours de lecture, les publicités et le chapitre.
  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-v3*.zip
      que vous avez téléchargé.
    2. Vérifiez que le répertoire
      libs
      contient le fichier
      MediaSDK.js
      .
    3. Hébergez le fichier
      MediaSDK.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.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.js"></script>
    5. Pour vérifier rapidement que la bibliothèque a bien été importée, contrôlez que
      ADB.Media
      est exporté sur l’objet Window.
      Le SDK JavaScript est conforme aux spécifications du module AMD et CommonJS, et
      MediaSDK.js
      peut également être utilisé avec les chargeurs de module compatibles.
  2. Créez une instance d’
    AppMeasurement
    et configurez
    visitor
    .
    La configuration du SDK Media requiert une instance d’
    AppMeasurement
    avec
    visitor
    configuré.
    var appMeasurement = new AppMeasurement(“<rsid>”); appMeasurement.visitor = visitor; appMeasurement.trackingServer = “<visitor_namespace>.sc.omtrdc.net”;
  3. Configuration du SDK Media
    Le SDK Media doit être configuré une fois par page web, et la configuration s’applique à toutes les instances de dispositif de suivi créées.
    Media SDK (3.x) utilise l’API Media Collection pour effectuer le suivi des médias, qui est distincte du point de terminaison HB utilisé dans les SDK 2.x. Prenez contact avec votre représentant Adobe pour obtenir plus d’informations.
    Voici un exemple d’initialisation de
    MediaConfig
     :
    // Create MediaConfig object (same as above) var mediaConfig = new ADB.MediaConfig(); mediaConfig.trackingServer = Configuration.MEDIA_COLLECTION_ENDPOINT; mediaConfig.playerName = Configuration.PLAYER_NAME; mediaConfig.channel = Configuration.CHANNEL; mediaConfig.appVersion = Configuration.APP_VERSION; mediaConfig.debugLogging = false; mediaConfig.ssl = true; ADB.Media.configure(mediaConfig, appMeasurement);
  4. Créez l’instance
    MediaTracker
    .
    Après avoir configuré le SDK Media, il est possible de créer des instances de dispositifs de suivi du contenu multimédia à l’aide de l’API
    getInstance
    .
    var tracker = ADB.Media.getInstance();
    Assurez-vous que votre instance
    tracker
    est accessible et reste attribuée jusqu’à la fin de la session multimédia. Cette instance sera utilisée pour effectuer le suivi de tous les événements suivants pour cette session.

Migration de JavaScript 2.x vers 3.x

Pour plus d’informations sur la migration de 2.x vers 3.x, voir Migration de 2.x vers 3.x.