Panoramica su Milestone

ATTENZIONE

Questa opzione di misurazione è stata dichiarata obsoleta.

Documentazione precedente su Milestone

Configurazione

Configurazione video Milestone

Per tracciare il video, specifica un set di Variabili di conversione personalizzate (eVar) e Eventi personalizzati da utilizzare nel tracciamento e nel reporting. Per il percorso viene utilizzata anche una variabile Custom Insight ( s.prop ).

Le variabili selezionate per ogni metrica vengono aggiunte alla pagina di configurazione video. Questo consente al sistema di generare e formattare automaticamente i report video standard. Sono entrambi necessari l'eVar nome video e il contatore visualizzazioni video. Altre variabili sono facoltative ma consigliate per la misurazione completa. Una volta abilitato il tracciamento video, puoi visualizzare i rapporti generati dai dati video segnalati mediante il tracciamento video.

Puoi anche tenere traccia di qualsiasi numero di metriche aggiuntive per i video. Ad esempio, se utilizzi più lettori video sul tuo sito, puoi compilare un eVar con il nome del lettore. Alcune delle variabili selezionate possono essere utilizzate anche in altre aree del sito. Ad esempio, se utilizzata in tutto il sito, la variabile tipo di contenuto può consentire di misurare la percentuale di visualizzazioni di pagina che provengono dal video e consente di correlare gli eventi di conversione al video.

Configurazione della generazione di rapporti Milestone

Per configurare la generazione di rapporti video per un’implementazione Milestone, passa a Admin > Report Suite Manager. Seleziona la suite di rapporti, quindi scegli Video Management > Video Reporting:

Nella prima schermata, solo Video Core funzionerà con i dati Milestone. Selezionare Video Core e fare clic su Save.

Nella schermata successiva, seleziona Use Custom Variables.

Nella schermata finale, seleziona le due eVar e i tre eventi da utilizzare per la misurazione video:

Riferimento a una variabile video

La tabella seguente contiene ulteriori dettagli sulle variabili commerce e sugli eventi personalizzati per il video:

Metrica video Tipo di variabile Descrizione
Contenuto eVar
Scadenza predefinita: Visita
(Obbligatorio) Raccoglie il nome del video, come specificato nell’implementazione.
Tipo di contenuto eVar
Scadenza predefinita: Vista a pagina
Raccoglie dati relativi al tipo di contenuto visualizzato da un visitatore. Agli hit inviati dalla misurazione video è assegnato il tipo di contenuto video.
Questa variabile non deve essere riservata esclusivamente al tracciamento video. Se anche altri contenuti segnalano tipi di contenuto utilizzando la stessa variabile, puoi analizzare la distribuzione dei visitatori per diversi tipi di contenuto. Ad esempio, puoi utilizzare questa variabile per assegnare valori quali article o product page ad altri tipi di contenuto.
Dal punto di vista della misurazione video, i tipi di contenuto consentono di identificare i visitatori del video e quindi di calcolare i tassi di conversione relativi al video.
Tempo contenuto trascorso Evento
Tipo: Contatore
Conta il tempo, in secondi, trascorso a guardare un video dall'ultimo processo di raccolta di dati (richiesta immagine).
Avvio video Evento
Tipo: Contatore
Indica che un visitatore ha visualizzato una parte del video. Tuttavia, non fornisce informazioni sulla durata della visualizzazione o sulla parte di video visualizzata dal visitatore.
Completamento video Evento
Tipo: Contatore
Indica che un utente ha visualizzato un video completo. Per impostazione predefinita, l'evento completo è misurato 1 secondo prima della fine del video.
Durante l’implementazione, puoi specificare a quanti secondi dalla fine del video la visualizzazione potrà essere considerata come una visualizzazione completa. Per i video in diretta e altri flussi che non hanno una fine definita, puoi specificare un punto personalizzato per misurare il completamento. Ad esempio, dopo un tempo di visualizzazione specifico.

Variabili del modulo multimediale

Le seguenti variabili consentono di configurare la misurazione video. È necessario definire i valori delle variabili nella tabella Variabili richieste. Inoltre, per tenere traccia degli eventi nel lettore video, devi abilitare autoTrack (per i lettori supportati) o implementare il tracciamento degli eventi del lettore personalizzato utilizzando i metodi open, play, stop e close.

Variabile Descrizione
Media.trackUsingContextData Sintassi:

s.Media.trackUsingContextData = true;
Questa opzione consente il tracciamento video integrato. Quando è impostato su true, il modulo multimediale genera dati contestuali per il tracciamento dei contenuti multimediali, invece del pev3 legacy.
Utilizza Media.contextDataMapping per mappare i dati contestuali agli eventi eVar selezionati.
Valore predefinito: false
Media.contextDataMapping Sintassi:

s.Media.contextDataMapping = {
     "a.media.name":"eVar2, prop2",
     "a.media.segment":"eVar3",
     "a.contentType":"eVar1",
     "a.media.timePlayed":"event3",
     "a.media.view":"event1",
     "a.media.segmentView":"event2",
     "a.media.complete":"event7",
     "a.media.milestones":{
         25:"event4",
         50:"event5",
         75:"event6"
     }
};

Un oggetto che definisce la mappatura delle variabili a eVar ed Eventi da utilizzare per la misurazione video. L’oggetto deve mappare i campi seguenti:

a.media.name: (Obbligatorio) Compila le variabili con il nome del video. Fornisci l’eVar selezionato per memorizzare il nome del video e la variabile Custom Insight Video ( s.prop ) che desideri utilizzare per il percorso del video. Immetti i valori in un elenco separato da virgole.

a.media.segment: (facoltativo) l’eVar in cui memorizzare il nome del segmento multimediale. a.contentType: (Facoltativo) L’eVar che desideri memorizzare il valore video, che contiene il tracciamento delle visite e dei visitatori abilitato per generare rapporti sulle visite video e sui visitatori. La variabile selezionata è probabilmente già utilizzata per memorizzare dati come la presentazione dell’articolo o la pagina del prodotto

a.media.view: (Obbligatorio) L’evento che si desidera conteggiare le visualizzazioni multimediali.

a.media.segmentView: (facoltativo) l’evento che si desidera contare le visualizzazioni dei segmenti.

a.media.complete: (facoltativo) l’evento che si desidera contare le visualizzazioni complete.

a.media.timePlayed: (Facoltativo, vivamente consigliato) l’evento numerico che si desidera memorizzare il numero di secondi video riprodotti.

a.media.milestones: (facoltativo) un oggetto che mappa le tappe di s.Media.trackMilestones per contrastare gli eventi. Media.segmentByMilestones deve essere impostato su true se si definiscono le tappe.

Ad trackingPer tenere traccia degli annunci sono disponibili le seguenti variabili di dati di contesto:
a.media.ad.name: (Obbligatorio) Popola le variabili con il nome dell’annuncio. Specifica l’eVar selezionato per memorizzare il nome dell’annuncio e la variabile Video Custom Insight ( s.prop ) che desideri utilizzare per il percorso. Immetti i valori in un elenco separato da virgole.

a.media.ad.pod: la posizione nel contenuto principale in cui è stato riprodotto l’annuncio.

a.media.ad.podPosition: la posizione all’interno del pod in cui viene riprodotto l’annuncio.

a.media.ad.CPM: il CPM o il CPM crittografato (con il prefisso “~”) che si applica a questa riproduzione.

a.media.ad.view: funziona come a.media.view

a.media.ad.clious: conta il numero di clic per l’annuncio (Media.click chiamate)

a.media.ad.timePlayed: funziona come a.media.timePlayed

a.media.ad.complete: funziona come a.media.complete a.media.ad.segment: Funziona nello stesso modo a.media.segment

a.media.ad.segmentView: funziona come a.media.segmentView

a.media.ad.milestones: funziona come a.media.milestones

a.media.ad.offsetMilestones: funziona come a.media.offsetMilestones
Media.trackVars Sintassi:

s.Media.trackVars =
   "events, prop2, eVar1, eVar2, eVar3";

Un elenco separato da virgole di tutte le variabili impostate nel codice di tracciamento video.
Media.trackEvents Sintassi:

s.Media.trackEvents =
   "event1, event2, event3, event4, event5, event6, event7"

Un elenco separato da virgole di tutti gli eventi impostati nel codice di tracciamento video.

Variabili facoltative

Variabile Descrizione
Media.autoTrack Sintassi:

s.Media.autoTrack = true

Abilita il tracciamento automatico per i lettori supportati. I lettori supportati sono i seguenti:
  • Open Source Media Framework (OSMF)
  • FLVPlayback (lettori video creati dalla procedura guidata di importazione video in Flash Professional)
  • Silverlight
  • MediaDisplay
  • MediaPlayback
  • API Brightcove versioni 2 e 3 ( vedi Brightcove)
  • Windows Media Player, Quicktime o Real Player con JavaScript


Se non utilizzi uno dei lettori di cui sopra, puoi utilizzare Media.open Media.play Media.stop Media.close per tenere traccia degli eventi del lettore.
Media.autoTrackNetStreams Sintassi:

s.Media.autoTrackNetStreams = true

Flash 10.3 ha introdotto nuove funzionalità per il componente NetStream che consentono un migliore tracciamento video. Se utilizzi un lettore NetStream di Flash personalizzato, puoi abilitare questa variabile per abilitare funzionalità simili a autoTrack. Questo metodo richiede che i video siano visualizzati nel Flash 10.3 o versione successiva.
Media.completeByCloseOffset Sintassi:



s.Media.completeByCloseOffset = true

Questa impostazione consente di contare una visualizzazione video completa pochi secondi prima della fine effettiva del video.

L’evento viene inviato in base al numero di secondi specificati in completeCloseOffsetThreshold. Questo consente di misurare le visualizzazioni complete nei lettori video che non segnalano mai un offset uguale alla lunghezza del video.

Per impostazione predefinita, questo valore è impostato su true e la soglia è impostata su 1 secondo. Con queste impostazioni predefinite, l’evento completo viene inviato 1 secondo prima della fine del video.
Media.completeCloseOffsetThreshold Sintassi:

s.Media.completeCloseOffsetThreshold = 1

Questa soglia consente di contare una visualizzazione video completa pochi secondi prima della fine effettiva del video. Media.completeByCloseOffset deve essere impostato su true per utilizzare questa soglia.

Il valore intero fornito determina la distanza in secondi dell'offset dalla lunghezza del video alla chiusura e il conteggio come completo. Questo consente di misurare le visualizzazioni complete nei lettori video che non segnalano mai un offset uguale alla lunghezza del video.

La soglia predefinita è di 1 secondo.
Media.playerName Sintassi:

s.Media.playerName = "Custom Player Name"

Specifica il nome di un lettore video personalizzato.
Media.trackSeconds Sintassi:

s.Media.trackSeconds = 15

Definisce l’intervallo, in secondi, per l’invio di dati di tracciamento video ai server di raccolta dati di Adobe durante la riproduzione del video. Il valore deve essere impostato in incrementi di 5 secondi.

L'abilitazione Media.trackSeconds attiva solo gli eventi definiti in Media.contextDataMapping. Per inviare variabili aggiuntive al di fuori di quelle specificate per la misurazione video, è necessario utilizzare Media.Monitor.
Media.trackMilestones Tiene traccia delle milestone come percentuale della lunghezza del video.

Sintassi:

s.Media.trackMilestones = "25, 50, 75";

Definisce l’intervallo, in percentuale della lunghezza del video, per l’invio di dati di tracciamento video ai server di raccolta dati di Adobe. Specificare le tappe come un elenco separato da virgole di numeri interi. Ad esempio: 10 = 10%, 23 = 23%.

Poiché queste tappe sono punti fissi nel video, se un visitatore visualizza oltre la tappa del 10%, quindi si riavvolge e passa nuovamente la tappa del 10%, il modulo multimediale invia i dati di tracciamento più volte. Analogamente, se un visitatore procede rapidamente oltre un’attività cardine, il modulo multimediale non invia i dati di tracciamento per tale attività cardine.

L’abilitazione Media.trackMilestones attiva solo gli eventi definiti in Media.contextDataMapping. Per inviare variabili aggiuntive al di fuori di quelle specificate per la misurazione video, è necessario utilizzare Media.Monitor.
Media.trackOffsetMilestones Tiene traccia delle milestone come secondi trascorsi dall’inizio del video.

Sintassi:

s.Media.trackOffsetMilestones = "20, 40, 60";

Definisce l’intervallo, in secondi trascorsi dall’inizio del video, per l’invio di dati di tracciamento video ai server di raccolta dati di Adobe. Specificare le tappe come un elenco separato da virgole di numeri interi. Ad esempio: 20 = 20 secondi, 40 = 40 secondi).

Poiché queste tappe sono punti fissi nel video, se un visitatore visualizza oltre la tappa di 20 secondi, quindi si riavvolge e passa nuovamente la tappa di 20 secondi, il modulo multimediale invia i dati di tracciamento più volte. Analogamente, se un visitatore procede rapidamente oltre un’attività cardine, il modulo multimediale non invia i dati di tracciamento per tale attività cardine.

L’abilitazione Media.trackOffsetMilestones attiva solo gli eventi definiti in Media.contextDataMapping. Per inviare variabili aggiuntive al di fuori di quelle specificate per la misurazione video, è necessario utilizzare Media.Monitor.
Media.segmentByMilestones Sintassi:

s.Media.segmentByMilestones = true;

Genera automaticamente il nome del segmento, il numero del segmento e i dati di lunghezza del segmento, in base alla lunghezza del supporto e alle tappe specificate in Media.trackMilestones

Segmentazione per tappe principali è l’unico modo per definire i segmenti quando si utilizza autoTrack.

Valore predefinito: false
Media.segmentByOffsetMilestones Sintassi:

s.Media.segmentByOffsetMilestones = true;

Genera automaticamente il nome del segmento, il numero del segmento e i dati di lunghezza del segmento, in base alla lunghezza del supporto e alle tappe specificate in Media.trackOffsetMilestones

Segmentazione per tappe principali è l’unico modo per definire i segmenti quando si utilizza autoTrack.

Valore predefinito: false

Variabili di tracciamento degli annunci

Queste variabili vengono utilizzate per inviare informazioni sugli annunci insieme al metodo openAd . Consulta Tracciamento annunci video VAST.

Variabile Descrizione
Media.adTrackSeconds Sintassi:

s.Media.adTrackSeconds = 15;

Definisce l’intervallo, in secondi, per l’invio di dati di tracciamento di annunci video ai server di raccolta dati di Adobe durante la riproduzione del video. Il valore deve essere impostato in incrementi di 5 secondi.

L'abilitazione Media.adTrackSeconds attiva solo gli eventi definiti in Media.contextDataMapping. Per inviare variabili aggiuntive al di fuori di quelle specificate per la misurazione video, è necessario utilizzare Media.monitor.
Media.adTrackMilestones Traccia e milestone come percentuale della lunghezza dell’annuncio.

Sintassi:

s.Media.adTrackMilestones = "25, 50, 75";

Definisce l’intervallo, in percentuale della lunghezza dell’annuncio, per l’invio di dati di tracciamento degli annunci ai server di raccolta dati di Adobe. Specificare le tappe come un elenco separato da virgole di numeri interi. Ad esempio: 10 = 10%, 23 = 23%).

Poiché queste tappe sono punti fissi nell’annuncio, se un visitatore visualizza oltre la tappa del 10%, quindi si riavvolge e passa nuovamente la tappa del 10%, il modulo multimediale invia i dati di tracciamento più volte. Analogamente, se un visitatore procede rapidamente oltre un’attività cardine, il modulo multimediale non invia i dati di tracciamento per tale attività cardine.

L’abilitazione Media.adTrackMilestones attiva solo gli eventi definiti in Media.contextDataMapping. Per inviare variabili aggiuntive al di fuori di quelle specificate per la misurazione video, è necessario utilizzare Media.monitor.
Media.adTrackOffsetMilestones Tiene traccia e milestone come secondi trascorsi dall’inizio dell’annuncio.

Sintassi:

s.Media.adTrackOffsetMilestones = "20, 40, 60";

Definisce l’intervallo, in secondi trascorsi dall’inizio dell’annuncio, per l’invio di dati di tracciamento degli annunci ai server di raccolta dati di Adobe. Specificare le tappe come un elenco separato da virgole di numeri interi. Ad esempio: 20 = 20 secondi, 40 = 40 secondi).

Poiché queste tappe sono punti fissi nell’annuncio, se un visitatore visualizza oltre la tappa di 20 secondi, quindi si riavvolge e passa nuovamente la tappa di 20 secondi, il modulo multimediale invia i dati di tracciamento più volte. Analogamente, se un visitatore procede rapidamente oltre un’attività cardine, il modulo multimediale non invia i dati di tracciamento per tale attività cardine.

L’abilitazione Media.adTrackOffsetMilestones attiva solo gli eventi definiti in Media.contextDataMapping. Per inviare variabili aggiuntive al di fuori di quelle specificate per la misurazione video, è necessario utilizzare Media.monitor.
Media.adSegmentByMilestones Sintassi:

s.Media.adSegmentByMilestones = true;

Genera automaticamente il nome del segmento, il numero del segmento e i dati di lunghezza del segmento, in base alla lunghezza del supporto e alle tappe specificate in Media.adTrackMilestones

Segmentazione per tappe principali è l’unico modo per definire i segmenti quando si utilizza autoTrack.

Valore predefinito: false
Media.adSegmentByOffsetMilestones Sintassi:

s.Media.adSegmentByOffsetMilestones = true;

Genera automaticamente il nome del segmento, il numero del segmento e i dati di lunghezza del segmento, in base alla lunghezza del supporto e alle tappe specificate in Media.adTrackOffsetMilestones

Segmentazione per tappe principali è l’unico modo per definire i segmenti quando si utilizza autoTrack.

Valore predefinito: false

Metodi del modulo multimediale

I metodi del modulo multimediale vengono utilizzati per monitorare manualmente gli eventi del lettore e per tenere traccia di metriche aggiuntive che non fanno parte dei rapporti video standard.

Se utilizzi Media.autoTrack e non esegui il tracciamento di metriche aggiuntive, non è necessario chiamare direttamente nessuno di questi metodi. Tutti gli argomenti sono obbligatori, a meno che non sia specificato come facoltativo.

Metodo Descrizione
Media.open Sintassi:

s.Media.open(mediaName, mediaLength, mediaPlayerName)

Prepara il modulo multimediale per raccogliere i dati di tracciamento video. Questo metodo accetta i seguenti parametri:
  • mediaName: (obbligatorio) il nome del video che desideri venga visualizzato nei rapporti video.
  • mediaLength: (Obbligatorio) La lunghezza del video in secondi.
  • mediaPlayerName: (obbligatorio) il nome del lettore multimediale utilizzato per visualizzare il video, come desideri che appaia nei rapporti video.
Media.openAd Sintassi:

s.Media.openAd(name, length, playerName, parentName,
   parentPod, parentPodPosition, CPM)

Prepara il modulo multimediale per raccogliere i dati di tracciamento degli annunci. Questo metodo accetta i seguenti parametri:
  • name: (obbligatorio) il nome o l’ID dell’annuncio.
  • length: (Obbligatorio) La lunghezza dell’annuncio.
  • playerName: (obbligatorio) il nome del lettore multimediale utilizzato per visualizzare l'annuncio.
  • parentName: il nome o l'ID del contenuto principale in cui è incorporato l'annuncio.
  • parentPod: la posizione nel contenuto principale in cui è stato riprodotto l'annuncio.
  • parentPodPosition: la posizione all’interno del pod in cui viene riprodotto l’annuncio.
  • CPM: il CPM o il CPM crittografato (con il prefisso "~") che si applica a questa riproduzione.
Media.click Sintassi:

s.Media.click(name, offset)

Monitora quando si fa clic su un annuncio in un video. Questo metodo accetta i seguenti parametri:
  • name: il nome dell’annuncio. Deve corrispondere al nome utilizzato in Media.openAd.
  • offset: l'offset nell'annuncio quando si è verificato il clic.
Media.close Sintassi:

s.Media.close(mediaName)

Termina la raccolta dati video e invia informazioni ai server di raccolta dati di Adobe. Chiama questo metodo alla fine del video. Questo metodo accetta il seguente parametro:

mediaName: il nome del video. Deve corrispondere al nome utilizzato in Media.open.
Media.complete Sintassi:

s.Media.complete(name, offset)

Questo metodo traccia manualmente un evento completo. Questo metodo viene utilizzato quando è necessario attivare eventi utilizzando una logica speciale che non può essere gestita utilizzando Media.completeByCloseOffset.

Ad esempio, se stai misurando un flusso live che non ha una fine definita, puoi attivare un completamento dopo che un utente visualizza un flusso live per X secondi. È possibile misurare un completamento utilizzando un calcolo percentuale in base alla lunghezza e al tipo di contenuto. Questo metodo accetta i seguenti parametri:
  • mediaName: il nome del video. Deve corrispondere al nome utilizzato in Media.open.
  • mediaOffset: il numero di secondi trascorsi nel video durante l'invio dell'evento completo. Specificate l'offset in base al video a partire dal secondo zero.

    Se il lettore multimediale tiene traccia dei millisecondi, assicurarsi che il valore sia convertito in secondi prima di chiamare Media.complete.
Se prevedi di chiamare completato manualmente, imposta

s.Media.completeByCloseOffset = false.
Media.play Sintassi:

s.Media.play(name, offset, segmentNum, segment, segmentLength)

Chiama questo metodo ogni volta che inizia la riproduzione di un video. Quando utilizzi la misurazione video manuale, puoi fornire i dati del segmento corrente durante l’invio dei dati di misurazione video.

Se il lettore passa da un segmento all’altro, per qualsiasi motivo, è necessario chiamare Media.stop Media.play.

Questo metodo accetta i seguenti parametri:

mediaName: il nome del video. Deve corrispondere al nome utilizzato in Media.open.

mediaOffset: il numero di secondi dall’inizio della riproduzione del video. Specificate l’offset in base al video a partire dal secondo zero. Se il lettore multimediale tiene traccia dei millisecondi, assicurarsi che il valore sia convertito in secondi prima di chiamare Media.play.

segmentNum: (facoltativo) il numero di segmento corrente, utilizzato dai rapporti di marketing per ordinare la visualizzazione dei segmenti nei rapporti. Il parametro segmentNum deve essere maggiore di zero.

segmento: (facoltativo) il nome del segmento corrente.

segmentLength: (facoltativo)

la lunghezza del segmento corrente, in secondi.

Ad esempio:

s.Media.play("My Video", 1800, 2,"Second Quarter", 1800)

s.Media.play("My Video", 0, 1,"Preroll", 30)
Media.stop Sintassi:

s.Media.stop(mediaName, mediaOffset)

Tiene traccia di un evento di arresto (arresto, pausa, ecc.) per il video specificato. Questo metodo accetta i seguenti parametri:
  • mediaName: il nome del video. Deve corrispondere al nome utilizzato in Media.open.
  • mediaOffset: il numero di secondi in cui si verifica l'evento stop o pause nel video. Specificate l'offset in base al video a partire dal secondo zero.
Media.monitor Sintassi:

s.Media.monitor(s, media)

Sintassi Silverlight:

s.Media.monitor =
   new AppMeasurement_Media_Monitor(myMediaMonitor);

Il monitoraggio dei contenuti multimediali dell’app Silverlight implementa il pattern di progettazione del delegato Objective-C. Il metodo della classe myMediaMonitor accetta i parametri s e media.

Utilizza questo metodo per inviare metriche video aggiuntive. Puoi impostare variabili aggiuntive (Prop, eVar, Eventi) e inviarle utilizzando Media.track in base allo stato corrente del video durante la riproduzione.

Consulta Misurazione di metriche aggiuntive tramite Media.monitor .

Questo metodo accetta i seguenti parametri:

s: l’ AppMeasurement istanza (o s l’oggetto JavaScript).

media: un oggetto con i membri che forniscono lo stato del video. Tali membri includono:
  • media.name: Nome del video. Deve corrispondere al nome utilizzato in Media.open;
  • media.length: la lunghezza del video in secondi forniti nella chiamata a Media.open;
  • media.playerName: il nome del lettore multimediale indicato nell'invito a Media.open;
  • media.openTime: Un oggetto NSDate contenente dati su quando Media.open è stato chiamato;
  • media.offset: L'offset corrente, in secondi, (punto effettivo nel video) nel video. L'offset inizia a zero (il primo secondo del video è il secondo 0);
  • media.percent: La percentuale corrente del video riprodotto, in base alla lunghezza del video e all'offset corrente.;
  • media.timePlayed: il numero totale di secondi finora riprodotti;
  • media.eventFirstTime: Indica se è stata la prima volta che l'evento multimediale è stato chiamato per questo video;
  • media.mediaEvent: Una stringa contenente il nome dell'evento che ha causato la chiamata di monitoraggio.
media.mediaEvent events:
  • OPEN: Quando la riproduzione viene osservata per la prima volta attraverso Media.autoTrack o una chiamata a Media.play;
  • CLOSE: Quando la riproduzione termina al completamento del video attraverso Media.autoTrack o a una chiamata a Media.close;
  • PLAY: Quando la riproduzione riprende dopo essere stata messa in pausa o sfregata attraverso Media.autoTrack o una seconda chiamata a Media.play;
  • STOP: Quando la riproduzione si arresta a causa di una pausa dell'inizio del lavaggio attraverso Media.autoTrack o di una chiamata a Media.stop;
  • MONITOR: Quando il monitoraggio automatico controlla lo stato del video durante la riproduzione (ogni secondo);
  • SECONDS: al secondo intervallo definito dalla Media.trackSeconds variabile;
  • MILESTONE: alle tappe definite dalla Media.trackMilestones variabile;
Media.track Sintassi:

s.Media.track(mediaName)

Invia immediatamente lo stato video corrente, insieme a qualsiasi Media.trackVars e Media.trackEvents definito. Questo metodo viene utilizzato all'interno di Media.monitor.

Consulta Misurazione di metriche aggiuntive tramite Media.monitor .

Chiama Media.open e Media.play accedi al video prima di chiamare questo metodo. Questo metodo accetta il seguente parametro:
  • mediaName: Nome del video. Deve corrispondere al nome utilizzato in Media.open.
Questo metodo è l’unico modo per inviare variabili aggiuntive durante la riproduzione del video. Ripristina a zero i contatori dell’intervallo di secondi e della percentuale di attività cardine per evitare più hit di tracciamento.

Tracciare gli eventi del lettore video

È possibile tenere traccia dei lettori multimediali creando funzioni collegate ai gestori di eventi del lettore video. Questo consente di chiamare Media.open, Media.play, Media.stop e Media.close nei momenti opportuni. Ad esempio:

  • Carica: chiama Media.open e Media.play
  • Pausa: chiama Media.stop. Ad esempio, se un utente mette in pausa un video dopo 15 secondi, chiama s.Media.stop("Video1", 15)
  • Buffer: chiama Media.stop durante il buffer video. Chiama Media.play quando la riproduzione riprende.
  • Riprendi: chiama Media.play. Ad esempio, quando un utente riprende un video dopo aver inizialmente riprodotto 15 secondi del video, invoca s.Media.play("Video1", 15).
  • Scorrimento (cursore): quando l’utente trascina il cursore del video, invoca Media.stop. Quando l’utente rilascia il cursore video, chiama Media.play.
  • Fine: Chiama Media.stop, quindi Media.close. Ad esempio, alla fine di un video di 100 secondi, invoca s.Media.stop("Video1", 100), quindi s.Media.close("Video1").

A questo scopo, puoi definire quattro funzioni personalizzate che puoi chiamare dai gestori eventi del lettore multimediale. I vari parametri passati in Media.open, Media.play, Media.stop e Media.close provengono dal lettore. Lo pseudocodice seguente illustra come eseguire questa operazione:

/* Call on video load */ 
function startMovie() { 
    s.Media.open(mediaName, mediaLength, mediaPlayerName); 
    playMovie(); 
} 
 
/* Call on video resume from pause and slider release */ 
function playMovie() { 
    s.Media.play(mediaName, 
                 mediaOffset,  
                 segmentNum,  
                 segment,  
                 segmentLength); 
} 
/* Call on video pause and slider grab */ 
function stopMovie() { 
    s.Media.stop(mediaName, mediaOffset); 
} 
 
/* Call on video end */ 
/* Measuring Video for Developers 43 */ 
function endMovie() { 
    stopMovie(); 
    s.Media.close(mediaName); 
} 

Autotrack JavaScript

Il modulo multimediale JavaScript identifica tutti i tag <embed> o <object> nella pagina HTML. Quindi cerca i dati di ogni tag per determinare quale lettore multimediale viene utilizzato, se presente. Se il lettore è Windows Media Player, Quicktime o Real Player, è possibile utilizzare autoTrack, anche se autoTrack per Windows Media Player funziona solo con Internet Explorer. Per supportare tutti gli altri browser è necessario il tracciamento manuale per Windows Media Player.

L'attributo classid deve essere impostato sull'oggetto di cui si desidera tenere traccia. Il classid è necessario per esporre i gestori di eventi utilizzati dal modulo multimediale per tracciare automaticamente il video.

s.Media.autoTrack = true

Codice di esempio JavaScript

// Sample implementation 
s.usePlugins=true 
function s_doPlugins(s) { 
    /* Add manual calls to modules and plugins here */ 
} 
 
s.doPlugins=s_doPlugins 
 
/*********Media Module Calls**************/ 
s.loadModule("Media") 
 
/*Configure Media Module Functions */ 
s.Media.autoTrack= true; 
s.Media.trackVars="events, prop2, eVar1, eVar2, eVar3"; 
s.Media.trackEvents="event1, event2, event3, event4, event5, event6, event7" 
s.Media.trackMilestones="25, 50, 75"; 
s.Media.playerName="My Media Player"; 
s.Media.segmentByMilestones = true; 
s.Media.trackUsingContextData = true; 
s.Media.contextDataMapping = { 
    "a.media.name":"eVar2, prop2", 
    "a.media.segment":"eVar3", 
    "a.contentType":"eVar1", 
    "a.media.timePlayed":"event3", 
    "a.media.view":"event1", 
    "a.media.segmentView":"event2", 
    "a.media.complete":"event7", 
    "a.media.milestones":{ 
        25:"event4", 
        50:"event5", 
        75:"event6" 
    } 
} 
 
s.Media.monitor = function (s, media) { } //If Needed

/* Turn on and configure debugging here */ 
s.debugTracking = true; 
s.trackLocal = true; 
 
/* WARNING: Changing any of the below variables will cause drastic changes to how your visitor 
data is collected. Changes should only be made when instructed to do so by your account 
manager.*/ 
s.visitorNamespace = "yourNamespace"; 
s.trackingServer="metrics.mysite.com" //Use only if using first party cookies 
s.trackingServerSecure="smetrics.mysite.com" // Use only if using first party cookies in  
                                             // conjunction with SSL 
s.dc = '122'; 
 
/************************** PLUGINS SECTION *************************/ 
/* Insert any plugins code you want to use here. */ 
 
/****************************** MODULES *****************************/ 
/* Insert the media module tracking code here. */ 

In questa pagina