Panoramica

Le istruzioni seguenti forniscono indicazioni per l’implementazione tramite gli SDK 2.x.

La riproduzione degli annunci include il tracciamento delle interruzioni, gli avvii, i completamenti e i salti degli annunci. Utilizza l’API del lettore multimediale per identificare gli eventi chiave del lettore e popolare le variabili di annuncio obbligatorie e facoltative. Vedi l’elenco completo dei metadati qui: Parametri annuncio.

Eventi del lettore

All’avvio dell’interruzione dell’annuncio

• Crea un’istanza dell’oggetto adBreak per l’interruzione dell’annuncio. Ad esempio, adBreakObject.

• Esegui la chiamata trackEvent per l’avvio dell’annuncio con adBreakObject.

A ogni avvio di risorse annuncio

• Crea un’istanza di oggetto annuncio per la risorsa annuncio. Ad esempio, adObject.
• Popola i metadati dell’annuncio, adCustomMetadata.
• Esegui la chiamata trackEvent per l’avvio dell’annuncio.

A ogni annuncio completato

• Esegui la chiamata trackEvent per l’annuncio completato.

Al salto dell’annuncio

• Esegui la chiamata trackEvent per il salto dell’annuncio.

All’interruzione annuncio completata

• Esegui la chiamata trackEvent per l’interruzione annuncio completata.

Implementare il tracciamento degli annunci

Costanti di tracciamento degli annunci

Passaggi di implementazione

1. 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:

   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 all’interno del contenuto, a partire da 1.	Sì
   startTime	Valore della testina di riproduzione all’inizio dell’interruzione pubblicitaria.	Sì

2. Esegui la chiamata trackEvent() con AdBreakStart nell’istanza MediaHeartbeat per iniziare a tracciare l’interruzione dell’annuncio.

3. Identifica quando inizia l’annuncio e crea un’istanza AdObject utilizzando le informazioni sull’annuncio.

   Specifihe di AdObject:

   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ì

4. Facoltativamente, allega metadati standard e/o di annunci alla sessione di tracciamento tramite variabili di dati di contesto.

   • Metadati degli annunci standard: per i metadati standard degli annunci, crea un dizionario di coppie di valori chiave di annunci standard utilizzando le chiavi per la piattaforma.
   • Metadati degli annunci personalizzati: per i metadati personalizzati, crea un oggetto variabile per le variabili di dati personalizzate e popolalo con i dati dell’annuncio corrente.

5. Esegui la chiamata trackEvent() con l’evento AdStart nell’istanza MediaHeartbeat 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.

6. Quando la riproduzione dell’annuncio ne raggiunge la fine, esegui la chiamata trackEvent() con l’evento AdComplete.

7. Se la riproduzione dell’annuncio non è stata completata perché l’utente ha scelto di saltarlo, traccia l’evento AdSkip.

8. Se ci sono annunci aggiuntivi all’interno dello stesso AdBreak, ripeti di nuovo i passaggi da 3 a 7.

9. Al termine dell’interruzione pubblicitaria, utilizza l’evento AdBreakComplete per tracciarla.

Il codice di esempio seguente utilizza l’SDK JavaScript 2.x per un lettore multimediale HTML5.

/* Call on ad break start */

if (e.type == "ad break start") {
    var adBreakObject = MediaHeartbeat.createAdBreakObject("mid-roll", 2, 500);
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakObject);
};

/* Call on ad start */
if (e.type == "ad start") {
    var adObject = MediaHeartbeat.createAdObject("PepsiOne", "123456ab", 1, 30);
    /* Set custom context data */
    var adCustomMetadata = {
        affiliate:"Sample affiliate",
        campaign:"Sample ad campaign",
        creative:"Sample creative"
    }
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adObject, adCustomMetadata);
};

/* Call on ad complete */
if (e.type == "ad complete") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdComplete);
};

/* Call on ad skip */
if (e.type == "ad skip") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdSkip);
};

/* Call on ad break complete */
if (e.type == "ad break complete") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete);
};