Panoramica configurazione

IMPORTANTE

Con la fine del supporto per gli SDK della versione 4 per dispositivi mobili il 31 agosto 2021, Adobe interromperà anche il supporto per gli SDK di Media Analytics per iOS e Android. Per ulteriori informazioni, consultate Domande frequenti relative alla fine del supporto per l’SDK di Media Analytics.

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

Supporto versione minima della piattaforma

La tabella seguente riassume le versioni minime delle piattaforme supportate per ogni SDK, iniziando il 19 febbraio 2019.

Sistema operativo/browser Versione minima richiesta
iOS iOS 6+
Android Android 5.0+ - Lollipop
Chrome v22+
Mozilla v27+
Safari v7+
IE v11+

Linee guida generali per l’implementazione

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

  • Configurazione Media Heartbeat - La configurazione contiene le impostazioni di base per il reporting.
  • Delegato Heartbeat Media - 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. Create un' MediaHeartbeatConfig istanza e impostate i valori dei parametri di configurazione.

    Nome della variabile Descrizione Obbligatorio Valore predefinito
    trackingServer Server di tracciamento per l'analisi dei supporti. Questa funzione è diversa dal server di tracciamento analisi. Stringa vuota
    channel Nome del canale No Stringa vuota
    ovp Nome della piattaforma multimediale online tramite la quale viene distribuito il contenuto No Stringa vuota
    appVersion Versione dell’app lettore multimediale/SDK No Stringa vuota
    playerName Nome del lettore multimediale in uso, ad esempio "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.
    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 in secondi dall'inizio del programma.
    SUGGERIMENTO

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

    Nome della variabile Descrizione Obbligatorio
    bitrate Bitrate del supporto in bit al secondo.
    startupTime Tempo di avvio del supporto, in millisecondi.
    fps I fotogrammi visualizzati al secondo.
    droppedFrames Numero di fotogrammi saltati finora.
  3. Create l’ MediaHeartbeat istanza.

    Utilizzate l'icona MediaHertbeatConfig e MediaHertbeatDelegate per creare l' MediaHeartbeat istanza.

    IMPORTANTE

    Accertatevi che l’ MediaHeartbeat istanza sia accessibile e non venga deallocata fino alla fine della sessione. Questa istanza verrà utilizzata per tutti i seguenti eventi di tracciamento dei supporti.

    SUGGERIMENTO

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

  4. Combinate tutti i pezzi.

    Il seguente codice di esempio utilizza l’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 per contenuti multimediali e ad Start vengono inviate direttamente al server Adobe Analytics (AppMeasurement).

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

  • Server Adobe Analytics (AppMeasurement) Per ulteriori informazioni sulle opzioni del server di tracciamento, vedi Compilazione corretta delle variabili trackingServer e trackingServerSecure.

    IMPORTANTE

    Per il servizio ID visitatore Experience Cloud è necessario un server di tracciamento RDC o una risoluzione CNAME per un server RDC.

    Il server di tracciamento analisi deve terminare in ".sc.omtrdc.net" o essere un CNAME.

  • Server Media Analytics (Heartbeats)​Questo ha sempre il formato "[your_namespace].hb.omtrdc.net". Il valore "[your_namespace]" specifica la società e viene fornito da Adobe.

Il tracciamento dei file 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 SDK 1.x

SDK 1.x di Video Analytics Guide per sviluppatori (solo PDF)
Android Configura per Android
AppleTV Configurare per AppleTV
Chromecast Configura per Chromecast
iOS Configurare per iOS
JavaScript Configurare per JavaScript
Primetime
TVML Configurare per TVML

Documentazione Primetime Media SDK

In questa pagina