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.
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+ |
Il tracciamento dei contenuti multimediali è composto da tre componenti SDK principali:
Completa i seguenti passaggi di implementazione:
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. | Sì | 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 |
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 in secondi dall'inizio del programma. | Sì |
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. | Sì |
startupTime |
Tempo di avvio del supporto, in millisecondi. | Sì |
fps |
I fotogrammi visualizzati al secondo. | Sì |
droppedFrames |
Numero di fotogrammi saltati finora. | Sì |
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.
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);
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:
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 |