Esistono diversi metodi per tenere traccia degli eventi video, due dei quali sono opzioni precedenti per le versioni precedenti di Adobe Analytics. Queste opzioni precedenti sono: Precedenti pietre miliari e Secondi legacy.
Prima di continuare, accertatevi di disporre di un video riproducibile caricato all'interno AEM.
Per essere certi che i video vengano riprodotti sulla pagina, consultare questa esercitazione per informazioni su come transcodificare i file video in AEM.
Per impostare un framework per il tracciamento video con ciascun metodo, utilizzate la procedura seguente.
Per le nuove implementazioni, si consiglia di non utilizzare le opzioni legacy per il tracciamento video. Utilizzare invece il metodo Milestones.
Per impostare una pagina Web, trascinate un componente video dalla barra laterale e aggiungete un video riproducibile come risorsa per il componente
Creare una configurazione e un framework Adobe Analytics .
Nella pagina del framework, selezionate un RSID e impostate l’utilizzo su tutti. (https://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)
Dalla categoria del componente Generale nella barra laterale, trascinate il componente Video nella cornice.
Selezionare un metodo di tracciamento:
Quando si seleziona un metodo di tracciamento, l’elenco delle variabili CQ cambia di conseguenza. Utilizzate le sezioni seguenti per informazioni su come configurare ulteriormente il componente e mappare le variabili CQ con proprietà Adobe Analytics.
Il metodo Milestones monitora la maggior parte delle informazioni sul video, è altamente personalizzabile e facile da configurare.
Per utilizzare il metodo Milestones, specificate gli offset di traccia basati sul tempo per definire le pietre miliari. Quando la riproduzione di un video supera una fase cardine, la pagina chiama Adobe Analytics per tenere traccia dell’evento. Per ogni pietra miliare definita, il componente crea una variabile CQ che è possibile mappare a una proprietà Adobe Analytics . Il nome di queste variabili CQ utilizza il formato seguente:
eventdata.events.milestoneXX
Il suffisso XX è l’offset della traccia che definisce la pietra miliare. Ad esempio, se specificate gli offset di traccia di 4, 8, 16, 20 e 28 secondi, vengono generate le seguenti variabili CQ:
eventdata.events.milestone4
eventdata.events.milestone8
eventdata.events.milestone16
eventdata.events.milestone20
eventdata.events.milestone28
Nella tabella seguente sono descritte le variabili CQ predefinite fornite per il metodo Milestones:
Variabili CQ | delle proprietà Adobe Analytics |
---|---|
eventdata.videoName | Le variabili mappate a questo file conterranno il nome descrittivo (Title) del video, se impostato in DAM; se non è impostato, verrà inviato il file name del video. È stato inviato solo una volta, all’inizio della riproduzione di un video. |
eventdata.videoFileName | Le variabili mappate a questo file conterranno il nome del file. Inviato solo con eventdata.events.a.media.view |
eventdata.videoFilePath | Le variabili mappate a questo file conterranno il percorso del file sul server. Inviato solo con eventdata.events.a.media.view |
eventdata.events.a.media.segmentView | Inviato ogni volta che viene superata una fase cardine del segmento |
eventdata.events.a.media.timePlayed | Inviato ogni volta che viene attivata una pietra miliare, viene inviato anche il numero di secondi trascorsi dall'utente durante la visione di un dato segmento. ad esempio eventX=21 |
eventdata.events.a.media.view | Inviato all’inizializzazione della visualizzazione video |
eventdata.events.a.media.complete | Inviato al termine della riproduzione del video |
eventdata.events.milestoneX | Inviato quando il milestone viene passato, X rappresenta il secondo momento in cui il milestone viene attivato a |
eventdata.a.contentType | Inviato su ogni pietra miliare; viene visualizzato come pev3 nella chiamata Adobe Analytics , in genere inviato come "video" |
eventdata.a.media.name | Corrisponde esattamente a eventdata.videoName |
eventdata.a.media.segment | Contiene informazioni sul segmento visualizzato, ad esempio 2:O:4-8 |
Potete impostare il nome di un video facile da usare aprendo il video per la modifica in DAM e impostando il campo di metadati Title sul nome desiderato.
Dopo aver selezionato Valori intermedi come metodo di tracciamento, nella casella Offset traccia immettete un elenco separato da virgole di scostamenti di tracciamento in secondi. Ad esempio, il seguente valore definisce le pietre miliari a 4, 8, 16, 20 e 28 secondi dall’inizio del video:
4,8,16,20,24
I valori di offset devono essere numeri interi maggiori di 0. Il valore predefinito è 10,25,50,75
.
Per mappare le variabili CQ su proprietà Adobe Analytics, trascinate le proprietà Adobe Analytics da ContentFinder accanto alla variabile CQ sul componente.
Per informazioni sull'ottimizzazione delle mappature, vedere la guida Measuring Video in Adobe Analytics.
Aggiungete il framework alla pagina.
Per verificare la configurazione in Modalità anteprima, riprodurre il video per ottenere chiamate Adobe Analytics da attivare.
Gli esempi di dati di tracciamento Adobe Analytics che seguono si applicano al tracciamento delle attività cardine utilizzando gli offset di tracciamento di 4,8,16,20 e 24, e le mappature seguenti per le variabili CQ:
Variabile CQ | , proprietà Adobe Analytics |
---|---|
eventdata.videoName | prop2 |
eventdata.videoFileName | prop3 |
eventdata.videoFilePath | prop4 |
eventdata.events.a.media.segmentView | event1 |
eventdata.events.a.media.timePlayed | event2 |
eventdata.events.a.media.view | event3 |
eventdata.events.a.media.complete | event4 |
eventdata.events.milestone4 | event10 |
eventdata.events.milestone8 | event11 |
eventdata.events.milestone16 | event12 |
eventdata.events.milestone20 | event13 |
eventdata.events.milestone24 | event14 |
eventdata.a.contentType | eVar 3 |
eventdata.a.media.name | eVar 1, prop1 |
eventdata.a.media.segment | eVar 2 |
Per questo esempio, il componente Video viene visualizzato come segue nella pagina del framework:
Per visualizzare le chiamate effettuate a Adobe Analytics utilizzate uno strumento appropriato, come DigitalPulse Debugger o Fiddler.
Le chiamate a Adobe Analytics utilizzando l'esempio fornito dovrebbero essere simili a quelle riportate di seguito quando vengono visualizzate con DigitalPulse Debugger:
Si tratta del primocallback a Adobe Analytics contenente i seguenti valori:
Questa è la terzachiamata a Adobe Analytics:
Il metodo Milestones non legacy è simile al metodo Milestones, tranne che per le pietre miliari, che vengono definite utilizzando percentuali della lunghezza del binario. I comuni sono i seguenti:
Il nome di queste variabili CQ utilizza il formato seguente:
Il suffisso XX è la percentuale di lunghezza del brano che definisce il cardine. Se ad esempio si specificano percentuali pari a 10, 25, 50 e 75, vengono generate le seguenti variabili CQ:
eventdata.events.milestone10
eventdata.events.milestone25
eventdata.events.milestone50
eventdata.events.milestone75
eventdata.events.milestoneXX
Dopo aver selezionato Milestoni non legacy come metodo di tracciamento, nella casella Offset traccia immettete un elenco separato da virgole di percentuali di lunghezza del brano. Ad esempio, il seguente valore predefinito definisce le tappe a 10, 25, 50 e 75 percento della lunghezza della traccia:
10,25,50,75
I valori di offset devono essere numeri interi maggiori di 0.
Per mappare le variabili CQ su proprietà Adobe Analytics, trascinate le proprietà Adobe Analytics da ContentFinder accanto alla variabile CQ sul componente.
Per informazioni sull'ottimizzazione delle mappature, vedere la guida Measuring Video in Adobe Analytics.
Aggiungete il framework alla pagina.
Per verificare la configurazione in Modalità anteprima, riprodurre il video per ottenere chiamate Adobe Analytics da attivare.
Questo metodo è simile al metodo Milestones con la differenza che le pietre miliari specificate nel campo Offset tracciamento sono percentuali invece di punti impostati all'interno del video.
Il campo Offset tracciamento accetta solo un elenco separato da virgole contenente numeri interi compresi tra 1 e 100.
Impostare l'offset della traccia.
Inoltre, le informazioni inviate a Adobe Analytics sono meno personalizzabili; sono disponibili solo 3 variabili per la mappatura:
eventdata.videoName |
Le variabili mappate a questo file conterranno il nome descrittivo (Title) del video, se impostato in DAM; se il Titolo non è impostato, verrà inviato il file name del video. Inviato solo una volta, all'inizio della riproduzione di un video. |
eventdata.videoFileName | Le variabili mappate a questo file conterranno il nome del file. È stato inviato solo una volta, all’inizio della riproduzione di un video. |
eventdata.videoFilePath | La variabile mappata a questo conterrà il percorso del file sul server. È stato inviato solo una volta, all’inizio della riproduzione di un video. |
Potete impostare il nome di un video facile da usare aprendo il video per la modifica in DAM e impostando il campo di metadati Title sul nome desiderato. È inoltre necessario salvare le modifiche apportate al termine.
Mappatura di queste variabili su prop da 1 a 3
Il resto delle informazioni pertinenti nella chiamata verrà inviato concatenato in una variabile denominata pev3.
Le chiamate di esempio per Adobe Analytics utilizzando l'esempio fornito dovrebbero essere simili a quelle riportate di seguito quando vengono visualizzate con DigitalPulse Debugger:
La variabile pev3inviata nella chiamata contiene le informazioni seguenti:
Nome - Il nome del file video (film.avi)
Lunghezza - Lunghezza del file video, in secondi (100)
Nome lettore - Il lettore video utilizzato per riprodurre il file video (video ** HTML5)
Secondi totali riprodotti - Il numero totale di secondi di riproduzione del video (25)
Timestamp di inizio - Timestamp che identifica l’inizio della riproduzione video (1331035567)
Riproduci sessione - I dettagli della sessione di riproduzione. Questo campo indica in che modo l’utente ha interagito con il video. Questo potrebbe includere dati come dove hanno iniziato a riprodurre il video, se hanno usato il cursore video per far avanzare il video e dove hanno interrotto la riproduzione del video (L10E24S58L58 - video è stato arrestato al secondo. 25 della sezione L10, quindi saltato al secondo. 48)
Quando si utilizza il metodo dei secondi precedenti, chiamate Adobe Analytics vengono attivate ogni N-esimo secondo, dove N è specificato nel campo dell'offset del brano.
Imposta l'offset della traccia su un numero qualsiasi di secondi,
Il campo Offset tracciamento accetta solo numeri interi superiori a 0
Le informazioni inviate a Adobe Analytics sono meno personalizzabili. Sono disponibili solo 3 variabili per la mappatura:
eventdata.videoName |
Le variabili mappate a questo file conterranno il nome descrittivo (Title) del video, se impostato in DAM; se il Titolo non è impostato, verrà inviato il file name del video. Inviato solo una volta, all'inizio della riproduzione di un video. |
eventdata.videoFileName | La variabile mappata a questo conterrà il nome del file. È stato inviato solo una volta, all’inizio della riproduzione di un video. |
eventdata.videoFilePath | La variabile mappata a questo conterrà il percorso del file sul server. È stato inviato solo una volta, all’inizio della riproduzione di un video. |
Potete impostare il nome di un video facile da usare aprendo il video per la modifica in DAM e impostando il campo di metadati Title sul nome desiderato. È inoltre necessario salvare le modifiche apportate al termine.
Mappare queste variabili a prop1, prop2 e prop3
Il resto delle informazioni pertinenti nella chiamata verrà inviato concatinato in una variabile denominata pev3.
Le chiamate a Adobe Analytics utilizzando l'esempio fornito dovrebbero essere simili a quelle riportate di seguito quando vengono visualizzate con DigitalPulse Debugger:
La chiamata è simile alla precedente chiamata Legacy Milestones. Si prega di vedere le informazioni su pev3 fornito in.
Riferimenti utilizzati in questa esercitazione:
[0] https://docs.adobe.com/content/help/it-IT/media-analytics/using/media-overview.html