Configurazione del tracciamento video per Adobe Analytics configuring-video-tracking-for-adobe-analytics

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Amministratore

Sono disponibili diversi metodi per il tracciamento degli eventi video, due dei quali sono opzioni legacy per le versioni precedenti di Adobe Analytics. Queste opzioni legacy sono: Milestone legacy e Secondi legacy.

NOTE

Prima di continuare, assicurati di avere un video riproducibile caricato in AEM.

Per assicurarsi che i tuoi video vengano riprodotti sulla pagina, consulta questo tutorial per informazioni su come trascodificare i file video in AEM.

Utilizza la procedura seguente per impostare un framework per il tracciamento video utilizzando ogni metodo.

NOTE

Per le nuove implementazioni, si consiglia di non utilizzare le opzioni legacy per il tracciamento video. Utilizza invece il metodo Milestones.

Passaggi comuni common-steps

Configura una pagina Web trascinando un componente video dalla barra laterale e aggiungendo un video riproducibile come risorsa per il componente
Creare una configurazione e un framework di Adobe Analytics.
- Gli esempi nelle sezioni seguenti utilizzano il nome my-sc-configuration per la configurazione e videofw per il framework.
Nella pagina framework, selezionare un RSID e impostare l'utilizzo su tutti. (https://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)
Dalla categoria Componente generale in Sidekick, trascina il componente Video nel framework.
Seleziona un metodo di tracciamento:
Quando selezioni un metodo di tracciamento, l’elenco delle variabili CQ cambia di conseguenza. Utilizza le sezioni seguenti per informazioni su come configurare ulteriormente il componente e mappare le variabili CQ con le proprietà di Adobe Analytics.

Milestone milestones

Il metodo Milestones traccia la maggior parte delle informazioni sul video, è altamente personalizzabile e facile da configurare.

Per utilizzare il metodo Milestones, specificare gli offset della traccia basati sul tempo per definire le milestone. Quando una riproduzione video supera una fase cardine, la pagina chiama Adobe Analytics per tracciare l’evento. Per ogni attività cardine definita, il componente crea una variabile CQ da mappare su una proprietà Adobe Analytics. Il nome di queste variabili CQ utilizza il seguente formato:

eventdata.events.milestoneXX

Il suffisso XX è lo scostamento della traccia che definisce la fase cardine. Ad esempio, specificando uno scostamento 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 vengono descritte le variabili CQ predefinite fornite per il metodo Milestones:

Variabili CQ

Proprietà Adobe Analytics

eventdata.videoName

Le variabili mappate a questo conterranno il nome descrittivo (Titolo) del video se è impostato in DAM; se non è impostato, verrà inviato il nome file del video. Inviato una sola volta, all’inizio della riproduzione di un video.

eventdata.videoFileName

Le variabili mappate a questo conterranno il nome del file. Inviato solo con eventdata.events.a.media.view

eventdata.videoFilePath

Le variabili mappate a questo 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 passata una milestone di segmento

eventdata.events.a.media.timePlayed

Inviato ogni volta che viene attivata una milestone, insieme a questo evento viene inviato anche il numero di secondi trascorsi dall’utente a guardare il segmento specificato. 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 la data milestone viene passata, X sta per il secondo momento in cui la milestone viene attivata alle

eventdata.a.contentType

Inviato per ogni milestone; viene visualizzato come pev3 nella chiamata Adobe Analytics, di solito inviata 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

NOTE

Puoi impostare il nome descrittivo di un video aprendo il video per la modifica in DAM e impostando il campo di metadati Titolo sul nome desiderato.

Dopo aver selezionato le Milestone come metodo di tracciamento, nella casella Offset tracciamento immettere un elenco separato da virgole di offset di tracciamento in secondi. Ad esempio, il seguente valore definisce le milestone a 4, 8, 16, 20 e 28 secondi dopo l’inizio del video:

code language-xml
`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 alle proprietà di Adobe Analytics, trascina le proprietà di Adobe Analytics da ContentFinder accanto alla variabile CQ sul componente.

Per informazioni sull'ottimizzazione delle mappature, vedere la guida alla misurazione di video in Adobe Analytics.
Aggiungere il framework alla pagina.
Per verificare l'installazione in Modalità anteprima, riprodurre il video per attivare le chiamate di Adobe Analytics.

Gli esempi di dati di tracciamento di Adobe Analytics riportati di seguito si applicano al tracciamento di Milestone utilizzando offset di tracciamento di 4,8,16,20 e 24 e le seguenti mappature per le variabili CQ:

Variabile CQ

Adobe Analytics, proprietà

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

In questo esempio, il componente Video viene visualizzato come segue nella pagina del framework:

video1

NOTE

Per visualizzare le chiamate effettuate ad Adobe Analytics utilizza uno strumento appropriato, come DigitalPulse Debugger o Fiddler.

Le chiamate ad Adobe Analytics che utilizzano l'esempio fornito dovrebbero essere simili a queste quando vengono visualizzate con DigitalPulse Debugger:

chlimage_1-128

Questa è la prima chiamata effettuata ad Adobe Analytics contenente i seguenti valori:

prop1 e eVar1 per eventdata.a.media.name,
props2-4, insieme a eVar2 e eVar3 contenenti contentType (video) e segmento (11-4)
event3 mappato a eventdata.events.a.media.view.

chlimage_1-129

Questa è la terza chiamata effettuata ad Adobe Analytics:

prop1 e eVar1 contengono a.media.name;
evento1 perché è stato visualizzato un segmento
evento2 inviato con tempo di riproduzione = 4
event11 inviato perché eventdata.events.milestone8 è stato raggiunto
prop2-4 non viene inviato (poiché eventdata.events.a.media.view non è stato attivato)

Milestone non legacy non-legacy-milestones

Il metodo delle Milestone non legacy è simile al metodo delle Milestone, tranne per il fatto che le milestone sono definite utilizzando percentuali della lunghezza del tracciato. Le caratteristiche comuni sono le seguenti:

Quando una riproduzione video supera una fase cardine, la pagina chiama Adobe Analytics per tracciare l’evento.
insieme statico di variabili CQ definito per la mappatura con proprietà Adobe Analytics.
Per ogni attività cardine definita, il componente crea una variabile CQ da mappare su una proprietà Adobe Analytics.

Il nome di queste variabili CQ utilizza il seguente formato:

Il suffisso XX è la percentuale della lunghezza del brano che definisce la fase cardine. Ad esempio, specificando percentuali di 10, 25, 50 e 75 si generano le seguenti variabili CQ:

eventdata.events.milestone10
eventdata.events.milestone25
eventdata.events.milestone50
eventdata.events.milestone75

eventdata.events.milestoneXX

Dopo aver selezionato le Milestone non legacy come metodo di tracciamento, nella casella Offset traccia immettere un elenco separato da virgole di percentuali della lunghezza del tracciamento. Ad esempio, il seguente valore predefinito definisce le attività cardine al 10, 25, 50 e 75 per cento della lunghezza del tracciamento:

code language-xml
`10,25,50,75`

I valori di offset devono essere numeri interi maggiori di 0.

Per mappare le variabili CQ alle proprietà di Adobe Analytics, trascina le proprietà di Adobe Analytics da ContentFinder accanto alla variabile CQ sul componente.

Per informazioni sull'ottimizzazione delle mappature, vedere la guida alla misurazione di video in Adobe Analytics.
Aggiungere il framework alla pagina.
Per verificare l'installazione in Modalità anteprima, riprodurre il video per attivare le chiamate di Adobe Analytics.

Milestone legacy legacy-milestones

Questo metodo è simile al metodo Milestones, con la differenza che le milestone specificate nel campo Offset tracciamento sono percentuali invece dei punti impostati all'interno del video.

NOTE

Il campo Offset tracciamento accetta solo un elenco separato da virgole contenente numeri interi compresi tra 1 e 100.

Impostate l'offset del brano.
- ad esempio,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 conterranno il nome descrittivo (Titolo) del video se impostato in DAM; se il Titolo non è impostato, verrà inviato il nome file del video. Inviato una sola volta, all'inizio della riproduzione di un video.

eventdata.videoFileName

Le variabili mappate a questo conterranno il nome del file. Inviato una sola volta, all’inizio della riproduzione di un video.

eventdata.videoFilePath

La variabile mappata a questo conterrà il percorso del file sul server. Inviato una sola volta, all’inizio della riproduzione di un video.

NOTE

Puoi impostare il nome descrittivo di un video aprendo il video per la modifica in DAM e impostando il campo di metadati Titolo sul nome desiderato. Al termine, è inoltre necessario salvare le modifiche apportate.

Mappa queste variabili su prop da 1 a 3

Le altre informazioni rilevanti nella chiamata verranno inviate concatenate in una variabile denominata pev3.

Le chiamate di esempio ad Adobe Analytics che utilizzano l'esempio fornito dovrebbero essere simili a queste se visualizzate con DigitalPulse Debugger:

La variabile pev3 inviata nella chiamata contiene le seguenti informazioni:
- Nome - 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 (HTML5 video)
- Totale secondi riprodotti - Numero totale di secondi di riproduzione del video (25)
- Timestamp di inizio - Timestamp che identifica l'avvio della riproduzione del video (1331035567)
- Sessione di riproduzione - Dettagli della sessione di riproduzione. Questo campo indica come l’utente ha interagito con il video. Questo potrebbe includere dati quali il punto in cui è stata avviata la riproduzione del video, se è stato utilizzato il cursore video per far avanzare il video e il punto in cui è stata interrotta la riproduzione del video (L10E24S58L58 - video interrotto al secondo. 25 della sezione L10, quindi saltato a sec. 48)

Secondi legacy legacy-seconds

Quando si utilizza il metodo  secondi precedenti, le chiamate di Adobe Analytics vengono attivate ogni N-esimo secondo, dove N è specificato nel campo Offset tracciamento.

Impostare lo scostamento del brano su un numero qualsiasi di secondi,

ad esempio, 6

note note
NOTE
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

eventdata.videoFileName

La variabile mappata a questo conterrà il nome del file. Inviato una sola volta, all’inizio della riproduzione di un video.

eventdata.videoFilePath

La variabile mappata a questo conterrà il percorso del file sul server. Inviato una sola volta, all’inizio della riproduzione di un video.

NOTE

Mappa queste variabili su prop1, prop2 e prop3

Le altre informazioni rilevanti nella chiamata verranno inviate concatenate in una variabile denominata pev3.

Le chiamate ad Adobe Analytics che utilizzano l'esempio fornito dovrebbero essere simili a queste quando vengono visualizzate con DigitalPulse Debugger:

La chiamata è simile alla chiamata Legacy Milestones precedente. Vedi le informazioni sul pev3 fornito.

Riferimenti utilizzati in questa esercitazione:

[0] https://experienceleague.adobe.com/docs/media-analytics/using/media-overview.html?lang=it

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2