Aller au contenu

Initialisation

Après avoir recueilli le consentement et vérifié canRequestAds, appelez initialize du plugin une seule fois avant de demander des annonces. Vous n’avez pas à démarrer vous-même le SDK natif.

Les identifiants d’application natifs doivent figurer dans AndroidManifest / Info.plist ; consultez Installation.

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

try {
  await AdMob.initialize();
} catch (error) {
  console.error('AdMob initialization failed', error);
  // Ne demandez pas d’annonces pour le moment. Réessayez lorsque la vue native de l’application est disponible.
}

Sur Android, l’initialisation attend aussi la vue parente de la bannière native, même si l’application utilise uniquement des annonces plein écran. Elle est rejetée si l’activité ou la vue de contenu est indisponible, ou si la vue parente n’apparaît pas dans les 5 secondes. Gérez ce rejet pour qu’un échec d’initialisation des annonces n’empêche pas le reste de l’application de démarrer. Vous pouvez réessayer dès que la vue native est disponible.

La résolution de initialize() ne signifie pas qu’une annonce est chargée. Utilisez la méthode de chargement et les événements de chaque format pour vérifier sa disponibilité.

method initialize(...)

Initialise le SDK Google Mobile Ads.

initialize(options?: AdMobInitializationOptions | undefined) => Promise<void>

interface AdMobInitializationOptions

Propriété Type Description Valeur par défaut Depuis
testingDevices string[] Identifiants des appareils à enregistrer comme appareils de test lorsque {@link AdMobInitializationOptions.initializeForTesting} vaut true. Les requêtes provenant des appareils enregistrés reçoivent des annonces de test et ne génèrent pas de trafic incorrect. 1.2.0
initializeForTesting boolean Indique si {@link AdMobInitializationOptions.testingDevices} doit être enregistré comme appareils de test. false 1.2.0
tagForChildDirectedTreatment boolean Pour l’application de la loi américaine Children’s Online Privacy Protection Act (COPPA), un paramètre nommé tagForChildDirectedTreatment est disponible. 3.1.0
tagForUnderAgeOfConsent boolean Lorsque cette fonction est utilisée, un paramètre Tag For Users under the Age of Consent in Europe (TFUA), destiné aux utilisateurs n’ayant pas atteint l’âge du consentement en Europe, est inclus dans toutes les demandes d’annonces suivantes. 3.1.0
maxAdContentRating MaxAdContentRating Classification maximale du contenu publicitaire appliquée à toutes les demandes d’annonces. Les annonces de classification supérieure sont exclues. 3.1.0

Pendant le développement, privilégiez les blocs d’annonces de démonstration de Google. Pour tester des annonces similaires à celles de production sur un appareil physique, enregistrez celui-ci comme décrit dans Tests. Ne livrez pas initializeForTesting: true en production.

Les options propres à une annonce, comme isTesting, npa (annonces non personnalisées) et immersiveMode (masquer les barres système Android pour une annonce plein écran), se définissent sur chaque demande d’annonce, pas sur initialize. Consultez les guides de chaque format.

Recueillez le consentement relatif à la confidentialité avant l’initialisation et le chargement des annonces. Consultez Consentement.