Videoanzeigen

Dieses Modul implementiert Interstitial-Videoanzeigen und Belohnungsvideoanzeigen. Lesen Sie die Seite JOGOS_SDK Einführung und die für Ihre Game-Engine relevanten Abschnitte, und verwenden Sie dann die Videoanzeigen-Funktionen wie folgt:

window.JOGOS_SDK.ad;

Werbeanforderungen

Bitte lesen Sie unbedingt unsere Werbeanforderungen, da Ihr Spiel sonst abgelehnt wird, ohne dass Sie eine Rückmeldung erhalten.

Videoanzeigen abspielen anfordern

Wir unterstützen zwei verschiedene Arten von Videoanzeigen: Interstitial-Anzeigen (midgame) und Belohnungsanzeigen (rewarded);

• Interstitial-Anzeigen: Können ausgelöst werden, wenn der Benutzer stirbt, ein Level abschließt oder ähnliche Spielereignisse eintreten.
• Belohnungsanzeigen: Der Benutzer entscheidet sich aktiv, eine Belohnungsanzeige anzusehen, um Belohnungen zu erhalten (zusätzliche Leben, Wiederbelebung beim Tod, zusätzliche Gegenstände, zusätzliche Attribute usw.).

// Callback-Funktionen
const callbacks = {
  // Wird aufgerufen, wenn die Anzeige startet
  onstarted: () => console.log('ad started'),
  // Wird aufgerufen, wenn die Anzeige beendet wird
  onfinished: () => console.log('ad finished'),
  // Wird aufgerufen, wenn ein Fehler auftritt
  onerror: (error) => console.log('ad error:', error),
};

// Interstitial-Anzeige anfordern
window.JOGOS_SDK.ad.requestAd('midgame', callbacks);
// Belohnungsanzeige anfordern
window.JOGOS_SDK.ad.requestAd('rewarded', callbacks);

Hinweise zur Nutzung von Anzeigen

• Interstitial-Anzeigen haben ein Mindestintervall (normalerweise 60 Sekunden). Häufiges Aufrufen löst folgenden Fehler aus: 500 At least a ${time} second interval is required to display new advertisements.

• Belohnungsanzeigen haben ein tägliches Maximum (normalerweise 50 pro Benutzer). Überschreitungen lösen folgenden Fehler aus: 500 You can only watch up to ${max} rewarded ads per day.

• Wir empfehlen, Belohnungsanzeigen-Punkte mit Cooldown-Zeit oder Tageslimit zu gestalten. Sie können auch die folgende Schnittstelle verwenden, um die verbleibende Anzahl der Belohnungsanzeigen des aktuellen Benutzers zu ermitteln und zu entscheiden, ob Sie die Anzeige ausblenden sollten.

const result = await window.JOGOS_SDK.ad.getRewardAdCount();
console.log('Remaining rewardAd count ', result);

Erkennung von Anzeigenblockern

Werbeanforderungen

Unser Spieldesign ermöglicht, dass das Spiel auch mit aktiviertem Anzeigenblocker weiterläuft. Da das Erkennungssystem jedoch Fehlalarme erzeugen kann, empfehlen wir milde Einschränkungen: Nur für Benutzer mit Blocker die zusätzlichen Inhalte einschränken (wie spezielle Skins, zusätzliche Level) und sicherstellen, dass der Benutzer nach Deaktivierung des Blockers einfach die Seite aktualisieren kann, um die vollständige Funktionalität wiederherzustellen.

Verwenden Sie die folgenden Methoden, um zu erkennen, ob der Benutzer einen Anzeigenblocker verwendet:

const result = await window.JOGOS_SDK.ad.hasAdblock();
console.log('Adblock usage fetched', result);