Panoramica dell’estensione Adobe Media Analytics for Audio and Video

Crea istanza MediaHeartbeat: window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat.getInstance

Parametri: un oggetto delegato valido che espone queste funzioni.

Valore restituito: una promessa che risolve con un'istanza MediaHeartbeat o rifiuta con un messaggio di errore.

Accesso a costanti MediaHeartbeat: window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat

Questo espone tutte le costanti e i metodi statici dalla MediaHeartbeat classe.

Ottieni il sample player qui: MA Sample Player. Il sample player funge da riferimento per mostrare come utilizzare l’estensione MA per supportare Media Analytics direttamente da una Web app.

Crea l'istanza di tracciamento MediaHeartbeat come segue:

var MediaHeartbeat = window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat;

var delegate = {
    getCurrentPlaybackTime: this._getCurrentPlaybackTime.bind(this),
    getQoSObject: this._getQoSObject.bind(this),
};

var config = {
    playerName: "Custom Player",
    ovp: "Custom OVP",
    channel: "Custom Channel"
};

var self = this;
MediaHeartbeat.getInstance(delegate, config).then(function(instance) {
    self._mediaHeartbeat = instance;
    // Do Tracking using the MediaHeartbeat instance.
}).catch(function(err){
    // Getting MediaHeartbeat instance failed.
});

Crea istanza MediaHeartbeat: get-instance modulo condiviso

Parametri:

• Un oggetto delegato valido che espone queste funzioni:

  table 0-row-2 1-row-2 2-row-2 1-align-left 2-align-left 4-align-left 5-align-left 7-align-left 8-align-left
  Metodo	Descrizione
  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 LIVE/LIVE, il valore viene specificato in secondi dall'inizio del programma.

• Un oggetto di configurazione facoltativo che espone queste proprietà:

  table 0-row-3 1-row-3 2-row-3 3-row-3 1-align-left 2-align-left 3-align-left 5-align-left 6-align-left 7-align-left 9-align-left 10-align-left 11-align-left 13-align-left 14-align-left 15-align-left
  Proprietà	Descrizione	Obbligatorio
  Online Video Provider	Nome della piattaforma video online tramite la quale il contenuto è distribuito.	No. Se presente, sostituisce il valore definito durante la configurazione dell'estensione.
  Player Name	Nome del lettore multimediale in uso (ad esempio "AVPlayer", "HTML5 Player", "My Custom VideoPlayer")	No. Se presente, sostituisce il valore definito durante la configurazione dell'estensione.
  Channel	Proprietà nome canale	No. Se presente, sostituisce il valore definito durante la configurazione dell'estensione.

Valore restituito: una promessa che risolve con un'istanza MediaHeartbeat o rifiuta con un messaggio di errore.

Accesso a costanti MediaHeartbeat: media-heartbeat modulo condiviso

Questo modulo espone tutte le costanti e i metodi statici di questa classe: https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript/MediaHeartbeat.html.

Crea l'istanza di tracciamento MediaHeartbeat come segue:

var getMediaHeartbeatInstance =
  turbine.getSharedModule('adobe-video-analytics', 'get-instance');

var MediaHeartbeat =
  turbine.getSharedModule('adobe-video-analytics', 'media-heartbeat');
  ...

var delegate = {
    getCurrentPlaybackTime: this._getCurrentPlaybackTime.bind(this),
    getQoSObject: this._getQoSObject.bind(this),
}

var config = {
    playerName: "Custom Player",
    ovp: "Custom OVP",
    channel: "Custom Channel"
}
...

var self = this;
getMediaHeartbeatInstance(delegate, config).then(function(instance) {
    self._mediaHeartbeat = instance;
    ...
    // Do Tracking using the MediaHeartbeat instance.
}).catch(function(err){
    // Getting MediaHeartbeat instance failed.
});

...

Utilizzando l’istanza Media Heartbeat, segui la documentazione JS Media SDK e la documentazione API JS per implementare il tracciamento multimediale.