Aller au contenu
rdlabo.devdocs

Tests

Utilisez des annonces de test pendant le développement pour pouvoir cliquer sur les annonces sans facturer les annonceurs ni risquer de signaler du trafic incorrect sur le compte. Les guides Google sur les annonces de test pour Android et iOS expliquent les blocs de démonstration et les appareils de test.

Ce plugin peut demander ces blocs de démonstration ou enregistrer un appareil via initialize.

Blocs d’annonces de démonstration

Google fournit des blocs d’annonces de démonstration qui renvoient toujours des annonces de test. Privilégiez-les pendant le développement. Ce plugin prend en charge uniquement iOS et Android natifs — utilisez l’identifiant correspondant à la plateforme.

Blocs de démonstration de bannières utilisés par ce plugin et sa démonstration :

Plateforme adId de la bannière
Android ca-app-pub-3940256099942544/6300978111
iOS ca-app-pub-3940256099942544/2934735716

Les identifiants de démonstration des autres formats figurent dans les guides Google sur les annonces de test cités ci-dessus. Vous pouvez aussi définir isTesting: true sur les demandes de bannières, d’interstitielles, d’annonces récompensées et d’interstitielles récompensées. Les annonces à l’ouverture n’ont pas d’option isTesting ; passez un bloc de démonstration dans adId.

Appareils de test

Pour demander des annonces similaires à celles de production sur un appareil physique sans générer de trafic incorrect, enregistrez l’appareil avec AdMob.initialize() :

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

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

Trouvez l’identifiant de l’appareil dans les journaux natifs après la première demande d’annonce :

  • Android : Logcat, généralement avec le tag Ads (Use RequestConfiguration.Builder.setTestDeviceIds(...)).
  • iOS : console Xcode (To get test ads on this device, set:).

Consultez le guide Google Activer les appareils de test.

Géographie de débogage du consentement

Sur un appareil réel, définissez debugGeography et ajoutez son identifiant dans testDeviceIdentifiers. EEA fait fonctionner le formulaire comme si l’appareil se trouvait dans l’Espace économique européen, afin de tester les messages RGPD. Utilisez cette option uniquement sur les appareils de test enregistrés.

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

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

method requestConsentInfo(...)

Demande les informations de consentement de l’utilisateur

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

interface AdmobConsentRequestOptions

Propriété Type Description Valeur par défaut Depuis
debugGeography AdmobConsentDebugGeography Définit la simulation géographique de débogage pour tester le consentement en local. 5.0.0
testDeviceIdentifiers string[] Tableau des identifiants d’appareils de test à autoriser. Remarque : sur iOS, l’identifiant peut changer si vous désinstallez puis réinstallez l’application. 5.0.0
tagForUnderAgeOfConsent boolean Définissez la valeur sur true pour offrir à l’utilisateur la possibilité d’accepter l’affichage d’annonces personnalisées. false 5.0.0

enum AdmobConsentDebugGeography

Membre Valeur Description
DISABLED 0 Simulation géographique de débogage désactivée.
EEA 1 Simule une localisation dans l’EEE pour les appareils de débogage.
NOT_EEA 2 Simule une localisation hors de l’EEE pour les appareils de débogage.
US 3 Simule une localisation dans un État américain réglementé pour les appareils de débogage.
OTHER 4 Simule la zone géographique OTHER pour les appareils de débogage.

Si vous refusez le consentement dans le formulaire de test (Manage → Confirm Choices), les annonces peuvent ne pas se charger. Ce comportement est attendu en environnement de test et ne préjuge pas du comportement en production après le consentement d’un utilisateur.

resetConsentInfo() est réservé aux tests. Consultez Consentement.

Vérification côté serveur

Les callbacks de vérification côté serveur (SSV) sont déclenchés uniquement pour les annonces de production. Les annonces de test n’appellent pas votre endpoint SSV. Pour un exemple de demande simulée, consultez Annonces récompensées.

Modifier cette page sur GitHub