Rastrear anúncios no iOS track-ads-on-ios
As instruções a seguir fornecem orientação para a implementação usando os SDKs 2.x.
Constantes de rastreamento do anúncio
ADBMediaHeartbeatEventAdBreakStartADBMediaHeartbeatEventAdBreakCompleteADBMediaHeartbeatEventAdStartADBMediaHeartbeatEventAdCompleteADBMediaHeartbeatEventAdSkipEtapas da implementação
-
Identifique o início do limite do ad break, incluindo o anúncio precedente, e crie um
AdBreakObjectusando as informações do ad break.AdBreakObjectreferência:table 0-row-3 1-row-3 2-row-3 3-row-3 3-align-center 7-align-center 11-align-center 15-align-center Nome da variável Descrição Obrigatório nameNome do ad break, como precedente, intermediário e posterior. Sim positionA posição do número do ad break no conteúdo, começando com 1. Sim startTimeValor do indicador de reprodução no início do ad break. Sim Criação do objeto Ad break:
code language-none id adBreakObject = [ADBMediaHeartbeat createAdBreakObjectWithName:[ADBREAK_NAME] position:[POSITION] startTime:[START_TIME]]; -
Chame
trackEvent()comAdBreakStartna instânciaMediaHeartbeatpara começar a rastrear o ad break:code language-none - (void)onAdBreakStart:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakStart mediaObject:adBreakObject data:nil]; } -
Identifique o início do anúncio e crie uma instância
AdObjectusando as informações do anúncio.AdObjectreferência:table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center Nome da variável Descrição Obrigatório nameNome amigável do anúncio. Sim adIdidentificador exclusivo para o anúncio. Sim positionA posição do número do anúncio no ad break, começando com 1. Sim lengthDuração do anúncio Sim Criação do objeto de anúncio:
code language-none id adObject = [ADBMediaHeartbeat createAdObjectWithName:[AD_NAME] adId:[AD_ID] position:[POSITION] length:[LENGTH]]; -
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:
code language-none NSMutableDictionary *adDictionary = [[NSMutableDictionary alloc] init]; [adDictionary setObject:@"Sample affiliate" forKey:@"affiliate"]; [adDictionary setObject:@"Sample campaign" forKey:@"campaign"]; [adDictionary setObject:@"Sample creative" forKey:@"creative"];
-
Chame
trackEvent()com o eventoAdStartna instânciaMediaHeartbeatpara 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:
code language-none - (void)onAdStart:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart mediaObject:adObject data:adDictionary]; } -
Quando a reprodução atingir o fim do anúncio, chame
trackEvent()com o eventoAdComplete.code language-none - (void)onAdComplete:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdComplete mediaObject:nil data:nil]; } -
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.code language-none - (void)onAdSkip:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdSkip mediaObject:nil data:nil]; } -
Se houver algum anúncio adicional em um mesmo
AdBreak, repita novamente as etapas 3 a 7. -
O ad break está concluído, use o evento
AdBreakCompletepara rastrear:code language-none - (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.