Show Menu
TOPICS×

Panoramica configurazione

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.
    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 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.
    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.
    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.
    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
AppleTV
Chromecast
iOS
JavaScript
Primetime
TVML

Documentazione Primetime Media SDK