Panoramica

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

IMPORTANTE

Se implementi una versione 1.x dell'SDK, puoi scaricare le guide per sviluppatori 1.x qui: Scaricare gli SDK.

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

Eventi del lettore

All'avvio dell'interruzione dell'annuncio

NOTA

Incluso pre-roll

  • Crea un'istanza di oggetto adBreak per l'interruzione pubblicitaria. Ad esempio, adBreakObject.

  • Chiama trackEvent per iniziare l'interruzione dell'annuncio con il tuo adBreakObject.

A ogni avvio di risorse pubblicitarie

  • Crea un'istanza di oggetto annuncio per la risorsa annuncio. Ad esempio, adObject.
  • Compila i metadati dell’annuncio, adCustomMetadata.
  • Chiama trackEvent per l'inizio dell'annuncio.

A ogni annuncio completato

  • Chiama trackEvent per completare l'annuncio.

On ad salto

  • Chiama trackEvent per il salto dell'annuncio.

Interruzione annuncio completata

  • Chiama trackEvent per completare l'interruzione pubblicitaria.

Implementare il tracciamento degli annunci

Costanti di tracciamento degli annunci

Nome costante Descrizione
AdBreakStart Costante per il tracciamento dell'evento di avvio AdBreak
AdBreakComplete Costante per il tracciamento dell’evento AdBreak Complete
AdStart Costante per il tracciamento dell’evento Ad Start
AdComplete Costante per il tracciamento dell’evento Ad Complete
AdSkip Costante per il tracciamento dell’evento Ad Skip

Passaggi di implementazione

  1. Identifica quando inizia il limite di interruzione dell'annuncio, incluso il pre-roll, e crea un AdBreakObject utilizzando le informazioni di interruzione dell'annuncio.

    AdBreakObject riferimento:

    Nome variable Descrizione Obbligatorio
    name Nome dell’interruzione dell’annuncio come pre-roll, mid-roll e post-roll.
    position La posizione numerica dell’interruzione pubblicitaria all’interno del contenuto, a partire da 1.
    startTime Valore della testina di riproduzione all'inizio dell'interruzione pubblicitaria.
  2. Chiama trackEvent() con AdBreakStart nell'istanza MediaHeartbeat per iniziare a tracciare l'interruzione pubblicitaria.

  3. Identifica quando l'annuncio inizia e crea un'istanza AdObject utilizzando le informazioni dell'annuncio.

    AdObject riferimento:

    Nome variable Descrizione Obbligatorio
    name Nome descrittivo dell'annuncio.
    adId Identificatore univoco per l'annuncio.
    position La posizione numerica dell’annuncio all’interno dell’interruzione pubblicitaria, a partire da 1.
    length Lunghezza annuncio
  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 di annunci, crea un dizionario di coppie di valori chiave degli annunci standard utilizzando le chiavi per la piattaforma.
    • Metadati di annunci personalizzati - Per i metadati personalizzati, crea un oggetto variabile per le variabili di dati personalizzate e compila i dati per l’annuncio corrente.
  5. Chiama 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 raggiunge la fine dell’annuncio, invoca trackEvent() con l’evento AdComplete .

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

  8. Se sono presenti annunci aggiuntivi all'interno dello stesso AdBreak, ripeti nuovamente i passaggi da 3 a 7.

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

IMPORTANTE

Assicurati di NON incrementare la testina di riproduzione del lettore di contenuti (l:event:playhead) durante la riproduzione dell'annuncio (s:asset:type=ad). In questo caso, le metriche Content Time Spent (Tempo contenuto trascorso) saranno influenzate negativamente.

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);
};

In questa pagina