Aller au contenu
rdlabo.devdocs

Annonces à l’ouverture de l’application

Les annonces à l’ouverture monétisent les écrans de chargement de l’application et sont conçues pour s’afficher lorsque l’utilisateur ramène celle-ci au premier plan. Il peut les fermer à tout moment. Les guides Google sur les annonces à l’ouverture pour Android et iOS expliquent ce format.

Appelez cette méthode après l’initialisation et le consentement. Chargez l’annonce à l’avance et confirmez sa disponibilité avant de la présenter. Ne bloquez pas indéfiniment le démarrage de l’application en attendant le chargement d’une annonce.

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(...)

Charge une annonce à l’ouverture de l’application et renvoie l’identifiant du bloc d’annonces chargé.

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

method isAppOpenLoaded(...)

Vérifie si une annonce à l’ouverture de l’application est chargée.

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

method showAppOpen(...)

Affiche une annonce à l’ouverture de l’application déjà chargée.

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

interface AppOpenAdOptions

Options de chargement d’une annonce à l’ouverture de l’application.

Propriété Type Description
adId string Identifiant du bloc d’annonces à l’ouverture de l’application à charger.

Il n’existe pas d’indicateur isTesting ; pendant le développement, définissez adId sur le bloc de démonstration d’annonce à l’ouverture de Google.

Utilisez l’événement Closed pour reprendre le parcours de votre application et commencer à charger l’annonce suivante.

Sans adId passé à showAppOpen() ou isAppOpenLoaded(), l’opération vise l’annonce chargée le plus récemment. Consultez Événements publicitaires pour la liste des événements.

Modifier cette page sur GitHub