Zum Inhalt springen
rdlabo.devdocs

Tests

Verwenden Sie während der Entwicklung Testanzeigen, damit Sie Anzeigen anklicken können, ohne Werbetreibende zu belasten oder das Konto wegen ungültiger Zugriffe markieren zu lassen. Googles Testanzeigen-Anleitungen für Android und iOS erklären Demo-Anzeigenblöcke und Testgeräte.

Dieses Plugin kann diese Demo-Anzeigenblöcke anfordern oder ein Gerät über initialize registrieren.

Demo-Anzeigenblöcke

Google stellt Demo-Anzeigenblöcke bereit, die immer Testanzeigen zurückgeben. Bevorzugen Sie diese während der Entwicklung. Dieses Plugin unterstützt ausschließlich natives iOS und Android. Verwenden Sie die passende Plattform-ID.

Banner-Demo-Anzeigenblöcke dieses Plugins und seiner Demo:

Plattform Banner-adId
Android ca-app-pub-3940256099942544/6300978111
iOS ca-app-pub-3940256099942544/2934735716

Demo-IDs anderer Formate stehen in den oben verlinkten Google-Testanzeigen-Anleitungen. Sie können außerdem isTesting: true für Banner-, Interstitial-, belohnte und belohnte Interstitial-Anfragen setzen. App-Open-Anzeigen besitzen keine Option isTesting; übergeben Sie einen Demo-Anzeigenblock als adId.

Testgeräte

Registrieren Sie das Gerät mit AdMob.initialize(), um auf einem physischen Gerät produktionsnahe Anzeigen anzufordern, ohne ungültige Zugriffe zu erzeugen:

await AdMob.initialize({
  testingDevices: ['YOUR_TEST_DEVICE_ID'],
  initializeForTesting: true,
});

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

Suchen Sie die Geräte-ID nach der ersten Anzeigenanfrage in den nativen Protokollen:

  • Android: Logcat, üblicherweise unter dem Tag Ads (Use RequestConfiguration.Builder.setTestDeviceIds(...)).
  • iOS: Xcode-Konsole (To get test ads on this device, set:).

Siehe Googles Anleitung zum Aktivieren von Testgeräten.

Debug-Region für die Einwilligung

Setzen Sie auf einem realen Gerät debugGeography und nehmen Sie die Geräte-ID in testDeviceIdentifiers auf. EEA lässt das Formular so reagieren, als befände sich das Gerät im Europäischen Wirtschaftsraum, damit Sie DSGVO-Nachrichten testen können. Verwenden Sie dies ausschließlich auf registrierten Testgeräten.

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

const consentInfo = await AdMob.requestConsentInfo({
  debugGeography: AdmobConsentDebugGeography.EEA,
  testDeviceIdentifiers: ['YOUR_TEST_DEVICE_ID'],
});

method requestConsentInfo(...)

Informationen zur Einwilligung des Nutzers anfordern

requestConsentInfo(options?: AdmobConsentRequestOptions | undefined) => Promise<AdmobConsentInfo>

interface AdmobConsentRequestOptions

Eigenschaft Typ Beschreibung Standard Seit
debugGeography AdmobConsentDebugGeography Legt die Debug-Geografie fest, um die Einwilligung lokal zu testen. 5.0.0
testDeviceIdentifiers string[] Ein Array zulässiger Testgeräte-IDs. Hinweis: Unter iOS kann die ID nach einer Deinstallation und Neuinstallation der App erneuert werden. 5.0.0
tagForUnderAgeOfConsent boolean Auf true setzen, um dem Nutzer die Möglichkeit zu geben, der Anzeige personalisierter Werbung zuzustimmen. false 5.0.0

enum AdmobConsentDebugGeography

Mitglied Wert Beschreibung
DISABLED 0 Debug-Geografie deaktiviert.
EEA 1 Die geografische Zuordnung wird für Debug-Geräte als innerhalb des EWR dargestellt.
NOT_EEA 2 Die geografische Zuordnung wird für Debug-Geräte als außerhalb des EWR dargestellt.
US 3 Die geografische Zuordnung wird für Debug-Geräte als regulierter US-Bundesstaat dargestellt.
OTHER 4 Die geografische Zuordnung wird für Debug-Geräte als OTHER dargestellt.

Wenn Sie im Testformular die Einwilligung ablehnen (Manage → Confirm Choices), werden möglicherweise keine Anzeigen geladen. Dies ist in einer Testumgebung zu erwarten und sagt nichts über das Produktionsverhalten nach einer Nutzereinwilligung aus.

resetConsentInfo() ist ausschließlich für Tests bestimmt. Siehe Einwilligung.

Serverseitige Verifizierung

Callbacks der serverseitigen Verifizierung (SSV) werden ausschließlich für Produktionsanzeigen ausgelöst. Testanzeigen rufen Ihren SSV-Endpunkt nicht auf. Ein Beispiel für eine simulierte Anfrage finden Sie unter Belohnte Anzeigen.

Diese Seite auf GitHub bearbeiten