Tracciare gli annunci in JavaScript 2.x track-ads-on-javascript
Le istruzioni seguenti forniscono indicazioni per l’implementazione tramite gli SDK 2.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 3-align-center 7-align-center 11-align-center 15-align-center Nome variabile Descrizione Obbligatorio name
Nome dell’interruzione dell’annuncio come pre-roll, mid-roll e post-roll. Sì position
La posizione numerica dell’interruzione pubblicitaria che inizia con 1. Sì startTime
Valore della testina di riproduzione all’inizio dell’interruzione pubblicitaria. Sì Creazione dell’oggetto di interruzione annuncio:
code language-js var adBreakObject = MediaHeartbeat.createAdBreakObject(<ADBREAK_NAME>, <POSITION>, <START_TIME>);
-
Chiamata
trackEvent()
conAdBreakStart
nell’istanzaMediaHeartbeat
per iniziare a tracciare l’interruzione pubblicitaria:code language-js mediaHeartbeat.trackEvent(MediaHeartbeat.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 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center Nome variabile Descrizione Obbligatorio name
Nome descrittivo dell’annuncio. Sì adId
Identificatore univoco per l’annuncio. Sì position
La posizione numerica dell’annuncio all’interno dell’interruzione pubblicitaria, a partire da 1. Sì length
Lunghezza annuncio Sì Creazione di oggetti annuncio:
code language-js var adObject = MediaHeartbeat.createAdObject(<AD_NAME>, <AD_ID>, <POSITION>, <LENGTH>);
-
Facoltativamente, 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 custom context data */ var adCustomMetadata = { affiliate: "Sample affiliate", campaign: "Sample ad campaign", 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() { this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adObject, adCustomMetadata); };
-
Quando la riproduzione dell’annuncio raggiunge la fine dell’annuncio, chiama
trackEvent()
con l’eventoAdComplete
:code language-js _onAdComplete = function() { this._mediaHeartbeat.trackEvent(MediaHeartbeat.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() { this._mediaHeartbeat.trackEvent(MediaHeartbeat.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() { this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete); };
Per ulteriori informazioni, consulta lo scenario di tracciamento Riproduzione VOD con annunci pre-roll.