Panoramica dell’installazione

Le seguenti istruzioni sono valide per gli SDK di Media 2.x. Se stai implementando una versione 1.x dell’SDK Media, consulta la 1.x Media SDK Documentation. Per gli integratori Primetime, consulta la documentazione Media SDK di Primetime di seguito.

Supporto versione minima della piattaforma

La tabella seguente descrive le versioni minime della piattaforma supportate per ogni SDK, a partire dal 19 febbraio 2019.

Linee guida generali sull’attuazione

Il tracciamento dei contenuti multimediali è costituito da tre componenti SDK principali:

• Configurazione Media Heartbeat - La configurazione contiene le impostazioni di base per il reporting.
• Delegato Media Heartbeat - Il delegato controlla il tempo di riproduzione e l'oggetto QoS.
• Media Heartbeat - La libreria principale contenente membri e metodi.

Completa i seguenti passaggi di implementazione:

1. Crea un'istanza MediaHeartbeatConfig e imposta i valori dei parametri di configurazione.

   Nome variable	Descrizione	Obbligatorio	Valore predefinito
   trackingServer	Server di tracciamento per l'analisi dei contenuti multimediali. Questa funzione è diversa dal server di tracciamento di Analytics.	Sì	Stringa vuota
   channel	Nome del canale	No	Stringa vuota
   ovp	Nome della piattaforma multimediale online attraverso la quale il contenuto viene distribuito	No	Stringa vuota
   appVersion	Versione dell’app/SDK del lettore multimediale	No	Stringa vuota
   playerName	Nome del lettore multimediale in uso, cioè "AVPlayer", "HTML5 Player", "My Custom Player"	No	Stringa vuota
   ssl	Indica se le chiamate devono essere effettuate tramite HTTPS	No	false
   debugLogging	Indica se la registrazione di debug è abilitata	No	false

2. Implementare MediaHeartbeatDelegate.

   Nome metodo	Descrizione	Obbligatorio
   getQoSObject()	Restituisce l'istanza MediaObject che contiene le informazioni QoS correnti. Questo metodo verrà chiamato più volte durante una sessione di riproduzione. L'implementazione del lettore deve restituire sempre i dati QoS disponibili più di recente.	Sì
   getCurrentPlaybackTime()	Restituisce la posizione corrente dell'indicatore di riproduzione. Per il tracciamento VOD, il valore è specificato in secondi dall'inizio dell'elemento multimediale. Per il tracciamento LINEAR/LIVE, il valore è specificato come il numero di secondi trascorsi dalla mezzanotte UTC di quel giorno.	Sì

   SUGGERIMENTO

   L'oggetto Quality of Service (QoS) è facoltativo. Se i dati QoS sono disponibili per il lettore e desideri tenere traccia di tali dati, sono necessarie le seguenti variabili:

   Nome della variabile	Descrizione	Obbligatorio
   bitrate	Il bitrate del supporto in bit al secondo.	Sì
   startupTime	Tempo di avvio del contenuto multimediale in millisecondi.	Sì
   fps	I fotogrammi visualizzati al secondo.	Sì
   droppedFrames	Numero di fotogrammi saltati finora.	Sì

3. Crea l'istanza MediaHeartbeat .

   Utilizza i valori MediaHertbeatConfig e MediaHertbeatDelegate per creare l'istanza MediaHeartbeat.

   IMPORTANTE

   Assicurati che l'istanza MediaHeartbeat sia accessibile e non venga deallocata fino alla fine della sessione. Questa istanza verrà utilizzata per tutti i seguenti eventi di tracciamento multimediale.

   SUGGERIMENTO

   MediaHeartbeat richiede un'istanza di AppMeasurement per inviare chiamate ad Adobe Analytics.

4. Combinate tutti i pezzi.

   Il seguente codice di esempio utilizza il nostro SDK JavaScript 2.x per un lettore video HTML5:

   // Create local references to the heartbeat classes
   var MediaHeartbeat = ADB.va.MediaHeartbeat;
   var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig;
   var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate;
   
   //Media Heartbeat Config
   var mediaConfig = new MediaHeartbeatConfig();
   mediaConfig.trackingServer = "[your_namespace].hb.omtrdc.net";
   mediaConfig.playerName = "HTML5 Basic";
   mediaConfig.channel = "Video Channel";
   mediaConfig.debugLogging = true;
   mediaConfig.appVersion = "2.0";
   mediaConfig.ssl = false;
   mediaConfig.ovp = "";
   
   // Media Heartbeat Delegate
   var mediaDelegate = new MediaHeartbeatDelegate();
   
   // Set mediaDelegate CurrentPlaybackTime
   mediaDelegate.getCurrentPlaybackTime = function() {
       return video.currentTime;
   };
   
   // Set mediaDelegate QoSObject - OPTIONAL
   mediaDelegate.getQoSObject = function() {
       return MediaHeartbeat.createQoSObject(video.bitrate,  
                                             video.startuptime,  
                                             video.fps,  
                                             video.droppedframes);
   }
   // Create mediaHeartbeat instance      
   this.mediaHeartbeat =  
     new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurementInstance);  
   

Convalida

Le implementazioni di tracciamento di Media Analytics generano due tipi di chiamate di tracciamento:

• Le chiamate Media e Ad Start vengono inviate direttamente al server Adobe Analytics (AppMeasurement).

• Le chiamate Heartbeat vengono inviate al server di tracciamento di Media Analytics (heartbeat), vengono elaborate e trasmesse al server Adobe Analytics.

• Adobe Analytics (AppMeasurement)
  serverPer ulteriori informazioni sulle opzioni del server di tracciamento, consulta Compilare correttamente le variabili trackingServer e trackingServerSecure .

  IMPORTANTE

  Per il servizio ID visitatore di Experience Cloud è necessario un server di monitoraggio RDC o la risoluzione CNAME in un server RDC .

  Il server di tracciamento di Analytics deve terminare con ".sc.omtrdc.net" o essere un CNAME.

• Server Media Analytics (Heartbeat)
  Ha sempre il formato "[your_namespace].hb.omtrdc.net". Il valore di "[your_namespace]" specifica la società e viene fornito dall'Adobe.

Il tracciamento dei contenuti multimediali funziona allo stesso modo su tutte le piattaforme, desktop e dispositivi mobili. Il tracciamento audio funziona attualmente sulle piattaforme mobili. Per tutte le chiamate di tracciamento sono disponibili alcune variabili universali chiave da convalidare:

Documentazione di SDK 1.x

Documentazione di Primetime Media SDK

• Guide utente di Primetime