Panoramica dell’estensione di tracciamento di video YouTube
Prerequisiti
Per ogni proprietà tag in Adobe Experience Platform, le seguenti estensioni devono essere installate e configurate dalla schermata Estensioni:
- Adobe Analytics
- Servizio ID visitatore di Experience Cloud
- Estensione core
Utilizza lo snippet di codice riportato nella sezione sull’incorporamento di un player con i tag <iframe>, nella documentazione per sviluppatori di Google, nell’HTML di ogni pagina web in cui deve essere eseguito il rendering di un lettore video.
Con la versione 2.0.1 di questa estensione è possibile incorporare uno o più video YouTube in una singola pagina web inserendo un attributo id
con valore univoco nel tag di script iframe e aggiungendo enablejsapi=1
e rel=0
alla fine del valore dell’attributo src
, se non già incluso. Esempio:
<iframe id="player1" width="560" height="315" src="https://www.youtube.com/embed/xpatB77BzYE?enablejsapi=1" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
Questa estensione è progettata anche per verificare dinamicamente la presenza di un valore di attributo ID univoco, come player1
, a prescindere dalla presenza di parametri di stringhe di query enablejsapi
e rel
e dalla corretteza dei rispettivi valori previsti. Di conseguenza, il tag di script di YouTube può essere aggiunto a una pagina web con o senza l’attributo id
e a prescindere dall’inclusione dei parametri della stringa di query enablejsapi
e rel
.
Per riscrivere l’iFrame, l’estensione si basa sulla seguente logica:
document.onreadystatechange = function () {
if (document.readyState === 'complete') {
Di conseguenza, si verificherà un leggero sfarfallio dopo il caricamento della pagina. Si tratta di un comportamento previsto.
Elementi dati
All’interno dell’estensione sono disponibili sei elementi dati, nessuno dei quali richiede la configurazione.
- Posizione testina di riproduzione: registra la posizione in secondi della testina di riproduzione sulla timeline del video, quando viene richiamato all’interno di una regola di tag.
- ID video: specifica l’ID YouTube associato al video.
- Nome video: specifica il nome descrittivo del video.
- URL video: restituisce l’URL YouTube.com del video attualmente caricato/riprodotto.
- Durata video: registra la durata totale in secondi dei contenuti video.
- Versione estensione: questo elemento dati registra la versione dell’estensione di tracciamento di YouTube, ad esempio “Video Tracking_YouTube_2.0.0”.
Eventi
Nell’estensione sono disponibili otto eventi; solo Tracciamento punto di cue personalizzato richiede la configurazione.
- Disponibilità video: si attiva quando il video viene codificato ed è pronto per essere riprodotto.
- Inizio video: si attiva quando il video viene avviato per la prima volta e quando
player.getCurrentTime() === 0
- Ripetizione video: si attiva quando il video viene codificato e riprodotto dopo l’avvio iniziale. Questo trigger si attiva a ogni ripetizione.
- Pausa video: si attiva quando il video viene messo in pausa.
- Ripresa video: si attiva quando si riprende la riproduzione del video e quando
player.getCurrentTime() !== 0
- Tracciamento punto di cue personalizzato: questo evento viene attivato quando il video raggiunge la percentuale di soglia video specificata. Ad esempio, se per un video di 60 secondi viene specificato un punto di cue al 50%, l’evento si attiva quando la posizione della testina di riproduzione arriva a 30 secondi. Il tracciamento del punto di cue si applica sia alla riproduzione iniziale che alla ripetizione. Se l’utente fa scorrere la testina di riproduzione passando per il punto di cue, l’evento non si attiva. Gli eventi per un punto di cue vengono attivati solo quando l’indicatore di riproduzione attraversa la posizione calcolata sulla timeline mentre il lettore video è in fase di riproduzione.
- Buffer video: viene attivato quando il lettore scarica una determinata quantità di dati prima che di iniziare a riprodurre il video.
- Video terminato: si attiva quando un video viene completato del tutto.
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:
- Imposta variabili: imposta le variabili Adobe Analytics (mappa tutti o alcuni elementi di dati inclusi).
- Invia beacon: invia il beacon Adobe Analytics come chiamata di tracciamento dei collegamenti personalizzata e specifica un valore “Nome collegamento”.
- Cancella variabili: cancella le variabili Adobe Analytics.
Esempio di regola di tag per “Video Start”
Devono essere inclusi i seguenti oggetti di estensione video.
-
Eventi: “Inizio video” (questo evento causa l’attivazione della regola quando il visitatore avvia un video YouTube).
-
Condizione: nessuna
-
Azioni: Utilizza l’estensione Analytics per impostare le variabili, per mappare:
- l’evento per Inizio video;
- una prop/eVar per l’elemento dati Durata video;
- una prop/eVar per l’elemento dati ID video;
- un prop/eVar per l’elemento dati Nome video;
- una prop/eVar per l’elemento dati URL video.
Quindi, includi l’azione “Invia beacon” (
s.tl
) con il nome del collegamento “video start”, seguita dall’azione “Cancella variabili”.
Per concatenare i valori delle informazioni video, crea un nuovo elemento di dati denominato “Video Meta Data” e programmalo per richiamare e assemblare tutti gli elementi dati video (elencati sopra). Esempio:
var r = [];
r.push('YouTube'); //Player Name
r.push(_satellite.getVar('Video ID'));
r.push(_satellite.getVar('Video Name'));
r.push(_satellite.getVar('Video Duration'));
r.push(_satellite.getVar('Extension Version'));
return r.join('|');