Rastrear anúncios no iOS

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
ADBMediaHeartbeatEventAdBreakStart Constante para rastrear o evento AdBreak Start
ADBMediaHeartbeatEventAdBreakComplete Constante para rastrear o evento AdBreak Complete
ADBMediaHeartbeatEventAdStart Constante para rastrear o evento Ad Start
ADBMediaHeartbeatEventAdComplete Constante para rastrear o evento Ad Complete
ADBMediaHeartbeatEventAdSkip 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 no conteúdo, começando com 1. Sim
    startTime Valor do indicador de reprodução no início do ad break. Sim

    Criação do objeto Ad break:

    id adBreakObject = [ADBMediaHeartbeat createAdBreakObjectWithName:[ADBREAK_NAME] 
                                position:[POSITION]  
                                startTime:[START_TIME]];
    
  2. Chame trackEvent() com AdBreakStart na instância MediaHeartbeat para começar a rastrear o ad break:

    - (void)onAdBreakStart:(NSNotification *)notification { 
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakStart  
                         mediaObject:adBreakObject  
                         data:nil]; 
    }
    
  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 Descrição Obrigatório
    name Nome amigável do anúncio. Sim
    adId Identificador exclusivo para o anúncio. Sim
    position A posição do número do anúncio no ad break, começando com 1. Sim
    length Duração do anúncio Sim

    Criação do objeto de anúncio:

    id adObject = [ADBMediaHeartbeat createAdObjectWithName:[AD_NAME] 
                                     adId:[AD_ID] 
                                     position:[POSITION] 
                                     length:[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.

    • Implementar Metadados de publicidade padrão no iOS

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

      NSMutableDictionary *adDictionary = [[NSMutableDictionary alloc] init]; 
      [adDictionary setObject:@"Sample affiliate" forKey:@"affiliate"]; 
      [adDictionary setObject:@"Sample campaign" forKey:@"campaign"]; 
      [adDictionary setObject:@"Sample creative" forKey:@"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:

    - (void)onAdStart:(NSNotification *)notification { 
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart  
                         mediaObject:adObject  
                         data:adDictionary]; 
    }
    
  6. Quando a reprodução atingir o fim do anúncio, chame trackEvent() com o evento AdComplete.

    - (void)onAdComplete:(NSNotification *)notification { 
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdComplete  
                         mediaObject:nil  
                         data:nil]; 
    }
    
  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.

    - (void)onAdSkip:(NSNotification *)notification { 
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdSkip  
                         mediaObject:nil  
                         data:nil]; 
    }
    
  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:

    - (void)onAdBreakComplete:(NSNotification *)notification { 
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakComplete  
                         mediaObject:nil  
                         data:nil]; 
    }
    

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 Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
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