Initialisierung
Holen Sie zuerst die Einwilligung ein und prüfen Sie canRequestAds. Rufen Sie dann vor dem Anfordern von Anzeigen einmal initialize des Plugins auf. Sie starten das native SDK nicht selbst.
Native Anwendungs-IDs gehören in AndroidManifest / Info.plist. Siehe Installation.
import { AdMob } from '@capacitor-community/admob';
try {
await AdMob.initialize();
} catch (error) {
console.error('AdMob initialization failed', error);
// Fordern Sie vorerst keine Anzeigen an. Versuchen Sie es erneut, sobald die native Ansicht der App verfügbar ist.
}
Unter Android wartet die Initialisierung auch auf die übergeordnete Ansicht des nativen Banners, selbst wenn Ihre App nur Vollbildanzeigen verwendet. Sie wird abgelehnt, wenn die Activity oder Inhaltsansicht nicht verfügbar ist oder die übergeordnete Ansicht nicht innerhalb von 5 Sekunden erscheint. Behandeln Sie diese Ablehnung, damit eine fehlgeschlagene Anzeigeninitialisierung den Start der übrigen App nicht verhindert. Sobald die native Ansicht verfügbar ist, können Sie es erneut versuchen.
Ein erfolgreich abgeschlossenes initialize() bedeutet nicht, dass eine Anzeige geladen wurde. Prüfen Sie die Bereitschaft über die Lademethode und Ereignisse des jeweiligen Formats.
method initialize(...)
Initialisiert das Google Mobile Ads SDK.
initialize(options?: AdMobInitializationOptions | undefined) => Promise<void>
interface AdMobInitializationOptions
| Eigenschaft | Typ | Beschreibung | Standard | Seit |
|---|---|---|---|---|
testingDevices |
string[] |
Geräte-IDs, die als Testgeräte registriert werden, wenn {@link AdMobInitializationOptions.initializeForTesting} true ist. Anfragen von registrierten Geräten erhalten Testanzeigen und erzeugen keinen ungültigen Traffic. |
1.2.0 | |
initializeForTesting |
boolean |
Ob {@link AdMobInitializationOptions.testingDevices} als Testgeräte registriert werden sollen. | false | 1.2.0 |
tagForChildDirectedTreatment |
boolean |
Für die Anforderungen des Children’s Online Privacy Protection Act (COPPA) gibt es die Einstellung tagForChildDirectedTreatment. | 3.1.0 | |
tagForUnderAgeOfConsent |
boolean |
Bei Verwendung dieser Funktion wird allen zukünftigen Anzeigenanfragen ein TFUA-Parameter für Nutzer unterhalb des europäischen Einwilligungsalters hinzugefügt. | 3.1.0 | |
maxAdContentRating |
MaxAdContentRating |
Maximale Inhaltsbewertung für alle Anzeigenanfragen. Anzeigen mit einer höheren Bewertung werden ausgeschlossen. | 3.1.0 |
Bevorzugen Sie in der Entwicklung Googles Demo-Anzeigenblöcke. Registrieren Sie zum Testen produktionsnaher Anzeigen auf einem physischen Gerät dieses Gerät wie unter Tests beschrieben. Verwenden Sie initializeForTesting: true nicht in Produktion.
Anzeigenspezifische Optionen wie isTesting, npa für nicht personalisierte Anzeigen und immersiveMode zum Ausblenden der Android-Systemleisten bei einer Vollbildanzeige werden für jede Anzeigenanfrage gesetzt, nicht an initialize. Siehe die Anleitungen der jeweiligen Formate.
Holen Sie die Datenschutzeinwilligung vor der Initialisierung und dem Laden von Anzeigen ein. Siehe Einwilligung.