Zum Inhalt springen

App-Open-Anzeigen

App-Open-Anzeigen monetarisieren Ladebildschirme der Anwendung und sollen beim Wechsel der Anwendung in den Vordergrund erscheinen. Der Nutzer kann sie jederzeit schließen. Googles App-Open-Anleitungen für Android und iOS erklären das Format.

Führen Sie dies nach Initialisierung und Einwilligung aus. Laden Sie die Anzeige vorab und prüfen Sie vor dem Anzeigen ihre Verfügbarkeit. Blockieren Sie den Anwendungsstart beim Warten auf eine Anzeige nicht unbegrenzt.

import {
  AdLoadInfo,
  AdMob,
  AdMobRevenueData,
  AppOpenAdOptions,
  AppOpenAdPluginEvents,
} from '@capacitor-community/admob';

await AdMob.addListener(AppOpenAdPluginEvents.Loaded, (info: AdLoadInfo) => {
  console.log('App Open Ad loaded', info.adUnitId);
});
await AdMob.addListener(AppOpenAdPluginEvents.FailedToLoad, console.error);
await AdMob.addListener(AppOpenAdPluginEvents.Opened, () => {
  console.log('App Open Ad open');
});
await AdMob.addListener(AppOpenAdPluginEvents.Closed, () => {
  console.log('App Open Ad close');
});
await AdMob.addListener(AppOpenAdPluginEvents.FailedToShow, console.error);
await AdMob.addListener(AppOpenAdPluginEvents.AdImpression, (data: AdMobRevenueData) => {
  console.log(data);
});

const options: AppOpenAdOptions = {
  adId: 'YOUR_AD_UNIT_ID',
};
const { adUnitId } = await AdMob.loadAppOpen(options);
const { value: isLoaded } = await AdMob.isAppOpenLoaded({ adId: adUnitId });
if (isLoaded) {
  await AdMob.showAppOpen({ adId: adUnitId });
}

method loadAppOpen(...)

Lädt eine App-Open-Anzeige und gibt die Kennung des geladenen Anzeigenblocks zurück.

loadAppOpen(options: AppOpenAdOptions) => Promise<AdLoadInfo>

method isAppOpenLoaded(...)

Prüft, ob eine App-Open-Anzeige geladen ist.

isAppOpenLoaded(options?: AdShowOptions | undefined) => Promise<{ value: boolean; }>

method showAppOpen(...)

Zeigt eine geladene App-Open-Anzeige an.

showAppOpen(options?: AdShowOptions | undefined) => Promise<void>

interface AppOpenAdOptions

Optionen zum Laden einer App-Open-Anzeige.

Eigenschaft Typ Beschreibung
adId string Kennung des zu ladenden App-Open-Anzeigenblocks.

Es gibt kein Flag isTesting. Setzen Sie in der Entwicklung adId auf Googles App-Open-Demo-Anzeigenblock.

Verwenden Sie das Ereignis Closed, um den Anwendungsablauf fortzusetzen und mit dem Laden der nächsten Anzeige zu beginnen.

Ohne adId an showAppOpen() oder isAppOpenLoaded() wird die zuletzt geladene Anzeige verwendet. Die Ereignisliste finden Sie unter Anzeigenereignisse.