Rastrear anúncios no iOS

As instruções a seguir fornecem orientação para a implementação usando os SDKs 2.x.

Constantes de rastreamento do anúncio

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.

Recursos do Business.Adobe.com