Panoramica su Milestone milestone-overview

Metrica video

Tipo di variabile

Descrizione

Contenuto

Scadenza predefinita eVar
: visita

(obbligatorio) raccoglie il nome del video, come specificato nell’implementazione.

Tipo di contenuto

Scadenza predefinita eVar
: visualizzazione pagina

Raccoglie dati relativi al tipo di contenuto visualizzato da un visitatore. Agli hit inviati dalla misurazione video viene assegnato il tipo di contenuto video.
Questa variabile non deve essere riservata esclusivamente al tracciamento video. Se la stessa variabile viene usata anche per ottenere il tipo di altri contenuti, è possibile analizzare la distribuzione dei visitatori per diversi tipi di contenuto. Ad esempio, puoi usare questa variabile per assegnare valori quali article o product page ad altri tipi di contenuti.
Dal punto di vista della misurazione dei video, il tipo di contenuto permette di individuare i visitatori che guardano un video e quindi calcolare i tassi di conversioni derivanti dal video.

Tempo trascorso dei contenuti

Tipo di
evento: contatore

Conta il tempo, in secondi, trascorso a guardare un video dall'ultimo processo di raccolta di dati di una richiesta di immagine.

Inizia video

Tipo di
evento: 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

Tipo di
evento: 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 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.

Variabile

Descrizione

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, al posto di pev3 legacy.
Utilizza Media.contextDataMapping per mappare i dati contestuali alle eVar e agli eventi selezionati.
Valore predefinito: false

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 alle eVar e agli eventi da utilizzare per la misurazione video. L’oggetto deve mappare i campi seguenti:

a.media.name: (obbligatorio) popola le variabili con il nome del video. Fornisci l’eVar selezionata per memorizzare il nome del video e la variabile video Custom Insight (s.prop) da utilizzare per il percorso del video. Fornisci 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 in cui memorizzare il valore video che contiene il tracciamento delle visite e dei visitatori abilitato per generare i relativi rapporti. 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 da utilizzare per conteggiare le visualizzazioni multimediali.

a.media.segmentView: (facoltativo) l’evento da utilizzare per conteggiare le visualizzazioni dei segmenti.

a.media.complete: (facoltativo) l’evento da utilizzare per conteggiare le visualizzazioni complete.

a.media.timePlayed: (facoltativo, fortemente consigliato) l’evento numerico da utilizzare per memorizzare il numero di secondi di video riprodotti.

a.media.milestones: (facoltativo) un oggetto che mappa le attività cardine di s.Media.trackMilestones come contatore degli eventi. Media.segmentByMilestones deve essere impostato su true se si definiscono le attività cardine.

Tracciamento degli annunci Per tracciare gli annunci, sono disponibili le seguenti variabili di dati di contesto:
a.media.ad.name: (obbligatorio) popola le variabili con il nome dell’annuncio. Fornisci l'eVar selezionata per memorizzare il nome dell'annuncio e la variabile Custom Insight Video (s.prop) da utilizzare per il percorso. Fornisci 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 prefisso “~”) che si applica a questa riproduzione.

a.media.ad.view: funziona allo stesso modo di a.media.view

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

a.media.ad.timePlayed: funziona allo stesso modo di a.media.timePlayed

a.media.ad.complete: funziona allo stesso modo di a.media.complete a.media.ad.segment: funziona allo stesso modo di a.media.segment

a.media.ad.segmentView: funziona allo stesso modo di a.media.segmentView

a.media.ad.milestoni: funziona allo stesso modo di a.media.milestones

a.media.ad.offsetMilestones: funziona allo stesso modo di a.media.offsetMilestones

Sintassi:

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

un elenco separato da virgole di tutte le variabili impostate nel codice di tracciamento video.

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.

Variabile

Descrizione

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 tramite la procedura guidata di importazione video in Flash Professional)
• Silverlight
• MediaDisplay
• MediaPlayback
• API Brightcove versioni 2 e 3 (consulta Brightcove)
• Windows Media Player, Quicktime o Real Player con JavaScript

Se non si utilizza uno dei lettori di cui sopra, per tracciare gli eventi del lettore, è possibile utilizzare Media.open Media.play Media.stop Media.close.

Sintassi:

s.Media.autoTrackNetStreams = true

Flash 10.3 ha introdotto nuove funzionalità per il componente NetStream che consentono un tracciamento video avanzato. Se utilizzi un lettore NetStream di Flash personalizzato, è possibile abilitare questa variabile per attivare funzionalità simili ad autoTrack. Questo metodo richiede che i video siano visualizzati in Flash 10.3 o versione successiva.

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.

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 ed è conteggiato ancora 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.

Sintassi:

s.Media.playerName = "Custom Player Name"

specifica il nome di un lettore video personalizzato.

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 di 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.

Traccia le attività cardine 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. Specifica le attività cardine come un elenco separato da virgole di numeri interi. Ad esempio: 10 = 10%, 23 = 23%.

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

L’abilitazione di 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.

Traccia le attività cardine 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. Specifica le attività cardine come un elenco separato da virgole di numeri interi. Ad esempio: 20 = 20 secondi, 40 = 40 secondi).

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

L’abilitazione di 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.

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 contenuto multimediale e alle attività cardine specificate in Media.trackMilestones

La segmentazione per attività cardine è l’unico modo per definire i segmenti quando si utilizza autoTrack.

Valore predefinito: false

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 contenuto multimediale e alle attività cardine specificate in Media.trackOffsetMilestones

La segmentazione per attività cardine è l’unico modo per definire i segmenti quando si utilizza autoTrack.

Valore predefinito: false

Variabile

Descrizione

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 di 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.

Traccia le attività cardine di annunci 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. Specifica le attività cardine come un elenco separato da virgole di numeri interi. Ad esempio: 10 = 10%, 23 = 23%).

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

L’abilitazione di 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.

Traccia le attività cardine dell’annuncio 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. Specifica le attività cardine come un elenco separato da virgole di numeri interi. Ad esempio: 20 = 20 secondi, 40 = 40 secondi).

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

L’abilitazione di 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.

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 contenuto multimediale e alle attività cardine specificate in Media.adTrackMilestones

La segmentazione per attività cardine è l’unico modo per definire i segmenti quando si utilizza autoTrack.

Valore predefinito: false

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 contenuto multimediale e alle attività cardine specificate in Media.adTrackOffsetMilestones

La segmentazione per attività cardine è l’unico modo per definire i segmenti quando si utilizza autoTrack.

Valore predefinito: false

Metodo

Descrizione

Sintassi:

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

prepara il modulo multimediale per raccogliere i dati di tracciamento video. Questo metodo tiene conto dei seguenti parametri:

• mediaName: (obbligatorio) il nome del video come desideri che venga visualizzato nei rapporti video.
• mediaLength: (obbligatorio) la durata del video in secondi.
• mediaPlayerName: (obbligatorio) il nome del lettore multimediale utilizzato per visualizzare il video, come desideri che venga visualizzato nei rapporti video.

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 tiene conto dei seguenti parametri:

• name: (obbligatorio) il nome o l’ID dell’annuncio.
• length: (obbligatorio) la durata 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 l’annuncio è incorporato.
• 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 prefisso “~”) che si applica a questa riproduzione.

Sintassi:

s.Media.click(name, offset)

traccia quando è stato fatto clic su un annuncio in un video. Questo metodo tiene conto dei 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.

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 tiene conto del seguente parametro:

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

Sintassi:

s.Media.complete(name, offset)

questo metodo traccia manualmente un evento completo. Questo metodo viene utilizzato è 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, è possibile 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 durata e al tipo di contenuto. Questo metodo tiene conto dei seguenti parametri:

• mediaName: il nome del video. Deve corrispondere al nome utilizzato in Media.open.
• mediaOffset: il numero di secondi trascorsi nel video quando l’evento di completamento deve essere inviato. Specifica l’offset in base al video a partire dal secondo zero.
  
  Se il lettore multimediale traccia utilizzando i millisecondi, assicurati che il valore sia convertito in secondi prima di chiamare Media.complete.

Se prevedi di effettuare una chiamata di tipo “completato“ manualmente, imposta

s.Media.completeByCloseOffset = false.

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, è possibile 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 tiene conto dei 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. Specifica l’offset in base al video a partire dal secondo zero. Se il lettore multimediale traccia utlizzando i millisecondi, assicurati che il valore sia convertito in secondi prima di chiamare Media.play.

segmentNum: (facoltativo) il numero del 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 durata 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)

Sintassi:

s.Media.stop(mediaName, mediaOffset)

traccia un evento di arresto (arresto, pausa, ecc.) per il video specificato. Questo metodo tiene conto dei seguenti parametri:

• mediaName: il nome del video. Deve corrispondere al nome utilizzato in Media.open.
• mediaOffset: il numero di secondi trascorsi nel video in cui si verifica l’evento di arresto o pausa. Specifica l'offset in base al video a partire dal secondo zero.

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 classe tiene conto dei parametri s e media.

Utilizza questo metodo per inviare metriche video aggiuntive. È possibile configurare 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 tiene conto dei seguenti parametri:

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

media: un oggetto con i membri che forniscono lo stato del video. Tali membri includono:

• media.name: il nome del video. Deve corrispondere al nome utilizzato in Media.open;
• media.length: la durata del video in secondi indicata nella chiamata a Media.open;
• media.playerName: il nome del lettore multimediale fornito nella chiamata a Media.open;
• media.openTime: un oggetto NSDate contenente dati su quando è stata effettuata la chiamata a Media.open;
• media.offset: l’offset corrente, in secondi, nel video (punto effettivo 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 riprodotti finora;
• 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 tramite Media.autoTrack o una chiamata a Media.play;
• CLOSE: quando la riproduzione termina al completamento del video tramite Media.autoTrack o a una chiamata a Media.close;
• PLAY: quando la riproduzione riprende dopo essere stata messa in pausa o viene eseguito lo scorrimento tramite Media.autoTrack o una seconda chiamata a Media.play;
• STOP: quando la riproduzione si arresta a causa di una pausa dell’inizio dello scorrimento tramite Media.autoTrack o 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 variabile Media.trackSeconds;
• MILESTONE: alle attività cardine definite dalla variabile Media.trackMilestones;

Sintassi:

s.Media.track(mediaName)

invia immediatamente lo stato del video corrente, insieme a qualsiasi Media.trackVars e Media.trackEvents definiti. Questo metodo viene utilizzato in Media.monitor.

Consulta Misurazione di metriche aggiuntive tramite Media.monitor.

Chiama Media.open e Media.play sul video prima di richiamare questo metodo. Questo metodo tiene conto del seguente parametro:

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

Questo metodo rappresenta 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.