Tracciare gli annunci utilizzando JavaScript 3.x track-ads-on-javascript
Le istruzioni seguenti forniscono indicazioni per l’implementazione utilizzando gli SDK 3.x.
Costanti di tracciamento degli annunci
AdBreakStart
AdBreakComplete
AdStart
AdComplete
AdSkip
Passaggi di implementazione
-
Identifica quando inizia il limite dell’interruzione dell’annuncio, incluso il pre-roll, e crea un
AdBreakObject
utilizzando le informazioni sull’interruzione dell’annuncio.Specifihe di
AdBreakObject
:table 0-row-3 1-row-3 2-row-3 3-row-3 Nome variabile Tipo Descrizione name
stringa Stringa non vuota che denota il nome dell’interruzione (pre-roll, mid-roll e post-roll). position
numero La posizione numerica dell’interruzione pubblicitaria che inizia con 1. startTime
numero Valore della testina di riproduzione all’inizio dell’interruzione pubblicitaria. Creazione dell’oggetto di interruzione annuncio:
code language-js var adBreakObject = ADB.Media.createAdBreakObject(<ADBREAK_NAME>, <POSITION>, <START_TIME>);
-
Chiamata
trackEvent()
conAdBreakStart
nell’istanzaMediaHeartbeat
per iniziare a tracciare l’interruzione pubblicitaria:code language-js tracker.trackEvent(ADB.Media.Event.AdBreakStart, adBreakObject);
-
Identifica quando inizia l’annuncio e crea un’istanza
AdObject
utilizzando le informazioni sull’annuncio.Specifihe di
AdObject
:table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 Nome variabile Tipo Descrizione name
stringa Stringa non vuota che denota il nome dell’annuncio. adId
stringa Stringa non vuota che denota l’identificatore dell’annuncio. position
numero La posizione numerica dell’annuncio all’interno dell’interruzione, partendo da 1. length
numero Numero positivo che indica la lunghezza dell’annuncio. Creazione di oggetti annuncio:
code language-js var adObject = ADB.Media.createAdObject.createAdObject(<AD_NAME>, <AD_ID>, <POSITION>, <LENGTH>);
-
(Facoltativo) Allega metadati standard e/o di annunci alla sessione di tracciamento dei contenuti multimediali tramite variabili di dati di contesto.
-
Implementazione dei metadati standard di annunci in JavaScript
-
Metadati degli annunci personalizzati - Per i metadati personalizzati, crea un oggetto variabile per le variabili di dati personalizzate e compila i dati per l’annuncio corrente:
code language-js /* Set context data */ // Standard metadata keys provided by adobe. adMetadata[ADB.Media.AdMetadataKeys] ="Sample Advertiser"; adMetadata[ADB.Media.AdMetadataKeys] = "Sample Campaign"; // Custom metadata keys adMetadata["affiliate"] = "Sample affiliate"; adMetadata["campaign"] = "Sample ad campaign"; adMetadata["creative"] = "Sample creative";
-
-
Chiamata
trackEvent()
con l’eventoAdStart
nell’istanzaMediaHeartbeat
per iniziare a tracciare la riproduzione dell’annuncio.Includi un riferimento alla variabile di metadati personalizzata (o a un oggetto vuoto) come terzo parametro nella chiamata dell’evento:
code language-js _onAdStart = function() { tracker.trackEvent(ADB.Media.Event.AdStart, adObject, adMetadata); };
-
Quando la riproduzione dell’annuncio raggiunge la fine dell’annuncio, chiama
trackEvent()
con l’eventoAdComplete
:code language-js _onAdComplete = function() { tracker.trackEvent(ADB.Media.Event.AdComplete); };
-
Se la riproduzione dell’annuncio non è stata completata perché l’utente ha scelto di saltare l’annuncio, tieni traccia dell’evento
AdSkip
:code language-js _onAdSkip = function() { tracker.trackEvent(ADB.Media.Event.AdSkip); };
-
Se ci sono annunci aggiuntivi all’interno dello stesso
AdBreak
, ripeti di nuovo i passaggi da 3 a 7. -
Al termine dell’interruzione pubblicitaria, utilizza l’evento
AdBreakComplete
per tracciare:code language-js _onAdBreakComplete = function() { tracker.trackEvent(ADB.Media.Event.AdBreakComplete); };
Per ulteriori informazioni, consulta lo scenario di tracciamento Riproduzione VOD con annunci pre-roll.
Tracciamento granulare degli annunci
L'intervallo di ping predefinito dell'annuncio è 10 seconds
.
È possibile impostare il tracciamento granulare degli annunci per abilitare il tracciamento degli annunci 1 second
.
Sintassi
ADB.Media.MediaObjectKey = {
GranularAdTracking: "media.granularadtracking"
}
Esempio
var mediaObject = ADB.Media.createMediaObject("media-name", "media-id", 60, ADB.Media.StreamType.VOD, ADB.Media.MediaType.Video);
// Enable granular ad tracking
mediaObject[ADB.Media.MediaObjectKey.GranularAdTracking] = true;
tracker.trackSessionStart(mediaObject);