Show Menu
ARGOMENTI×

Configurazione del tracciamento video per Adobe Analytics

Esistono diversi metodi per tenere traccia degli eventi video, due dei quali sono opzioni legacy 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 in AEM.
Per essere certi che i video vengano riprodotti sulla pagina, consultate 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 .

Passaggi comuni

  1. Per impostare una pagina Web, trascinate un componente ​video dalla barra laterale e aggiungete un video riproducibile come risorsa per il componente
    • Gli esempi nelle sezioni seguenti utilizzano il nome my-sc-configuration per la configurazione e il video per il framework.
  2. Nella pagina del framework, selezionate un RSID e impostate l’utilizzo su tutti. ( https://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html )
  3. Dalla categoria del componente Generale nella barra laterale, trascinate il componente Video nella cornice.
  4. Selezionare un metodo di tracciamento:
  5. 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 le proprietà Adobe Analytics.

Milestones

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 Proprietà Adobe Analytics
eventdata.videoName Le variabili mappate a questo file conterranno il nome intuitivo ( Titolo ) del video, se impostato in DAM; se non è impostato, viene inviato il nome del file 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 indica il secondo in cui il cardine viene attivato a
eventdata.a.contentType Inviato su ogni pietra miliare; viene visualizzato come pev3 nella chiamata Adobe Analytics, solitamente 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 un nome semplice per un video aprendo il video per la modifica in DAM e impostando il campo di metadati Titolo sul nome desiderato.
  1. 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 .
  2. Per mappare le variabili CQ alle proprietà Adobe Analytics, trascinate le proprietà Adobe Analytics da ContentFinder accanto alla variabile CQ sul componente.
    Per informazioni sull’ottimizzazione delle mappature, consultate la guida Measuring Video in Adobe Analytics guide.
  3. Per verificare la configurazione in modalità ​Anteprima, riprodurre il video per attivare le chiamate Adobe Analytics.
Gli esempi di dati di tracciamento di Adobe Analytics riportati di seguito 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 Adobe , proprietà 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 eVar3
eventdata.a.media.name eVar1, prop1
eventdata.a.media.segment eVar2
Per questo esempio, il componente Video viene visualizzato come segue nella pagina del framework:
Per visualizzare le chiamate effettuate ad Adobe Analytics utilizzate uno strumento appropriato, come DigitalPulse Debugger o Fiddler.
Le chiamate ad Adobe Analytics utilizzando l'esempio fornito dovrebbero essere simili a quelle riportate di seguito quando vengono visualizzate con DigitalPulse Debugger:
Si tratta della prima chiamata ​effettuata ad Adobe Analytics contenente i valori seguenti:
  • prop1 e eVar1 per eventdata.a.media.name,
  • props2-4, insieme a eVar2 ed eVar3 contenente contentType (video) e segmento (1:O:1-4)
  • event3 mappato a eventdata.events.a.media.view.
Questa è la terza chiamata ​effettuata ad Adobe Analytics:
  • prop1 e eVar1 contengono a.media.name;
  • event1 perché è stato visualizzato un segmento
  • event2 inviato con tempo riprodotto = 4
  • event11 inviato perché è stato raggiunto eventdata.events.milestone8
  • prop2-4 non vengono inviati (poiché eventdata.events.a.media.view non è stato attivato)

Pietre miliari non legacy

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:
  • Quando la riproduzione di un video supera una fase cardine, la pagina chiama Adobe Analytics per tenere traccia dell’evento.
  • Set statico di variabili CQ definite per la mappatura con le proprietà Adobe Analytics.
  • 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:
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

  1. 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.
  2. Per mappare le variabili CQ alle proprietà Adobe Analytics, trascinate le proprietà Adobe Analytics da ContentFinder accanto alla variabile CQ sul componente.
    Per informazioni sull’ottimizzazione delle mappature, consultate la guida Measuring Video in Adobe Analytics guide.
  3. Per verificare la configurazione in modalità ​Anteprima, riprodurre il video per attivare le chiamate Adobe Analytics.

Precedenti pietre miliari

Questo metodo è simile al metodo Pietre miliari con la differenza che le pietre miliari specificate nel campo Offset ** tracciamento sono percentuali invece che 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.
  1. Impostare l'offset della traccia.
    • e.g.10,50,75,100
    Inoltre, le informazioni inviate ad Adobe Analytics sono meno personalizzabili; sono disponibili solo 3 variabili per la mappatura:
eventdata.videoName Le variabili mappate a questo file conterranno il nome intuitivo ( Titolo ) del video, se impostato in DAM; se il Titolo non è impostato, viene inviato il nome del file 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. È 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 un nome semplice per un video aprendo il video per la modifica in DAM e impostando il campo di metadati Titolo sul nome desiderato. È inoltre necessario salvare le modifiche apportate al termine.
  1. Mappatura di queste variabili su prop da 1 a 3
    Il resto delle informazioni pertinenti nella chiamata sarà inviato concatenato in una variabile denominata pev3 .
    Le chiamate di esempio ad Adobe Analytics utilizzando l'esempio fornito dovrebbero essere simili a quelle riportate di seguito quando vengono visualizzate con DigitalPulse Debugger:
    La variabile pev3 ​inviata 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'avvio 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. Ciò potrebbe includere dati quali dove hanno iniziato a riprodurre il video, se hanno utilizzato il cursore video per far avanzare il video e dove hanno interrotto la riproduzione ( L10E24S58L58 - il video è stato arrestato al secondo. 25 della sezione L10, quindi saltato al secondo. 48 )

Secondi precedenti

Quando si utilizza il metodo** dei secondi* legacy, le chiamate Adobe Analytics vengono attivate ogni N-esimo secondo, dove N è specificato nel campo dell'offset del brano.
  1. Imposta l'offset della traccia su un numero qualsiasi di secondi,
    • ad esempio 6
    Il campo Offset tracciamento accetta solo numeri interi superiori a 0
    Le informazioni inviate ad Adobe Analytics sono meno personalizzabili. Sono disponibili solo 3 variabili per la mappatura:
eventdata.videoName Le variabili mappate a questo file conterranno il nome intuitivo ( Titolo ) del video, se impostato in DAM; se il Titolo non è impostato, viene inviato il nome del file del video. È stato 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 un nome semplice per un video aprendo il video per la modifica in DAM e impostando il campo di metadati Titolo sul nome desiderato. È inoltre necessario salvare le modifiche apportate al termine.
  1. Mappare queste variabili a prop1, prop2 e prop3
    Il resto delle informazioni pertinenti nella chiamata sarà inviato concatinato in una variabile denominata pev3 .
    Le chiamate ad 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 lì .
Riferimenti utilizzati in questa esercitazione: