Tracciare annunci su Roku

IMPORTANTE

Le istruzioni seguenti forniscono indicazioni per l’implementazione mediante gli SDK 2.x. Se stai implementando una versione 1.x dell’SDK, puoi scaricare le guide per sviluppatori 1.x qui: Scaricare gli SDK.

Costanti di tracciamento annunci

Nome costante Descrizione
AdBreakStart Costante per il tracciamento dell’evento AdBreak Start
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. Identificate quando inizia il limite di interruzione annuncio, incluso il pre-roll, e create un’interruzione AdBreakObject utilizzando le informazioni di interruzione annuncio.

    AdBreakObject riferimento:

    Nome della variabile Descrizione Obbligatorio
    name Nome dell’interruzione dell’annuncio come pre-roll, mid-roll e post-roll.
    position La posizione del numero dell’interruzione annuncio che inizia con 1.
    startTime Valore dell’indicatore di riproduzione all’inizio dell’interruzione dell’annuncio.
    ‘ Create an adbreak info object 
    adBreakInfo = adb_media_init_adbreakinfo() 
    adBreakInfo.name = <ADBREAK_NAME> 
    adBreakInfo.startTime = <START_TIME> 
    adBreakInfo.position = <POSITION>
    
  2. Chiama trackEvent() con AdBreakStart nell’ MediaHeartbeat istanza per iniziare a monitorare l’interruzione dell’annuncio:

    contextData = {} 
    ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_START, adBreakInfo, contextData)
    
  3. Identifica quando inizia la risorsa dell’annuncio e crea un’ AdObject istanza utilizzando le informazioni dell’annuncio.

    adInfo =  
      adb_media_init_adinfo(ad.title,  
                            ad.id,  
                            ad.position,  
                            ad.duration) 
    
  4. Se necessario, allegate metadati standard e/o di annunci alla sessione di tracciamento dei supporti tramite le variabili dei dati contestuali.

    • Implementazione di metadati di annunci standard su Roku

    • Metadati annuncio personalizzati - Per i metadati personalizzati, create un oggetto variabile per le variabili di dati personalizzate e inserite i dati per la risorsa annuncio corrente:

      contextData = {} 
      contextData["adinfo1"] = "adinfo2" 
      contextData["adinfo2"] = "adinfo2"
      
  5. Chiamate trackEvent() con l’ AdStart evento nell’ MediaHeartbeat istanza per iniziare a monitorare la riproduzione dell’annuncio:

    ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_START, adInfo, contextData)
    
  6. Quando la riproduzione della risorsa annuncio raggiunge la fine dell’annuncio, chiama trackEvent() con l’ AdComplete evento.

    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 saltare l’annuncio, tieni traccia dell’ AdSkip evento:

    contextData = {} 
    ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_SKIP, adInfo, contextData
    
  8. Se ci sono altri annunci all’interno dello stesso AdBreak, ripeti di nuovo i passaggi da 3 a 7.

  9. Al termine dell’interruzione dell’annuncio, utilizzate l’ AdBreakComplete evento per tenere traccia:

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

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

In questa pagina