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.

NOTA

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.

NOTA

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

  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. (http://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:

  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
NOTA

Potete impostare un nome user friendly di un video aprendo il video per la modifica in DAM e impostando il campo di metadati Title 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 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:

video1

NOTA

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:

chlimage_1-156

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.

chlimage_1-157

Questa è la terza​chiamata a Adobe Analytics:

  • prop1 e eVar 1 contengonoa.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.

NOTA

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

Per impostare un nome user friendly di un video, aprire il video per l'editing nel DAM e impostare il campo Title metadata 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 verrà inviato concatinato 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:

    lmilestones1

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

Potete impostare un nome user friendly di un video 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.

  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:

    lsecondi

    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/sdk-implement/setup/setup-overview.html

In questa pagina