Show Menu
TÓPICOS×

Rastrear anúncios usando o JavaScript 3.x

As instruções a seguir fornecem orientação para a implementação usando os SDKs 3.x. If you are implementing any previous versions of the SDK, you can download the Developers Guides here: Download 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
    Tipo
    Descrição
    name
    string
    String não vazia que denota o nome adbreak (pre-roll, mid-roll e post-roll).
    position
    número
    A posição do número do ad break, começando com 1.
    startTime
    número
    Valor do indicador de reprodução no início do ad break.
    Criação do objeto Ad break:
    var adBreakObject =
      ADB.Media.createAdBreakObject(<ADBREAK_NAME>,
                                       <POSITION>,
                                       <START_TIME>);
    
    
  2. Chame trackEvent() com AdBreakStart na instância MediaHeartbeat para começar a rastrear o ad break:
    tracker.trackEvent(ADB.Media.Event.AdBreakStart, adBreakObject);
    
    
  3. Identifique o início do anúncio e crie uma instância AdObject usando as informações do anúncio.
    AdObject referência:
    Nome da variável
    Tipo
    Descrição
    name
    string
    String não vazia que denota o nome do anúncio.
    adId
    string
    Não há uma string vazia que denota o identificador de anúncio.
    position
    número
    A posição numérica do anúncio no intervalo, começando com 1.
    length
    número
    Número positivo que indica a duração do anúncio.
    Criação do objeto de anúncio:
    var adObject =
      ADB.Media.createAdObject.createAdObject(<AD_NAME>,
                                    <AD_ID>,
                                    <POSITION>,
                                    <LENGTH>);
    
    
  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 anúncio atual:
      /* Set context data */
      // Standard metadata keys provided by adobe.
      adMetadata[ADB.Media.AdMetadataKeys]  ="Sample Advertiser";
      adMetadata[ADB.Media.AdMetadataKeys] = "Sample Campaign";
      
      // Custom metadata keys
      adMetadata["affiliate"] = "Sample affiliate";
      adMetadata["campaign"] = "Sample ad campaign";
      adMetadata["creative"] = "Sample creative";
      
      
  5. Chame trackEvent() com o evento AdStart na instância MediaHeartbeat para começar a rastrear a reprodução de anúncio.
    Inclua uma referência na variável de metadados personalizada (ou um objeto vazio) como o terceiro parâmetro na chamada de evento:
    _onAdStart = function() {
        tracker.trackEvent(ADB.Media.Event.AdStart, adObject, adMetadata);
    };
    
    
  6. Quando a reprodução atingir o fim do anúncio, chame trackEvent() com o evento AdComplete :
    _onAdComplete = function() {
        tracker.trackEvent(ADB.Media.Event.AdComplete);
    };
    
    
  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
    _onAdSkip = function() {
        tracker.trackEvent(ADB.Media.Event.AdSkip);
    };
    
    
  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:
    _onAdBreakComplete = function() {
        tracker.trackEvent(ADB.Media.Event.AdBreakComplete);
    };
    
    
Consulte o cenário de rastreamento Reprodução de VOD com anúncios antes da exibição para obter mais informações.