Caricare gli annunci pre-roll per il live streaming

Seleziona la piattaforma: HTML5 Android iOS tvOS

L'SDK IMA può essere utilizzata per monetizzare sia i live streaming sia i video on demand. Per i live streaming, devi effettuare una nuova richiesta di annuncio per ogni interruzione pubblicitaria. Scaglionare queste richieste per assicurarti che tutti gli spettatori non richiedano gli annunci contemporaneamente e non sovraccarichino i server pubblicitari.

A questo scopo, l'SDK IMA dispone della proprietà AdsRequest.liveStreamPrefetchSeconds. Questa proprietà specifica il numero massimo di secondi che l'SDK deve attendere prima di contattare l'ad server dopo aver chiamato AdsLoader.requestAds(). L'ora effettiva della richiesta verrà scelta in modo casuale. Ad esempio, se imposti AdsRequest.liveStreamPrefetchSeconds su 30, l'SDK attende da 0 a 30 secondi dopo la chiamata a AdsLoader.requestAds() per effettuare la richiesta al server.

Pre-fetch dei live streaming in pratica

Ti consigliamo di precaricare la pausa pubblicitaria successiva non appena una pausa pubblicitaria termina. In questo modo, la durata massima di tempo è disponibile per la finestra di precaricamento. Supponiamo che tu abbia 5 minuti tra le interruzioni pubblicitarie. Al termine di un'interruzione pubblicitaria, puoi richiedere la successiva con una finestra di precaricamento di 290 secondi (5 minuti meno 10 secondi, per assicurarti che le richieste inviate alla fine della finestra di precaricamento abbiano abbastanza tempo per essere risolte):

Punto chiave: la Guida introduttiva e l' Esempio di base implementano l' estensione Exoplayer-IMA che gestisce la configurazione di AdsManager. Per questo motivo, queste risorse non possono essere utilizzate come punto di partenza per questa guida. Ti consigliamo di utilizzare l'esempio avanzato come punto di partenza per il precaricamento dei live streaming.

Questi snippet di codice mostrano come aggiungere il precaricamento del live streaming all'esempio avanzato, ma l'approccio può essere applicato ad altre implementazioni IMA.

VideoPlayerController.java

/** Ads logic for handling the IMA SDK integration code and events. */
public class VideoPlayerController {

  // 5 minutes == 300 seconds. Include a 10 second buffer
  private float AD_INTERVAL = 290;
  private double AD_TIMEOUT = 300;

...

  adsManager.addAdEventListener(
    new AdEvent.AdEventListener() {
      /** Responds to AdEvents. */
      @Override
      public void onAdEvent(AdEvent adEvent) {

      ...

      case ALL_ADS_COMPLETED:
        if (adsManager != null) {
          adsManager.destroy();
          adsManager = null;
        }

        // When pre-fetching for live streams, be sure to destroy the current AdsManager,
        // in case the tag you requested previously contains post-rolls
        // (you don't want to play those now).

        // Pre-fetch the next ad break.
        // Play those ads in ~5 minutes. In a real-world implementation,
        // this will likely be done as the result of a message from your
        // streaming server, not a through the playAdsAfterThisTime parameter
        // of requestAndPlayAds().
        requestAndPlayAds(AD_TIMEOUT);
        break;
      default:
        break;
      }
  }

...

public void requestAndPlayAds(double playAdsAfterThisTime) {
  if (currentAdTagUrl == null || currentAdTagUrl == "") {
    log("No VAST ad tag URL specified");
    resumeContent();
    return;
  }

  // Since you're switching to a new video, tell the SDK the previous video is finished.
  if (adsManager != null) {
    adsManager.destroy();
  }

  playButton.setVisibility(View.GONE);

  // Create the ads request.
  AdsRequest request = sdkFactory.createAdsRequest();
  request.setAdTagUrl(currentAdTagUrl);
  request.setContentProgressProvider(videoPlayerWithAdPlayback.getContentProgressProvider());
  request.setLiveStreamPrefetchSeconds(AD_INTERVAL);

  playAdsAfterTime = playAdsAfterThisTime;

  // Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.
  adsLoader.requestAds(request);
}