Pré-carregar intervalos comerciais para transmissões

Selecione a plataforma: HTML5 Android iOS tvOS

O SDK do IMA pode ser usado para gerar receita com transmissões ao vivo e vídeo on demand. Para transmissões ao vivo, você precisa fazer uma nova solicitação de anúncio para cada intervalo de anúncio. Faça isso para garantir que todos os espectadores não estejam solicitando anúncios ao mesmo tempo e sobrecarregando os servidores de anúncios.

Para ajudar com isso, o SDK do IMA tem a propriedade AdsRequest.liveStreamPrefetchSeconds. Essa propriedade especifica o número máximo de segundos que o SDK deve esperar antes de entrar em contato com o servidor de anúncios depois que você chamar AdsLoader.requestAds(). O horário real da solicitação será aleatório. Por exemplo, se você definir AdsRequest.liveStreamPrefetchSeconds como 30, o SDK vai esperar de 0 a 30 segundos depois que você chamar AdsLoader.requestAds() para fazer a solicitação ao servidor.

Pré-busca de transmissões ao vivo na prática

Recomendamos pré-buscar o próximo intervalo de anúncio assim que um intervalo de anúncio terminar. Isso garante que o período máximo esteja disponível para sua janela de pré-busca. Suponha que você tenha 5 minutos entre os intervalos de anúncio. Quando um intervalo de anúncio é concluído, você pode solicitar o próximo com uma janela de pré-busca de 290 segundos (5 minutos menos 10 segundos, para garantir que as solicitações enviadas no final da janela de pré-busca tenham tempo suficiente para serem resolvidas):

Objective-C


- (void)adsManager:(IMAAdsManager *)adsManager didReceiveAdEvent:(IMAAdEvent *)event {

  ...

  switch (event.type) {

    ...

    case kIMAAdEvent_ALL_ADS_COMPLETED:

      IMAAdsRequest *request = [[IMAAdsRequest alloc]
             initWithAdTagUrl: self.adTagUrl
           adDisplayContainer: self.adDisplayContainer
         avPlayerVideoDisplay: self.avPlayerVideoDisplay
        pictureInPictureProxy: self.pictureInPictureProxy
                  userContext: nil];

      // set a delay between the end of the last ad
      // in the last request, and the first ad from
      // the new request
      Float64 adGap = 30;
      // make sure the request occurs at least five
      // seconds before starting the new set of ads
      request.liveStreamPrefetchSeconds = adGap - 5;
      [self.adsLoader requestAdsWithRequest:request];
      // start new ads after adGap seconds have elapsed
      dispatch_after(dispatch_time(DISPATCH_TIME_NOW, adGap * NSEC_PER_SEC), dispatch_get_main_queue(), ^{
        [adsManager start];
      });

      break;

    ...

  }

  ...

}

Swift

func adsManager(_ adsManager: IMAAdsManager!, didReceive event: IMAAdEvent!) {
  switch event.type {

    ...

    case IMAAdEventType.ALL_ADS_COMPLETED:

      let request = IMAAdsRequest(
        adTagUrl: AdTagUrl,
        adDisplayContainer: adDisplayContainer,
        contentPlayhead: contentPlayhead,
        userContext: nil)

      // set a delay between the end of the last ad
      // in the last request, and the first ad from
      // the new request
      let adGap = 30
      // make sure the request occurs at least five
      // seconds before starting the new set of ads
      request.liveStreamPrefetchSeconds = adGap - 5
      adsLoader.requestAds(with: request)
      // start new ads after adGap seconds have elapsed
      DispatchQueue.main.asyncAfter(deadline: .now() + adGap) {
        adsManager.start()
      }

      break

    ...
  }
}