Aller au contenu
rdlabo.devdocs

Événements publicitaires

Google documente ces callbacks de cycle de vie sur la page de chaque format, par exemple événements des bannières. Ce plugin expose les mêmes étapes sous les noms du tableau ci-dessous, et non sous les noms des méthodes natives d’AdListener. Pour la charge utile des revenus, consultez Revenus publicitaires par impression (iOS).

Enregistrez les écouteurs avant de charger ou d’afficher une annonce pour ne pas manquer les premiers événements de cycle de vie et d’impression.

Ajouter et supprimer des écouteurs

AdMob.addListener renvoie un handle. Attendez l’enregistrement, puis appelez remove() lorsque l’écran qui le possède est détruit :

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

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

await handle.remove();

interface PluginListenerHandle

Propriété Type
remove () => Promise<void>

Événements de cycle de vie communs

Événement Émis lorsque
Loaded L’annonce a fini de se charger et est prête à être affichée.
FailedToLoad L’annonce n’a pas pu se charger. Consultez AdMobError pour les détails.
Showed / Opened L’annonce est devenue visible pour l’utilisateur.
FailedToShow Une annonce chargée n’a pas pu s’afficher.
Dismissed / Closed L’utilisateur a fermé l’annonce plein écran ou la superposition.
Rewarded L’utilisateur a obtenu la récompense annoncée.
SizeChanged Les dimensions de la bannière ont changé.
AdImpression / AdPaid Une impression a été enregistrée. Consultez les événements de revenus ci-dessous.

Erreurs

Les écouteurs FailedToLoad et FailedToShow reçoivent une charge utile AdMobError.

interface AdMobError

Erreur renvoyée par le SDK Google Mobile Ads.

Propriété Type Description
code number Obtient le code de l’erreur.
message string Obtient le message décrivant l’erreur.

Revenus par impression

Les formats plein écran émettent AdMobRevenueData via leur événement AdImpression. Les bannières émettent la même charge utile via AdPaid. L’événement AdImpression des bannières ne contient pas de charge utile ; il signale seulement l’enregistrement d’une impression.

interface AdMobRevenueData

Données de revenus publicitaires par impression émises par un événement de paiement.

Propriété Type Description
adUnitId string Identifiant du bloc d’annonces associé à l’événement de paiement.
valueMicros number Valeur de l’annonce en micros ; 1 000 000 de micros équivaut à une unité de devise.
currencyCode string Code de devise ISO 4217 pour valueMicros.
precision AdValuePrecision Précision de la valeur publicitaire signalée.
networkName string Nom de la classe de l’adaptateur de médiation qui a servi l’impression, ou chaîne vide s’il est indisponible.
impressionId string Identifiant de réponse associé à l’impression, ou chaîne vide s’il est indisponible.

Guides par format

method addListener(AppOpenAdPluginEvents.Loaded, ...)

Écoute les événements de chargement des annonces à l’ouverture de l’application.

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

method addListener(AppOpenAdPluginEvents.FailedToLoad, ...)

Écoute les échecs de chargement des annonces à l’ouverture de l’application.

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

method addListener(AppOpenAdPluginEvents.Opened, ...)

Écoute les événements d’ouverture des annonces à l’ouverture de l’application.

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

method addListener(AppOpenAdPluginEvents.Closed, ...)

Écoute les événements de fermeture des annonces à l’ouverture de l’application.

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

method addListener(AppOpenAdPluginEvents.FailedToShow, ...)

Écoute les échecs d’affichage des annonces à l’ouverture de l’application.

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

method addListener(AppOpenAdPluginEvents.AdImpression, ...)

Écoute les événements de revenus par impression des annonces à l’ouverture de l’application.

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

enum AppOpenAdPluginEvents

Membre Valeur Description
Loaded 'appOpenAdLoaded' Émis lorsqu’une annonce à l’ouverture de l’application est chargée.
FailedToLoad 'appOpenAdFailedToLoad' Émis lorsque le chargement d’une annonce à l’ouverture de l’application échoue.
Opened 'appOpenAdOpened' Émis lorsqu’une annonce à l’ouverture de l’application est affichée.
Closed 'appOpenAdClosed' Émis lorsqu’une annonce à l’ouverture de l’application est fermée.
FailedToShow 'appOpenAdFailedToShow' Émis lorsque l’affichage d’une annonce à l’ouverture de l’application déjà chargée échoue.
AdImpression 'appOpenAdImpression' Émet les données de revenus publicitaires par impression lorsqu’un événement de paiement est enregistré.

method addListener(BannerAdPluginEvents.SizeChanged, ...)

Écoute les changements de dimensions de la bannière affichée.

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

method addListener(BannerAdPluginEvents.Loaded, ...)

Écoute les événements de chargement des bannières publicitaires.

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

method addListener(BannerAdPluginEvents.FailedToLoad, ...)

Écoute les échecs de chargement des bannières publicitaires.

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

method addListener(BannerAdPluginEvents.Opened, ...)

Écoute les événements d’ouverture de l’overlay des bannières.

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

method addListener(BannerAdPluginEvents.Closed, ...)

Écoute les événements de fermeture de l’overlay des bannières.

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

method addListener(BannerAdPluginEvents.AdImpression, ...)

Écoute les événements d’impression des bannières.

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

method addListener(BannerAdPluginEvents.AdPaid, ...)

Écoute les événements de revenus par impression des bannières.

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

enum BannerAdPluginEvents

Membre Valeur Description
SizeChanged "bannerAdSizeChanged" Émis lorsque la taille de la bannière affichée change.
Loaded "bannerAdLoaded" Émis lorsqu’une bannière publicitaire est chargée.
FailedToLoad "bannerAdFailedToLoad" Émis lorsque le chargement d’une bannière publicitaire échoue.
Opened "bannerAdOpened" Émis lorsqu’une bannière ouvre un overlay après un appui de l’utilisateur.
Closed "bannerAdClosed" Émis lorsque l’overlay de la bannière est fermé.
AdImpression "bannerAdImpression" Émis lorsqu’une impression est enregistrée pour la bannière publicitaire.
AdPaid "bannerAdPaid" Émet les données de revenus publicitaires par impression lorsqu’un événement de paiement est enregistré.

method addListener(InterstitialAdPluginEvents.FailedToLoad, ...)

Écoute les échecs de chargement des annonces interstitielles.

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

method addListener(InterstitialAdPluginEvents.Loaded, ...)

Écoute les événements de chargement des annonces interstitielles.

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

method addListener(InterstitialAdPluginEvents.Dismissed, ...)

Écoute les événements de fermeture des annonces interstitielles.

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

method addListener(InterstitialAdPluginEvents.FailedToShow, ...)

Écoute les échecs d’affichage des annonces interstitielles.

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

method addListener(InterstitialAdPluginEvents.Showed, ...)

Écoute les événements d’affichage des annonces interstitielles.

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

method addListener(InterstitialAdPluginEvents.AdImpression, ...)

Écoute les événements de revenus par impression des annonces interstitielles.

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

enum InterstitialAdPluginEvents

Membre Valeur Description
Loaded 'interstitialAdLoaded' Émis lorsqu’une annonce interstitielle est chargée et prête à être affichée.
FailedToLoad 'interstitialAdFailedToLoad' Émis lorsque le chargement d’une annonce interstitielle échoue.
Showed 'interstitialAdShowed' Émis lorsqu’une annonce interstitielle est affichée.
FailedToShow 'interstitialAdFailedToShow' Émis lorsque l’affichage d’une annonce interstitielle déjà chargée échoue.
Dismissed 'interstitialAdDismissed' Émis lorsqu’une annonce interstitielle est fermée.
AdImpression 'interstitialAdImpression' Émet les données de revenus publicitaires par impression lorsqu’un événement de paiement est enregistré.

method addListener(RewardAdPluginEvents.FailedToLoad, ...)

Écoute les échecs de chargement des annonces récompensées.

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

method addListener(RewardAdPluginEvents.Loaded, ...)

Écoute les événements de chargement des annonces récompensées.

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

method addListener(RewardAdPluginEvents.Rewarded, ...)

Écoute les événements d’attribution d’une récompense.

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

method addListener(RewardAdPluginEvents.Dismissed, ...)

Écoute les événements de fermeture des annonces récompensées.

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

method addListener(RewardAdPluginEvents.FailedToShow, ...)

Écoute les échecs d’affichage des annonces récompensées.

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

method addListener(RewardAdPluginEvents.Showed, ...)

Écoute les événements d’affichage des annonces récompensées.

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

method addListener(RewardAdPluginEvents.AdImpression, ...)

Écoute les événements de revenus par impression des annonces récompensées.

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

enum RewardAdPluginEvents

Membre Valeur Description
Loaded 'onRewardedVideoAdLoaded' Émis lorsqu’une annonce récompensée est chargée et prête à être affichée.
FailedToLoad 'onRewardedVideoAdFailedToLoad' Émis lorsque le chargement d’une annonce récompensée échoue.
Showed 'onRewardedVideoAdShowed' Émis lorsqu’une annonce récompensée est affichée.
FailedToShow 'onRewardedVideoAdFailedToShow' Émis lorsque l’affichage d’une annonce récompensée déjà chargée échoue.
Dismissed 'onRewardedVideoAdDismissed' Émis lorsqu’une annonce récompensée est fermée. Cet événement ne précise pas si l’utilisateur a obtenu une récompense. Écoutez séparément Rewarded avant d’attribuer la récompense.
Rewarded 'onRewardedVideoAdReward' Émis lorsque l’utilisateur obtient la récompense annoncée.
AdImpression 'onRewardedVideoAdImpression' Émet les données de revenus publicitaires par impression lorsqu’un événement de paiement est enregistré.

method addListener(RewardInterstitialAdPluginEvents.FailedToLoad, ...)

Écoute les échecs de chargement des annonces interstitielles récompensées.

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

method addListener(RewardInterstitialAdPluginEvents.Loaded, ...)

Écoute les événements de chargement des annonces interstitielles récompensées.

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

method addListener(RewardInterstitialAdPluginEvents.Rewarded, ...)

Écoute les événements d’attribution d’une récompense.

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

method addListener(RewardInterstitialAdPluginEvents.Dismissed, ...)

Écoute les événements de fermeture des annonces interstitielles récompensées.

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

method addListener(RewardInterstitialAdPluginEvents.FailedToShow, ...)

Écoute les échecs d’affichage des annonces interstitielles récompensées.

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

method addListener(RewardInterstitialAdPluginEvents.Showed, ...)

Écoute les événements d’affichage des annonces interstitielles récompensées.

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

method addListener(RewardInterstitialAdPluginEvents.AdImpression, ...)

Écoute les événements de revenus par impression des annonces interstitielles récompensées.

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

enum RewardInterstitialAdPluginEvents

Membre Valeur Description
Loaded 'onRewardedInterstitialAdLoaded' Émis lorsqu’une annonce interstitielle récompensée est chargée et prête à être affichée.
FailedToLoad 'onRewardedInterstitialAdFailedToLoad' Émis lorsque le chargement d’une annonce interstitielle récompensée échoue.
Showed 'onRewardedInterstitialAdShowed' Émis lorsqu’une annonce interstitielle récompensée est affichée.
FailedToShow 'onRewardedInterstitialAdFailedToShow' Émis lorsque l’affichage d’une annonce interstitielle récompensée déjà chargée échoue.
Dismissed 'onRewardedInterstitialAdDismissed' Émis lorsqu’une annonce interstitielle récompensée est fermée. Cet événement ne précise pas si l’utilisateur a obtenu une récompense. Écoutez séparément Rewarded avant d’attribuer la récompense.
Rewarded 'onRewardedInterstitialAdReward' Émis lorsque l’utilisateur obtient la récompense annoncée.
AdImpression 'onRewardedInterstitialAdImpression' Émet les données de revenus publicitaires par impression lorsqu’un événement de paiement est enregistré.
Modifier cette page sur GitHub