Tracciare gli annunci in Roku

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

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 pubblicitaria.

   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 che inizia con 1.	Sì
   startTime	Valore della testina di riproduzione all’inizio dell’interruzione pubblicitaria.	Sì

   ‘ Create an adbreak info object
   adBreakInfo = adb_media_init_adbreakinfo()
   adBreakInfo.name = <ADBREAK_NAME>
   adBreakInfo.startTime = <START_TIME>
   adBreakInfo.position = <POSITION>
   

2. Chiamata trackEvent() con AdBreakStart nell’istanza MediaHeartbeat per iniziare a tracciare l’interruzione pubblicitaria:

   contextData = {}
   ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_START, adBreakInfo, contextData)
   

3. Identifica quando la risorsa dell’annuncio si avvia e crea un’istanza AdObject utilizzando le informazioni sull’annuncio.

   adInfo =
     adb_media_init_adinfo(ad.title,
                           ad.id,
                           ad.position,
                           ad.duration)
   

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

   • Implementare metadati standard di annunci in Roku

   • Metadati degli annunci personalizzati: per i metadati personalizzati, crea un oggetto variabile per le variabili dei dati personalizzate e popola i dati per la risorsa dell’annuncio corrente.

     contextData = {}
     contextData["adinfo1"] = "adinfo2"
     contextData["adinfo2"] = "adinfo2"
     

5. Effettua una chiamata trackEvent() con un evento AdStart nell’istanza MediaHeartbeat per iniziare a tracciare la riproduzione dell’annuncio:

   ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_START, adInfo, contextData)
   

6. Quando la riproduzione della risorsa dell’annuncio raggiunge il termine dell’annuncio, effettua una chiamata trackEvent() con un evento AdComplete.

   standardAdMetadata = {}
   contextData = {}
   ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_COMPLETE, adInfo, contextData)
   

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

   contextData = {}
   ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_SKIP, adInfo, contextData
   

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 dell’annuncio, utilizza l’evento AdBreakComplete per tracciare:

   contextData = {}
   ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_COMPLETE, adBreakInfo, contextData)
   

Per ulteriori informazioni, consulta lo scenario di tracciamento Riproduzione VOD con annunci pre-roll.