Configurazione JavaScript 3.x

Prerequisiti

  • Ottenere parametri di configurazione validi
    Questi parametri possono essere ottenuti da un rappresentante di Adobe dopo la configurazione dell’account di analisi.

  • Implementa AppMeasurement e Experience Cloud Identity Service per JavaScript nell’applicazione multimediale
    Per ulteriori informazioni, consulta Implementazione di Analytics con JavaScript e Implementazione del servizio Experience Cloud Identity.

  • Fornisci le seguenti funzionalità nel lettore multimediale:

    • API per abbonarsi agli eventi del lettore: Media SDK richiede di chiamare un set di API semplici quando si verificano eventi nel lettore.
    • Un’API che fornisce informazioni sul lettore: questo include informazioni sui file multimediali, gli annunci e il capitolo attualmente in riproduzione.
  1. Aggiungi la libreria scaricata al progetto. Crea riferimenti locali alle classi per comodità.

    1. Espandi il file MediaSDK-js-v3*.zip che hai scaricato.

    2. Verifica che il file MediaSDK.js esista nella directory libs.

    3. Ospita il file MediaSDK.js.

      Questi file core JavaScript devono essere in hosting su un server Web accessibile a tutte le pagine del sito. È necessario definire il percorso di questi file nella fase successiva.

    4. Fai riferimento a MediaSDK.js su tutte le pagine del sito.

      Includi MediaSDK per JavaScript aggiungendo la seguente riga di codice nel tag <head> o <body> su ogni pagina. Ad esempio:

      <script type="text/javascript" src="https://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/MediaSDK.js"></script>
      
    5. Per verificare rapidamente che la libreria sia stata importata correttamente, controlla che ADB.Media sia esportato su un oggetto finestra.

      NOTA

      L’SDK per JavaScript è conforme alle specifiche del modulo AMD e CommonJS e MediaSDK.js può essere utilizzato anche con caricatori di moduli compatibili.

  2. Crea un’istanza di AppMeasurement e configura visitor.

    La configurazione di Media SDK richiede un’istanza di AppMeasurement con visitor configurato.

     var appMeasurement = new AppMeasurement(“<rsid>”);
     appMeasurement.visitor = visitor;
     appMeasurement.trackingServer = “<visitor_namespace>.sc.omtrdc.net”;
    
  3. Configurare Media SDK

    Media SDK deve essere configurato una volta per pagina web e la configurazione si applica a tutte le istanze di tracciamento create.

    IMPORTANTE

    Media SDK (3.x) utilizza l’API Media Collection per il tracciamento dei contenuti multimediali che è diversa dall’endpoint HB utilizzato negli SDK 2.x. Per ulteriori informazioni, contatta il tuo rappresentante di Adobe.

    Esempio di inizializzazione 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. Crea l’istanza MediaTracker.

    Dopo aver configurato Media SDK, è possibile creare istanze di tracciamento per il contenuto multimediale tramite l’API getInstance.

    var tracker = ADB.Media.getInstance();
    
    IMPORTANTE

    Assicurati che l’istanza tracker sia accessibile e non venga deassegnata fino alla fine della sessione multimediale. Questa istanza verrà utilizzata per monitorare tutti gli eventi seguenti per quella sessione.

Migrare da JavaScript 2.x a 3.x

Per informazioni dettagliate sulla migrazione da 2.x a 3.x, consulta Migrazione da 2.x a 3.x.

In questa pagina