Precaricamento dei live streaming

L'SDK IMA può essere utilizzato per monetizzare i live streaming e i video on demand. Per i live streaming, devi effettuare una nuova richiesta di annuncio per ogni interruzione pubblicitaria. Distribuite queste richieste in più scaglioni per evitare che tutti gli spettatori lo facciano contemporaneamente gli annunci e il traffico degli ad server.

Per aiutarti, l'SDK IMA include l'AdsRequest.liveStreamPrefetchSeconds proprietà. Questa proprietà specifica il numero massimo di secondi in cui l'SDK devi attendere prima di contattare l'ad server dopo la chiamata AdsLoader.requestAds(). L'ora effettiva della richiesta verrà casuale. Per Ad esempio, se imposti AdsRequest.liveStreamPrefetchSeconds su 30, l'SDK attende da 0 a 30 secondi dopo la chiamata a AdsLoader.requestAds() per inviare la richiesta al server.

Precaricamento del live streaming in pratica

Ti consigliamo di precaricare la tua prossima interruzione pubblicitaria non appena viene completata. In questo modo ti assicuri che sia disponibile il periodo di tempo massimo per la finestra di precaricamento. Supponiamo che trascorri 5 minuti tra un'interruzione pubblicitaria e l'altra. Quando viene completata un'interruzione pubblicitaria, puoi richiedere la prossima interruzione pubblicitaria con una finestra di precaricamento di 290 secondi (5 minuti meno 10 secondi, per garantire che le richieste inviate alla fine la finestra di precaricamento abbia tempo sufficiente per risolversi):

// 5 minutes == 300 seconds. Include a 10 second buffer
var AD_INTERVAL = 290;

function onAdEvent(adEvent) {
  var ad = adEvent.getAd();
  switch(adEvent.type) {
    case google.ima.AdEvent.Type.ALL_ADS_COMPLETED:
      // Pre-fetch our next ad break.
      requestAds();
      // Play those ads in 5 minutes. In a real-world implementation,
      // this is likely done as the result of a message from your
      // streaming server, not a timeout.
      setTimeout(playAds, AD_INTERVAL * 1000);// Convert to ms.
  }
}

function requestAds() {
  // Destroy the current AdsManager, in case the tag you requested previously
  // contains post-rolls (don't play those now).
  if (adsManager) {
    adsManager.destroy();
  }
  // Your AdsLoader will be set up on page-load. You should re-use the same
  // AdsLoader for every request. For more info on setting up the AdsLoader,
  // see the "Get Started" guide in the prerequisites above.
  if (adsLoader) {
    // Reset the IMA SDK.
    adsLoader.contentComplete();
  }
  var adsRequest = new google.ima.AdsRequest();
  adsRequest.adTagUrl = '...';
  adsRequest.linearAdSlotWidth = <linear_width>;
  adsRequest.linearAdSlotHeight = <linear_height>;
  adsRequest.nonLinearAdSlotWidth = <nonlinear_width>;
  adsRequest.nonLinearAdSlotHeight = <nonlinear_height>;
  adsRequest.liveStreamPrefechSeconds = AD_INTERVAL;
  adsLoader.requestAds(adsRequest);
}

function playAds() {
  adsManager.init(
      <linear_width>,  <linear_height>, google.ima.ViewMode.NORMAL);
  adsManager.start();
}