Panoramica dell’estensione per il tracciamento di video BrightCove
Prerequisiti
Per ogni proprietà in Adobe Experience Platform è necessario installare e configurare le seguenti estensioni nella schermata Extension:
- Adobe Analytics
- Servizio ID visitatore di Experience Cloud
- Estensioni core installate
Utilizza lo snippet di codice “In-Page embed code (Advanced)” nell’HTML di ogni pagina web in cui deve essere eseguito il rendering di un lettore video. Lo snippet HTML “In-Page Embed code (Advanced)” si trova nella documentazione di Brightcove. Il seguente collegamento fornisce ulteriori informazioni su come generare codice da incorporare sia per i lettori video in anteprima che per quelli pubblicati.
Questa versione dell’estensione 1.1.0 consente di incorporare più video BrightCove in una singola pagina web. Se all’interno dei tag di incorporamento avanzati sono presenti più proprietà id
, accertati che ciascuna di esse disponga di valori univoci. Ad esempio, player1
, player2
e così via.
Se la pagina web che utilizza questa estensione che interagisce con il video prima che lo script rilevante sia stato completamente caricato, è possibile eseguire due azioni per risolvere il problema. In primo luogo, la libreria di tag può essere caricata in modo sincrono e, in secondo luogo, si può inserire l’elemento <script type="text/javascript">\_satellite.pageBottom();\</script\>
prima che il video venga incorporato nella pagina.
Per ulteriori informazioni sui metodi dei componenti e gli eventi utilizzati in questa estensione, consulta la documentazione dell’API di BrightCove.
Elementi dati
Nell’estensione sono disponibili sette elementi dati, nessuno dei quali richiede la configurazione.
- Playhead Position: quando questo elemento dati viene chiamato all’interno di una regola di tag, registra in secondi la posizione della testina di riproduzione sulla timeline del video.
- Video Account ID: questo elemento dati registra l’ID dell’account BrightCove che ha pubblicato il video.
- Video Duration: questo elemento dati registra la durata totale in secondi dei contenuti video. Inoltre, è possibile creare una metrica calcolata all’interno di Analytics per convertire il numero in secondi, minuti o ore.
- Video Ad Support: questo elemento dati specifica se gli annunci sono supportati o meno all’interno del video.
- Video ID: questo elemento dati specifica l’ID BrightCove associato al video.
- Video Name: questo elemento dati specifica il nome descrittivo del video.
- Video Tags: questo elemento dati specifica gli script associati al video.
Eventi
Nell’estensione sono disponibili sette eventi, solo Custom Cue Point Tracking richiede la configurazione.
- Custom Cue Point Tracking: questo evento viene attivato quando il video raggiunge la percentuale di soglia video specificata. Ad esempio, se un video dura 60 secondi e il punto di cue specificato è 50%, l’evento si attiva alla soglia dei 30 secondi.
- Video Completed: questo evento viene attivato al completamento di un video.
- Video Loaded Metadata: questo evento viene attivato quando il lettore riceve le informazioni iniziali sulla durata e sulla dimensione.
- Video Pause: questo evento viene attivato quando il video viene messo in pausa.
- Video Resume: questo evento viene attivato quando il video viene riavviato dopo essere stato messo in pausa.
- Video Screen Change: l’evento viene attivato quando il video passa alla modalità schermo intero o ne esce.
- Video Start: questo evento viene attivato quando il contenuto video viene avviato per la prima volta.
Utilizzo
È possibile impostare una regola di tag per ogni evento video (i sette eventi elencati sopra). Crea una regola di tag specifica per ogni evento di cui desideri tenere traccia. Se non desideri tenere traccia di un evento, ometti semplicemente di creare una regola per esso.
Le regole prevedono tre azioni:
- Impostare le variabili Adobe Analytics. (Ovvero creare elementi dati per tutti o alcuni degli elementi dati elencati sopra.)
- Inviare il beacon di Adobe Analytics.
- Cancellare le variabili Adobe Analytics.
Esempio di regola tag per “Video Start”
Devono essere inclusi i seguenti oggetti di estensione video:
-
Eventi
- “Video Start”: questo evento causa l’attivazione della regola quando il visitatore avvia la riproduzione di un video BrightCove.
-
Condizione
- Nessuna
-
Azioni
-
In un’azione “Set variables” di Analytics, imposta:
- L’evento per Video Start (ad esempio: event17)
- Una prop/eVar per l’elemento dati Video Name (ad esempio: eVar10)
- Una prop/eVar per l’elemento dati Video Duration (ad esempio: eVar11)
- Una prop/eVar per l’elemento dati Current Video Place (ad esempio: eVar12)
-
L’azione “Send beacon” di Analytics (
s.tl
) -
L’azione “Clear variables” di Analytics
-
var r = [];
r.push( \_satellite.getVar( 'Video ID' ) );
r.push( \_satellite.getVar( 'Video Name' ) );
r.push( \_satellite.getVar( 'Video Duraction' ) );
return r.join('|');