Interstitial-Anzeigen
Interstitial-Anzeigen sind Vollbildanzeigen, die die Host-Anwendung überdecken. Zeigen Sie sie an einem natürlichen Übergang, beispielsweise zwischen Aktivitäten oder Spielleveln. Der Nutzer kann die Anzeige anklicken oder schließen und zur Anwendung zurückkehren. Googles Interstitial-Anleitungen für Android und iOS erklären das Format.
Verwenden Sie ein Interstitial, wenn der Nutzer keine Belohnung innerhalb der Anwendung erhalten soll. Führen Sie dies nach Initialisierung und Einwilligung aus. Bereiten Sie die Anzeige rechtzeitig vor, registrieren Sie Listener zuerst und zeigen Sie sie erst bei Bereitschaft an.
import { AdLoadInfo, AdMob, AdMobRevenueData, AdOptions, InterstitialAdPluginEvents } from '@capacitor-community/admob';
await AdMob.addListener(InterstitialAdPluginEvents.Loaded, (info: AdLoadInfo) => {
console.log('Interstitial loaded', info.adUnitId);
});
await AdMob.addListener(InterstitialAdPluginEvents.FailedToLoad, console.error);
await AdMob.addListener(InterstitialAdPluginEvents.AdImpression, (data: AdMobRevenueData) => {
console.log(data);
});
const options: AdOptions = {
adId: 'YOUR_AD_UNIT_ID',
// isTesting: true,
// npa: true,
// immersiveMode: true,
};
const { adUnitId } = await AdMob.prepareInterstitial(options);
await AdMob.showInterstitial({ adId: adUnitId });
method prepareInterstitial(...)
Lädt eine Interstitial-Anzeige und gibt die Kennung des geladenen Anzeigenblocks zurück.
prepareInterstitial(options: AdOptions) => Promise<AdLoadInfo>
method showInterstitial(...)
Zeigt eine geladene Interstitial-Anzeige an.
showInterstitial(options?: AdShowOptions | undefined) => Promise<void>
interface AdOptions
Gemeinsame Optionen zum Anfordern einer Anzeige.
| Eigenschaft | Typ | Beschreibung | Standard | Seit |
|---|---|---|---|---|
adId |
string |
Kennung des zu ladenden Anzeigenblocks. | 1.1.2 | |
isTesting |
boolean |
Ob eine Testanzeige angefordert werden soll. | false | 1.1.2 |
margin |
number |
Bannerabstand in logischen Anzeigeeinheiten (dp unter Android und Punkte unter iOS). Bei BOTTOM_CENTER ist dies der untere Abstand, bei TOP_CENTER der obere. |
0 | 1.1.2 |
npa |
boolean |
Ob nicht personalisierte Anzeigen angefordert werden sollen. | false | 1.2.0 |
immersiveMode |
boolean |
Ob eine Vollbildanzeige unter Android im immersiven Modus angezeigt werden soll. | 7.0.3 |
Ohne adId an showInterstitial() wird die zuletzt vorbereitete Anzeige gezeigt.
Mehrere Anzeigen vorbereiten
await AdMob.prepareInterstitial({ adId: 'ca-app-pub-xxx/interstitial-1' });
await AdMob.prepareInterstitial({ adId: 'ca-app-pub-xxx/interstitial-2' });
await AdMob.showInterstitial({ adId: 'ca-app-pub-xxx/interstitial-1' });
Informationen zu isTesting finden Sie unter Tests.
Ereignisse für Laden, Anzeigen, Schließen und Fehlschlag stehen unter Anzeigenereignisse.