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émentezAppMeasurementetExperience Cloud Identity Servicepour 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.

      REMARQUE

      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.

    IMPORTANT

    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();
    
    IMPORTANT

    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.

Sur cette page