Banner

Dieses Modul ermöglicht die Anzeige und das Entfernen von Banner-Werbung. Nachdem Sie den Abschnitt der Seite Einführung in JOGOS_SDK gelesen haben, der sich auf Ihren Spiele-Engine bezieht, können Sie die entsprechenden Funktionen wie folgt nutzen:

window.JOGOS_SDK.banner;

Anforderungen an die Werbung

Bitte lesen Sie unbedingt unsere Anforderungen an die Werbung, da Ihr Spiel abgelehnt wird, wenn es diese Anforderungen nicht erfüllt, und Sie keine Rückmeldung erhalten werden.

Anzeige eines Banner-Werbeblocks anfordern

Banner-Werbung ist in 5 verschiedenen Größen erhältlich:

• Leaderboard (728x90)
• Mittel (300x250)
• Mobilgerät (320x50)
• Startseite (468x60)
• Großes Mobilgerät (320x100)

Einschränkungen

• Es können gleichzeitig nur 2 Banner-Werbeblöcke unterschiedlicher Größe angezeigt werden.
• Ein Banner-Werbeblock muss an derselben Position 60 Sekunden lang angezeigt werden, bevor er erneut aktualisiert werden kann.
• Wenn ein Banner nicht den oben genannten Regeln und Größen entspricht, wird es wahrscheinlich nicht angezeigt.

Zunächst müssen Sie einen Container für die Banner-Werbung auf dem Bildschirm erstellen. Sie können optional Breite und Höhe angeben:

<div id="banner-container" style="width: 300px; height: 250px"></div>

Verwenden Sie dann die folgende Methode, um die Anzeige der Banner-Werbung anzufordern (achten Sie darauf, dass die id mit der id des Containers übereinstimmen muss):

try {
  await window.JOGOS_SDK.banner.requestBanner('banner-container');
} catch (e) {
  console.log('Banner request error', e);
}

Es können gleichzeitig maximal zwei Banner-Werbeblöcke angezeigt werden. Andernfalls wird eine Ausnahme ausgelöst: '500 At most two banners can be displayed at the same time'.

Wenn Sie diese Methode mit derselben id ausführen, wird die vorhandene Werbung ersetzt. Bei wiederholtem Aufruf innerhalb eines bestimmten Zeitraums (in der Regel 60 Sekunden) wird eine Ausnahme ausgelöst: 500 The time for each call to method requestBanner cannot exceed ${time} seconds.

Bestimmtes Banner entfernen

Verwenden Sie dann die folgende Methode, um das Banner mit der angegebenen id zu entfernen:

await window.JOGOS_SDK.banner.clearBanner('banner-container');

Alle Banner entfernen

Verwenden Sie dann die folgende Methode, um alle Banner zu entfernen:

await window.JOGOS_SDK.banner.clearAllBanners();

Lokale Tests

Bei lokalen Tests werden keine echten Werbebanner angezeigt. Um das endgültige Anzeigeergebnis zu sehen, können Sie Ihr Spiel packen und es in das QA-Tool der Entwicklerplattform hochladen.