DocumentazioneAnalyticsGuida ai servizi Streaming Media

Installare Media SDK tramite JavaScript install-web-sdks

Ultimo aggiornamento: 19 maggio 2026

Creato per:

  • User
  • Admin
  • Developer

Le informazioni in questa pagina descrivono come installare Web SDK autonomo e configurare JavaScript.

In alternativa, è possibile utilizzare l’estensione Adobe Media Analytics per implementare i servizi di streaming multimediale, come descritto in Installare i servizi di streaming multimediale tramite l’estensione Media Analytics.

Prerequisiti prerequesites

  • Ottenere parametri di configurazione validi

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

  • Implementare 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.

  • Includi le seguenti API 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.

Configurazione JavaScript 3.x set-up-javascript

  1. Aggiungi la libreria scaricata al progetto. Crea riferimenti locali alle classi per comodità.

    1. Espandi il file MediaSDK-js-v3*.zip 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:

      code language-html 
      <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.

      note
      NOTE
      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.

    code language-js 
     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.

    note important
    IMPORTANT
    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:

    code language-js 
     // 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.

    code language-js 
    var tracker = ADB.Media.getInstance();
    note important
    IMPORTANT
    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.

Per i contenuti legacy, consulta Implementazioni legacy

recommendation-more-help
media-analytics-help