Mit dem IMA SDK können sowohl Livestreams als auch On-Demand-Videos monetarisiert werden. Bei Livestreams müssen Sie für jede Werbeunterbrechung eine neue Anzeigenanfrage stellen. Verteilen Sie diese Anfragen, damit nicht alle Betrachter gleichzeitig Anzeigen anfordern und die Ad-Server zum Stillstand bringen.
Das IMA SDK unterstützt Sie dabei mit der Property AdsRequest.liveStreamPrefetchSeconds
. Diese Eigenschaft gibt die maximale Anzahl von Sekunden an, die das SDK warten soll, bevor es nach dem Aufruf von AdsLoader.requestAds()
eine Anfrage an den Ad-Server schickt. Die tatsächliche Anfragezeit wird zufällig festgelegt. Wenn Sie beispielsweise AdsRequest.liveStreamPrefetchSeconds
auf 30 setzen, wartet das SDK nach dem Aufruf von AdsLoader.requestAds()
0 bis 30 Sekunden, um die Anfrage an den Server zu senden.
Livestream-Prefetch in der Praxis
Wir empfehlen, die nächste Werbeunterbrechung vorab abzurufen, sobald eine Werbeunterbrechung abgeschlossen ist. Dadurch wird die maximale Zeitdauer sichergestellt, die für Ihr Prefetch-Fenster verfügbar ist. Angenommen, du hast zwischen den Werbeunterbrechungen fünf Minuten Zeit. Wenn eine Werbeunterbrechung abgeschlossen ist, kannst du die nächste Werbeunterbrechung mit einem Prefetch-Fenster von 290 Sekunden (5 Minuten minus 10 Sekunden) anfordern, damit die Anfragen, die am Ende des Prefetch-Fensters gesendet werden, genügend Zeit zum Verarbeiten 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 "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();
}