Zum Inhalt springen
rdlabo.devdocs

Anzeigenereignisse

Google dokumentiert diese Lebenszykluscallbacks auf der jeweiligen Formatseite, beispielsweise unter Banner-Anzeigenereignisse. Dieses Plugin stellt dieselben Zeitpunkte unter den Namen in der folgenden Tabelle bereit, nicht unter den nativen Methodennamen von AdListener. Umsatznutzdaten beschreibt Anzeigenumsatz je Impression beziehungsweise die iOS-Version.

Registrieren Sie Listener vor dem Laden oder Anzeigen einer Anzeige, damit die ersten Lebenszyklus- und Impressionsereignisse nicht verpasst werden.

Listener hinzufügen und entfernen

AdMob.addListener gibt ein Handle zurück. Warten Sie auf die Registrierung und rufen Sie anschließend remove() auf, wenn der zugehörige Bildschirm zerstört wird:

import { AdMob, BannerAdPluginEvents } from '@capacitor-community/admob';

const handle = await AdMob.addListener(BannerAdPluginEvents.Loaded, () => {
  console.log('Banner loaded');
});

await handle.remove();

interface PluginListenerHandle

Eigenschaft Typ
remove () => Promise<void>

Gemeinsame Lebenszyklusereignisse

Ereignis Wird ausgelöst, wenn
Loaded Die Anzeige fertig geladen und zur Anzeige bereit ist.
FailedToLoad Die Anzeige nicht geladen werden konnte. Einzelheiten stehen in AdMobError.
Showed / Opened Die Anzeige für den Nutzer sichtbar wird.
FailedToShow Eine geladene Anzeige nicht angezeigt werden konnte.
Dismissed / Closed Der Nutzer die Vollbildanzeige oder das Overlay geschlossen hat.
Rewarded Der Nutzer die angekündigte Belohnung verdient hat.
SizeChanged Die Banner-Abmessungen sich geändert haben.
AdImpression / AdPaid Eine Impression aufgezeichnet wurde. Siehe die folgenden Umsatzereignisse.

Fehler

Listener für FailedToLoad und FailedToShow erhalten Nutzdaten vom Typ AdMobError.

interface AdMobError

Ein vom Google Mobile Ads SDK zurückgegebener Fehler.

Eigenschaft Typ Beschreibung
code number Liefert den Fehlercode.
message string Liefert die Meldung, die den Fehler beschreibt.

Umsatz je Impression

Vollbildformate liefern AdMobRevenueData über ihr Ereignis AdImpression. Banner liefern dieselben Nutzdaten über AdPaid. Banner-AdImpression enthält keine Nutzdaten; es meldet nur eine aufgezeichnete Impression.

interface AdMobRevenueData

Von einem bezahlten Anzeigenereignis gelieferte Erlösdaten auf Impressionsebene.

Eigenschaft Typ Beschreibung
adUnitId string Dem bezahlten Anzeigenereignis zugeordnete Anzeigenblockkennung.
valueMicros number Anzeigenwert in Mikros; 1.000.000 Mikros entsprechen einer Währungseinheit.
currencyCode string ISO-4217-Währungscode für valueMicros.
precision AdValuePrecision Genauigkeit des gemeldeten Anzeigenwerts.
networkName string Klassenname des Vermittlungsadapters, der die Impression ausgeliefert hat, oder eine leere Zeichenfolge, wenn er nicht verfügbar ist.
impressionId string Der Impression zugeordnete Antwortkennung oder eine leere Zeichenfolge, wenn sie nicht verfügbar ist.

Anleitungen nach Format

method addListener(AppOpenAdPluginEvents.Loaded, ...)

Registriert einen Listener für das Laden von App-Open-Anzeigen.

addListener(eventName: AppOpenAdPluginEvents.Loaded, listenerFunc: (info: AdLoadInfo) => void) => Promise<PluginListenerHandle>

method addListener(AppOpenAdPluginEvents.FailedToLoad, ...)

Registriert einen Listener für Ladefehler von App-Open-Anzeigen.

addListener(eventName: AppOpenAdPluginEvents.FailedToLoad, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>

method addListener(AppOpenAdPluginEvents.Opened, ...)

Registriert einen Listener für das Öffnen von App-Open-Anzeigen.

addListener(eventName: AppOpenAdPluginEvents.Opened, listenerFunc: () => void) => Promise<PluginListenerHandle>

method addListener(AppOpenAdPluginEvents.Closed, ...)

Registriert einen Listener für das Schließen von App-Open-Anzeigen.

addListener(eventName: AppOpenAdPluginEvents.Closed, listenerFunc: () => void) => Promise<PluginListenerHandle>

method addListener(AppOpenAdPluginEvents.FailedToShow, ...)

Registriert einen Listener für Anzeigefehler von App-Open-Anzeigen.

addListener(eventName: AppOpenAdPluginEvents.FailedToShow, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>

method addListener(AppOpenAdPluginEvents.AdImpression, ...)

Registriert einen Listener für Erlösereignisse auf Impressionsebene bei App-Open-Anzeigen.

addListener(eventName: AppOpenAdPluginEvents.AdImpression, listenerFunc: (data: AdMobRevenueData) => void) => Promise<PluginListenerHandle>

enum AppOpenAdPluginEvents

Mitglied Wert Beschreibung
Loaded 'appOpenAdLoaded' Wird ausgelöst, wenn eine App-Open-Anzeige geladen wurde.
FailedToLoad 'appOpenAdFailedToLoad' Wird ausgelöst, wenn eine App-Open-Anzeige nicht geladen werden kann.
Opened 'appOpenAdOpened' Wird ausgelöst, wenn eine App-Open-Anzeige angezeigt wird.
Closed 'appOpenAdClosed' Wird ausgelöst, wenn eine App-Open-Anzeige geschlossen wird.
FailedToShow 'appOpenAdFailedToShow' Wird ausgelöst, wenn eine geladene App-Open-Anzeige nicht angezeigt werden kann.
AdImpression 'appOpenAdImpression' Liefert Erlösdaten auf Impressionsebene, wenn ein bezahltes Anzeigenereignis erfasst wird.

method addListener(BannerAdPluginEvents.SizeChanged, ...)

Registriert einen Listener für Änderungen der angezeigten Bannerabmessungen.

addListener(eventName: BannerAdPluginEvents.SizeChanged, listenerFunc: (info: AdMobBannerSize) => void) => Promise<PluginListenerHandle>

method addListener(BannerAdPluginEvents.Loaded, ...)

Registriert einen Listener für das Laden von Banneranzeigen.

addListener(eventName: BannerAdPluginEvents.Loaded, listenerFunc: () => void) => Promise<PluginListenerHandle>

method addListener(BannerAdPluginEvents.FailedToLoad, ...)

Registriert einen Listener für Ladefehler von Banneranzeigen.

addListener(eventName: BannerAdPluginEvents.FailedToLoad, listenerFunc: (info: AdMobError) => void) => Promise<PluginListenerHandle>

method addListener(BannerAdPluginEvents.Opened, ...)

Registriert einen Listener für das Öffnen eines Banner-Overlays.

addListener(eventName: BannerAdPluginEvents.Opened, listenerFunc: () => void) => Promise<PluginListenerHandle>

method addListener(BannerAdPluginEvents.Closed, ...)

Registriert einen Listener für das Schließen eines Banner-Overlays.

addListener(eventName: BannerAdPluginEvents.Closed, listenerFunc: () => void) => Promise<PluginListenerHandle>

method addListener(BannerAdPluginEvents.AdImpression, ...)

Registriert einen Listener für Banner-Impressionen.

addListener(eventName: BannerAdPluginEvents.AdImpression, listenerFunc: () => void) => Promise<PluginListenerHandle>

method addListener(BannerAdPluginEvents.AdPaid, ...)

Registriert einen Listener für Erlösereignisse auf Impressionsebene bei Bannern.

addListener(eventName: BannerAdPluginEvents.AdPaid, listenerFunc: (data: AdMobRevenueData) => void) => Promise<PluginListenerHandle>

enum BannerAdPluginEvents

Mitglied Wert Beschreibung
SizeChanged "bannerAdSizeChanged" Wird ausgelöst, wenn sich die Größe des angezeigten Banners ändert.
Loaded "bannerAdLoaded" Wird ausgelöst, wenn eine Banneranzeige geladen wurde.
FailedToLoad "bannerAdFailedToLoad" Wird ausgelöst, wenn eine Banneranzeige nicht geladen werden kann.
Opened "bannerAdOpened" Wird ausgelöst, wenn ein Banner nach einer Berührung durch den Nutzer ein Overlay öffnet.
Closed "bannerAdClosed" Wird ausgelöst, wenn das Banner-Overlay geschlossen wird.
AdImpression "bannerAdImpression" Wird ausgelöst, wenn eine Impression der Banneranzeige erfasst wird.
AdPaid "bannerAdPaid" Liefert Erlösdaten auf Impressionsebene, wenn ein bezahltes Anzeigenereignis erfasst wird.

method addListener(InterstitialAdPluginEvents.FailedToLoad, ...)

Registriert einen Listener für Ladefehler von Interstitial-Anzeigen.

addListener(eventName: InterstitialAdPluginEvents.FailedToLoad, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>

method addListener(InterstitialAdPluginEvents.Loaded, ...)

Registriert einen Listener für das Laden von Interstitial-Anzeigen.

addListener(eventName: InterstitialAdPluginEvents.Loaded, listenerFunc: (info: AdLoadInfo) => void) => Promise<PluginListenerHandle>

method addListener(InterstitialAdPluginEvents.Dismissed, ...)

Registriert einen Listener für das Schließen von Interstitial-Anzeigen.

addListener(eventName: InterstitialAdPluginEvents.Dismissed, listenerFunc: () => void) => Promise<PluginListenerHandle>

method addListener(InterstitialAdPluginEvents.FailedToShow, ...)

Registriert einen Listener für Anzeigefehler von Interstitial-Anzeigen.

addListener(eventName: InterstitialAdPluginEvents.FailedToShow, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>

method addListener(InterstitialAdPluginEvents.Showed, ...)

Registriert einen Listener für die Anzeige von Interstitial-Anzeigen.

addListener(eventName: InterstitialAdPluginEvents.Showed, listenerFunc: () => void) => Promise<PluginListenerHandle>

method addListener(InterstitialAdPluginEvents.AdImpression, ...)

Registriert einen Listener für Erlösereignisse auf Impressionsebene bei Interstitial-Anzeigen.

addListener(eventName: InterstitialAdPluginEvents.AdImpression, listenerFunc: (data: AdMobRevenueData) => void) => Promise<PluginListenerHandle>

enum InterstitialAdPluginEvents

Mitglied Wert Beschreibung
Loaded 'interstitialAdLoaded' Wird ausgelöst, wenn eine Interstitial-Anzeige geladen und zur Anzeige bereit ist.
FailedToLoad 'interstitialAdFailedToLoad' Wird ausgelöst, wenn eine Interstitial-Anzeige nicht geladen werden kann.
Showed 'interstitialAdShowed' Wird ausgelöst, wenn eine Interstitial-Anzeige angezeigt wird.
FailedToShow 'interstitialAdFailedToShow' Wird ausgelöst, wenn eine geladene Interstitial-Anzeige nicht angezeigt werden kann.
Dismissed 'interstitialAdDismissed' Wird ausgelöst, wenn eine Interstitial-Anzeige geschlossen wird.
AdImpression 'interstitialAdImpression' Liefert Erlösdaten auf Impressionsebene, wenn ein bezahltes Anzeigenereignis erfasst wird.

method addListener(RewardAdPluginEvents.FailedToLoad, ...)

Registriert einen Listener für Ladefehler von Rewarded-Anzeigen.

addListener(eventName: RewardAdPluginEvents.FailedToLoad, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>

method addListener(RewardAdPluginEvents.Loaded, ...)

Registriert einen Listener für das Laden von Rewarded-Anzeigen.

addListener(eventName: RewardAdPluginEvents.Loaded, listenerFunc: (info: AdLoadInfo) => void) => Promise<PluginListenerHandle>

method addListener(RewardAdPluginEvents.Rewarded, ...)

Registriert einen Listener für erhaltene Belohnungen.

addListener(eventName: RewardAdPluginEvents.Rewarded, listenerFunc: (reward: AdMobRewardItem) => void) => Promise<PluginListenerHandle>

method addListener(RewardAdPluginEvents.Dismissed, ...)

Registriert einen Listener für das Schließen von Rewarded-Anzeigen.

addListener(eventName: RewardAdPluginEvents.Dismissed, listenerFunc: () => void) => Promise<PluginListenerHandle>

method addListener(RewardAdPluginEvents.FailedToShow, ...)

Registriert einen Listener für Anzeigefehler von Rewarded-Anzeigen.

addListener(eventName: RewardAdPluginEvents.FailedToShow, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>

method addListener(RewardAdPluginEvents.Showed, ...)

Registriert einen Listener für die Anzeige von Rewarded-Anzeigen.

addListener(eventName: RewardAdPluginEvents.Showed, listenerFunc: () => void) => Promise<PluginListenerHandle>

method addListener(RewardAdPluginEvents.AdImpression, ...)

Registriert einen Listener für Erlösereignisse auf Impressionsebene bei Rewarded-Anzeigen.

addListener(eventName: RewardAdPluginEvents.AdImpression, listenerFunc: (data: AdMobRevenueData) => void) => Promise<PluginListenerHandle>

enum RewardAdPluginEvents

Mitglied Wert Beschreibung
Loaded 'onRewardedVideoAdLoaded' Wird ausgelöst, wenn eine Rewarded-Anzeige geladen und zur Anzeige bereit ist.
FailedToLoad 'onRewardedVideoAdFailedToLoad' Wird ausgelöst, wenn eine Rewarded-Anzeige nicht geladen werden kann.
Showed 'onRewardedVideoAdShowed' Wird ausgelöst, wenn eine Rewarded-Anzeige angezeigt wird.
FailedToShow 'onRewardedVideoAdFailedToShow' Wird ausgelöst, wenn eine geladene Rewarded-Anzeige nicht angezeigt werden kann.
Dismissed 'onRewardedVideoAdDismissed' Wird ausgelöst, wenn eine Rewarded-Anzeige geschlossen wird. Dieses Ereignis sagt nicht aus, ob der Nutzer eine Belohnung erhalten hat. Separat auf Rewarded reagieren, bevor die Belohnung gewährt wird.
Rewarded 'onRewardedVideoAdReward' Wird ausgelöst, wenn der Nutzer die angekündigte Belohnung erhält.
AdImpression 'onRewardedVideoAdImpression' Liefert Erlösdaten auf Impressionsebene, wenn ein bezahltes Anzeigenereignis erfasst wird.

method addListener(RewardInterstitialAdPluginEvents.FailedToLoad, ...)

Registriert einen Listener für Ladefehler von Rewarded-Interstitial-Anzeigen.

addListener(eventName: RewardInterstitialAdPluginEvents.FailedToLoad, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>

method addListener(RewardInterstitialAdPluginEvents.Loaded, ...)

Registriert einen Listener für das Laden von Rewarded-Interstitial-Anzeigen.

addListener(eventName: RewardInterstitialAdPluginEvents.Loaded, listenerFunc: (info: AdLoadInfo) => void) => Promise<PluginListenerHandle>

method addListener(RewardInterstitialAdPluginEvents.Rewarded, ...)

Registriert einen Listener für erhaltene Belohnungen.

addListener(eventName: RewardInterstitialAdPluginEvents.Rewarded, listenerFunc: (reward: AdMobRewardInterstitialItem) => void) => Promise<PluginListenerHandle>

method addListener(RewardInterstitialAdPluginEvents.Dismissed, ...)

Registriert einen Listener für das Schließen von Rewarded-Interstitial-Anzeigen.

addListener(eventName: RewardInterstitialAdPluginEvents.Dismissed, listenerFunc: () => void) => Promise<PluginListenerHandle>

method addListener(RewardInterstitialAdPluginEvents.FailedToShow, ...)

Registriert einen Listener für Anzeigefehler von Rewarded-Interstitial-Anzeigen.

addListener(eventName: RewardInterstitialAdPluginEvents.FailedToShow, listenerFunc: (error: AdMobError) => void) => Promise<PluginListenerHandle>

method addListener(RewardInterstitialAdPluginEvents.Showed, ...)

Registriert einen Listener für die Anzeige von Rewarded-Interstitial-Anzeigen.

addListener(eventName: RewardInterstitialAdPluginEvents.Showed, listenerFunc: () => void) => Promise<PluginListenerHandle>

method addListener(RewardInterstitialAdPluginEvents.AdImpression, ...)

Registriert einen Listener für Erlösereignisse auf Impressionsebene bei Rewarded-Interstitial-Anzeigen.

addListener(eventName: RewardInterstitialAdPluginEvents.AdImpression, listenerFunc: (data: AdMobRevenueData) => void) => Promise<PluginListenerHandle>

enum RewardInterstitialAdPluginEvents

Mitglied Wert Beschreibung
Loaded 'onRewardedInterstitialAdLoaded' Wird ausgelöst, wenn eine Rewarded-Interstitial-Anzeige geladen und zur Anzeige bereit ist.
FailedToLoad 'onRewardedInterstitialAdFailedToLoad' Wird ausgelöst, wenn eine Rewarded-Interstitial-Anzeige nicht geladen werden kann.
Showed 'onRewardedInterstitialAdShowed' Wird ausgelöst, wenn eine Rewarded-Interstitial-Anzeige angezeigt wird.
FailedToShow 'onRewardedInterstitialAdFailedToShow' Wird ausgelöst, wenn eine geladene Rewarded-Interstitial-Anzeige nicht angezeigt werden kann.
Dismissed 'onRewardedInterstitialAdDismissed' Wird ausgelöst, wenn eine Rewarded-Interstitial-Anzeige geschlossen wird. Dieses Ereignis sagt nicht aus, ob der Nutzer eine Belohnung erhalten hat. Separat auf Rewarded reagieren, bevor die Belohnung gewährt wird.
Rewarded 'onRewardedInterstitialAdReward' Wird ausgelöst, wenn der Nutzer die angekündigte Belohnung erhält.
AdImpression 'onRewardedInterstitialAdImpression' Liefert Erlösdaten auf Impressionsebene, wenn ein bezahltes Anzeigenereignis erfasst wird.
Diese Seite auf GitHub bearbeiten