Show Menu
TÓPICOS×

Rastrear anúncios no Roku

As instruções a seguir fornecem orientação para a implementação usando os SDKs 2.x. Se estiver implementando uma versão 1.x do SDK, você pode baixar os Guias dos desenvolvedores 1.x aqui: Baixar SDKs.

Constantes de rastreamento do anúncio

Nome da constante
Descrição  
AdBreakStart
Constante para rastrear o evento AdBreak Start
AdBreakComplete
Constante para rastrear o evento AdBreak Complete
AdStart
Constante para rastrear o evento Ad Start
AdComplete
Constante para rastrear o evento Ad Complete
AdSkip
Constante para rastrear o evento Ad Skip

Etapas da implementação

  1. Identifique o início do limite do ad break, incluindo o anúncio precedente, e crie um AdBreakObject usando as informações do ad break.
    AdBreakObject referência:
    Nome da variável
    Descrição
    Obrigatório
    name
    Nome do ad break, como precedente, intermediário e posterior.
    Sim
    position
    A posição do número do ad break, começando com 1.
    Sim
    startTime
    Valor do indicador de reprodução no início do ad break.
    Sim
    ‘ Create an adbreak info object 
    adBreakInfo = adb_media_init_adbreakinfo() 
    adBreakInfo.name = <ADBREAK_NAME> 
    adBreakInfo.startTime = <START_TIME> 
    adBreakInfo.position = <POSITION>
    
    
  2. Chame trackEvent() com AdBreakStart na instância MediaHeartbeat para começar a rastrear o ad break:
    contextData = {} 
    ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_START, adBreakInfo, contextData)
    
    
  3. Identifique o início do ativo de anúncio e crie uma instância AdObject usando as informações do anúncio.
    adInfo =  
      adb_media_init_adinfo(ad.title,  
                            ad.id,  
                            ad.position,  
                            ad.duration) 
    
    
  4. Opcionalmente, anexe metadados padrão e/ou de anúncio à sessão de rastreamento de mídia por meio de variáveis de dados de contexto.
    • Metadados de anúncio personalizados - Para metadados personalizados, crie um objeto de variável para as variáveis de dados personalizadas e preencha com os dados do ativo de anúncio atual:
      contextData = {} 
      contextData["adinfo1"] = "adinfo2" 
      contextData["adinfo2"] = "adinfo2"
      
      
  5. Chame trackEvent() com o evento AdStart na instância MediaHeartbeat para começar a rastrear a reprodução de anúncio:
    ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_START, adInfo, contextData)
    
    
  6. Quando a reprodução do ativo de anúncio atingir o fim do anúncio, chame trackEvent() com o evento AdComplete .
    standardAdMetadata = {} 
    contextData = {} 
    ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_COMPLETE, adInfo, contextData)
    
    
  7. Se a reprodução do anúncio não tiver sido concluída porque o usuário optou por ignorar o anúncio, rastreie o evento AdSkip
    contextData = {} 
    ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_SKIP, adInfo, contextData
    
    
  8. Se houver algum anúncio adicional em um mesmo AdBreak , repita novamente as etapas 3 a 7.
  9. O ad break está concluído, use o evento AdBreakComplete para rastrear:
    contextData = {} 
    ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_COMPLETE, adBreakInfo, contextData)
    
    
Consulte o cenário de rastreamento Reprodução de VOD com anúncios antes da exibição para obter mais informações.