Das IMA SDK kann sowohl zur Monetarisierung von Livestreams als auch von Video-on-Demand-Inhalten verwendet werden. Bei Livestreams müssen Sie für jede Werbeunterbrechung eine neue Anzeigenanfrage stellen. Staffel diese Anfragen, damit nicht alle Zuschauer gleichzeitig Anzeigen anfordern und die Ad-Server überlasten.
Das IMA SDK bietet hierfür das Attribut AdsRequest.liveStreamPrefetchSeconds. Mit dieser Property wird die maximale Anzahl von Sekunden angegeben, die das SDK warten soll, bevor es den Ad-Server kontaktiert, nachdem Sie AdsLoader.requestAds() aufgerufen haben. Die tatsächliche Anfragezeit wird zufällig festgelegt. Wenn Sie AdsRequest.liveStreamPrefetchSeconds beispielsweise auf 30 festlegen, wartet das SDK nach dem Aufrufen von AdsLoader.requestAds() zwischen 0 und 30 Sekunden, bevor die Anfrage an den Server gesendet wird.
Livestream-Prefetch in der Praxis
Wir empfehlen, die nächste Werbeunterbrechung vorab abzurufen, sobald eine Werbeunterbrechung abgeschlossen ist. So wird sichergestellt, dass für das Prefetch-Fenster die maximal mögliche Zeitspanne zur Verfügung steht. Angenommen, zwischen den Werbeunterbrechungen liegen 5 Minuten. Wenn eine Werbeunterbrechung abgeschlossen ist, können Sie die nächste Werbeunterbrechung mit einem Prefetch-Zeitfenster von 290 Sekunden anfordern (5 Minuten minus 10 Sekunden, damit die am Ende des Prefetch-Zeitfensters gesendeten Anfragen genügend Zeit für die Verarbeitung haben):
// 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 IMA HTML5 client-side "Set up the IMA SDK" guide:
// https://developers.google.com/interactive-media-ads/docs/sdks/html5/client-side/get-started
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>);
adsManager.start();
}