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 antes da exibição, durante a exibição e depois da exibição. 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 do anúncio. Sim positionA posição do número do anúncio no ad break, começando com 1. Sim lengthComprimento 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.