Configurazione del tracciamento video per Adobe Analytics

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.

Per impostare un framework per il tracciamento video con ciascun metodo, utilizzate la procedura seguente.

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

2. Creare una configurazione e un framework Adobe Analytics .

   • Gli esempi nelle sezioni seguenti utilizzano il nome my-sc-configuration per la configurazione e videofw per il framework.

3. Nella pagina del framework, selezionate un RSID e impostate l’utilizzo su tutti. (https://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)

4. Dalla categoria del componente Generale nella barra laterale, trascinate il componente Video nella cornice.

5. Selezionare un metodo di tracciamento:

   • Pietre miliari
   • Pietre miliari non legacy
   • Precedenti pietre miliari
   • Secondi legacy

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

Pietre miliari

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

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

3. Aggiungete il framework alla pagina.

4. 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:

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 primo​callback a Adobe Analytics contenente i seguenti valori:

• prop1 e eVar1 per eventdata.a.media.name,
• props2-4, insieme a eVar2 e eVar3 contenente contentType (video) e segmento (1:O:1-4)
• event3 mappato a eventdata.events.a.media.view.

Questa è la terza​chiamata a 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.
• Il set statico di variabili CQ, definito per la mappatura con 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 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.

3. Aggiungete il framework alla pagina.

4. Per verificare la configurazione in Modalità anteprima, riprodurre il video per ottenere chiamate Adobe Analytics da attivare.

Lettere cardine precedenti

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.

1. Impostare l'offset della traccia.

   • e.g.10,50,75,100

   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.

1. 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 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’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)

Secondi precedenti

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.

1. Imposta l'offset della traccia su un numero qualsiasi di secondi,

   • ad esempio 6
   NOTA

   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.

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