Rastrear anúncios no Roku

IMPORTANTE

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.

    • Implementar Metadados de publicidade padrão no Roku

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

Nesta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now