Tracciare gli annunci in Roku track-ads-on-roku
Le istruzioni seguenti forniscono indicazioni per l’implementazione tramite gli SDK 2.x.
Costanti di tracciamento degli annunci
AdBreakStartAdBreakCompleteAdStartAdCompleteAdSkipPassaggi di implementazione
-
Identifica quando inizia il limite dell’interruzione dell’annuncio, incluso il pre-roll, e crea un
AdBreakObjectutilizzando 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 nameNome dell’interruzione dell’annuncio come pre-roll, mid-roll e post-roll. Sì positionLa posizione numerica dell’interruzione pubblicitaria che inizia con 1. Sì startTimeValore della testina di riproduzione all’inizio dell’interruzione pubblicitaria. Sì code language-none ‘ Create an adbreak info object adBreakInfo = adb_media_init_adbreakinfo() adBreakInfo.name = <ADBREAK_NAME> adBreakInfo.startTime = <START_TIME> adBreakInfo.position = <POSITION> -
Chiamata
trackEvent()conAdBreakStartnell’istanzaMediaHeartbeatper iniziare a tracciare l’interruzione pubblicitaria:code language-none contextData = {} ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_START, adBreakInfo, contextData) -
Identifica quando la risorsa dell’annuncio si avvia e crea un’istanza
AdObjectutilizzando le informazioni sull’annuncio.code language-none adInfo = adb_media_init_adinfo(ad.title, ad.id, ad.position, ad.duration) -
Facoltativamente, allega metadati standard e/o di annunci alla sessione di tracciamento dei contenuti multimediali tramite variabili di dati di contesto.
-
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"
-
Effettua una chiamata
trackEvent()con un eventoAdStartnell’istanzaMediaHeartbeatper iniziare a tracciare la riproduzione dell’annuncio:code language-none ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_START, adInfo, contextData) -
Quando la riproduzione della risorsa dell’annuncio raggiunge il termine dell’annuncio, effettua una chiamata
trackEvent()con un eventoAdComplete.code language-none standardAdMetadata = {} contextData = {} ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_COMPLETE, adInfo, contextData) -
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 -
Se ci sono annunci aggiuntivi all’interno dello stesso
AdBreak, ripeti di nuovo i passaggi da 3 a 7. -
Al termine dell’interruzione pubblicitaria, utilizza l’evento
AdBreakCompleteper 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.