Tracciare gli annunci in Roku track-ads-on-roku

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

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

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 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.
    position La posizione numerica dell’interruzione pubblicitaria che inizia con 1.
    startTime Valore della testina di riproduzione all’inizio dell’interruzione pubblicitaria.
    code language-none
    ‘ 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:

    code language-none
    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.

    code language-none
    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.

      code language-none
      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:

    code language-none
    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.

    code language-none
    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.

    code language-none
    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 pubblicitaria, utilizza l’evento AdBreakComplete per tracciare:

    code language-none
    contextData = {}
    ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_COMPLETE, adBreakInfo, contextData)
    

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

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb