Inspecteur d'annonces

L'inspecteur d'annonces est une fonctionnalité en superposition qui permet aux appareils autorisés d'effectuer une analyse en temps réel des demandes d'annonces tests directement dans une application mobile. Il est inclus dans le SDK Google Mobile Ads version 20.0.0 ou ultérieure et peut être activé sans codage.

Avec l'inspecteur d'annonces dans les versions du SDK Mobile Ads antérieures à la version 20.2.0, vous pouvez :

  • Inspecter vos blocs d'annonces
  • Inspecter vos adaptateurs tiers
  • vérifier que vos emplacements d'annonces se remplissent comme prévu ;
  • Identifier les erreurs et afficher des détails sur la façon de les résoudre
  • d'afficher les détails de la médiation pour chaque réseau publicitaire et chaque demande ;
  • Tester des sources d'annonces tierces de médiation
  • Vérifiez que vous avez correctement configuré chaque bloc d'annonces pour la médiation en cascade
  • Tester les intégrations d'événements personnalisés

Pour le SDK Mobile Ads 20.2.0 ou version ultérieure, vous pouvez également :

  • Afficher les détails des enchères pour chaque réseau publicitaire par demande
  • Afficher ensemble les détails des enchères et de la médiation en cascade pour chaque réseau publicitaire et chaque demande
  • Tester des sources d'annonces de médiation ou d'enchères tierces spécifiques

  • Vérifiez que vous avez correctement configuré chaque bloc d'annonces pour les enchères et la médiation en cascade.

Ce guide explique comment lancer et utiliser les différentes fonctionnalités de l'inspecteur d'annonces.

Prérequis

Pour utiliser l'inspecteur d'annonces, vous devez :

  • Utilisez le SDK Google Mobile Ads version 20.0.0 ou ultérieure.

Lancer l'outil d'inspection des annonces

Vous pouvez lancer l'inspecteur d'annonces à partir de n'importe quelle partie de votre application de la manière suivante :

  1. Utilisez le geste sélectionné dans l'interface utilisateur AdMob lors de l'enregistrement d'un appareil de test.
  2. Par programmation à l'aide de l'API fournie.
  3. Utilisez le bouton de lancement du menu de débogage.

Lancer l'application à l'aide de gestes

Aucune modification n'est nécessaire dans votre application pour lancer l'inspecteur d'annonces à l'aide d'un geste. Il vous suffit d'effectuer le geste (double balayage ou secouage) que vous avez configuré dans AdMob pour cet appareil de test. En savoir plus

Après avoir défini un geste dans l'interface utilisateur AdMob (et attendu 15 minutes pour qu'il se propage), votre application doit envoyer une demande d'annonce pour que le SDK Google Mobile Ads puisse en savoir plus sur votre paramètre de geste. Si le geste que vous avez spécifié ne fonctionne pas, essayez de charger une annonce, de redémarrer votre application et de tester à nouveau le geste.

Lancer par programmation

Vous pouvez également lancer l'inspecteur d'annonces de façon programmatique:

Java

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

Kotlin

MobileAds.openAdInspector(context) { error ->
  // Error will be non-null if ad inspector closed due to an error.
}

Cette API fonctionne pour les appareils de test enregistrés de façon programmatique ou dans l'interface utilisateur AdMob.

Afficher les blocs d'annonces et résoudre les problèmes associés

Une fois lancé, l'écran principal de l'inspecteur d'annonces s'affiche, contenant la liste de tous les blocs d'annonces de l'UI AdMob associés à votre ID d'application AdMob qui ont des configurations d'enchères ou de médiation :

Nous vous recommandons d'initialiser le SDK Google Mobile Ads avant d'utiliser l'inspecteur d'annonces.

Afficher les détails de la cascade de médiation pour un bloc d'annonces

Appuyez sur un bloc d'annonces pour afficher le journal des requêtes SDK, qui fournit des informations sur la cascade de médiation jusqu'au moment où l'annonce a été diffusée (ou que la cascade s'est terminée sans diffusion) pour les dernières demandes d'annonces.

Vous pouvez développer chaque requête à l'aide de l'indicateur de divulgation pour afficher les résultats de la cascade de médiation pour cette requête, ainsi que toute erreur et latence applicables à cette requête.

Pour les sources d'annonces tierces, les messages d'erreur sont envoyés directement à partir de la source. Pour en savoir plus, consultez votre source d'annonces tierce.

Afficher les détails des enchères pour un bloc d'annonces

Conditions préalables: SDK Google Mobile Ads 20.2.0 ou version ultérieure

Si vous débutez avec les enchères, consultez la présentation.

Dans le journal des requêtes SDK, vous pouvez voir les sources d'annonces pour les enchères appelées dans la requête d'annonce. Appuyez sur un bloc d'annonces dans le journal des requêtes SDK pour afficher les détails de chaque source d'annonces dans les enchères.

Les résultats des enchères sont triés de façon à rapprocher les éléments exploitables du haut de la liste:

  • En haut de la page figure le réseau publicitaire ayant remporté l'enchère.

  • Voici les réseaux publicitaires présentant des problèmes. Vous pouvez suivre la procédure de dépannage pour les problèmes.

  • Ensuite, il y a les réseaux publicitaires pour lesquels aucune annonce n'a été renvoyée ou pour lesquels aucune enchère n'a été définie. Cela peut indiquer de nombreux problèmes différents avec la source d'annonces, car elle n'a peut-être pas défini d'enchère en raison de sa configuration ou de son mode de prise de décision. Vous pouvez consulter le guide de configuration de la source d'annonces ou contacter directement la source pour obtenir de l'aide.

  • Enfin, en bas de la liste figurent les réseaux publicitaires qui n'ont pas remporté la mise aux enchères.

La cascade de médiation peut placer la source d'annonces qui a remporté l'enchère en fonction de sa valeur d'eCPM.

Lorsqu'une source d'annonces est appelée dans la cascade de médiation, elle peut diffuser des annonces. Pour en savoir plus sur le fonctionnement des enchères avec la cascade de médiation, consultez les exemples 2 et exemple 3 de sources d'annonces associées à des enchères et participant à la cascade d'annonces dans un groupe de médiation.

Débogage avancé des blocs d'annonces

Lors de la résolution de problèmes liés aux blocs d'annonces, il peut être utile d'examiner la demande et la réponse d'annonce pour identifier la défaillance d'un élément, ou de communiquer l'information à l'assistance Google pour faciliter le débogage. Appuyez sur l'icône de menu en haut de la chaîne de cascade d'annonces, puis sélectionnez Partager la demande et la réponse d'annonce pour exporter la demande et la réponse d'annonce complètes. Vous n'avez donc pas besoin d'exécuter de traces réseau sur votre propre application.

En outre, vous pouvez afficher les paramètres d'enchères tiers décodés en appuyant sur l'option Paramètre d'enchères tiers dans le même menu que la chaîne de demande. Vous obtenez ainsi des informations sur les paramètres d'enchères tiers susceptibles de rencontrer des problèmes, ce qui vous aide à déboguer votre application ou à vérifier qu'un réseau collecte bien ses signaux.

Afficher les adaptateurs disponibles

Cliquez sur l'onglet Adaptateurs pour afficher la liste de tous les adaptateurs tiers associés aux sources d'annonces dans les configurations d'enchères ou de médiation de votre application. Développez ensuite les fiches pour afficher leur état d'initialisation et les versions du SDK. En plus des adaptateurs tiers compatibles, vous pouvez également afficher des adaptateurs d'événements personnalisés. Les événements personnalisés permettent aux éditeurs d'utiliser des réseaux publicitaires non compatibles avec AdMob. Les événements personnalisés se distinguent des adaptateurs tiers standards dans la liste des adaptateurs par leurs noms de classe uniques. En plus de fournir le nom de la classe et des informations sur l'état, l'inspecteur d'annonces affiche également les libellés attribués à ces événements personnalisés dans l'interface Web AdMob.

Si l'adaptateur est introuvable ou ne s'initialise pas correctement, consultez la section Résoudre les problèmes détectés à l'aide de l'inspecteur d'annonces pour en savoir plus.

Tester vos blocs d'annonces

Si vous souhaitez tester votre bloc d'annonces sans avoir à y accéder dans l'interface utilisateur de votre application, vous pouvez le faire directement depuis l'écran d'informations du bloc d'annonces dans l'inspecteur d'annonces. De plus, vous pouvez tester plusieurs blocs d'annonces à la fois, charger et afficher de manière asynchrone vos demandes d'annonces de test, et même effectuer des tests d'une seule source d'annonces.

Tests des annonces

Les tests d'annonces de l'inspecteur d'annonces décrits dans cette section sont un excellent outil pour vérifier votre expérience publicitaire de base et pour valider votre configuration de médiation lorsqu'ils sont utilisés avec des tests sur une source d'annonces unique.

Lorsque vous êtes prêt à tester votre bloc d'annonces, appuyez sur le bouton Demander une annonce test en haut de l'écran de l'inspecteur d'annonces pour déclencher le test. Les résultats des tests apparaissent ensuite dans le journal des requêtes du SDK sous l'en-tête Demandé à l'inspecteur d'annonces.

Découvrez comment utiliser l'inspecteur d'annonces dans votre application.

Tester une source d'annonces spécifique

L'inspecteur d'annonces dispose d'une fonctionnalité qui permet de limiter les demandes d'annonces dans votre application afin de ne diffuser des annonces qu'à partir d'une seule source d'annonces pour les enchères ou la médiation en cascade. Cela vous permet de vérifier que vous avez correctement implémenté l'adaptateur tiers et que la source d'annonces est diffusée comme prévu.

Pour activer cette fonctionnalité, activez l'option Single ad source test (Test d'une source d'annonce spécifique) en bas de l'écran. La boîte de dialogue suivante s'affiche:

Vous devez initialiser le SDK Google Mobile Ads avant de pouvoir utiliser le test d'une source d'annonce spécifique.

Vous pouvez ensuite sélectionner une seule source d'annonces à tester. Une fois une source d'annonces sélectionnée, l'écran suivant s'affiche :

Le paramètre de test d'une source d'annonces spécifique s'applique à toutes les demandes d'annonces ultérieures que vous enverrez dans la même session. Toutefois, il ne s'applique pas aux annonces précédemment mises en cache dans cette session qui n'ont pas encore été diffusées. Nous vous recommandons de forcer le redémarrage de votre application lorsque vous appliquez un test de source d'annonces unique afin d'invalider les annonces mises en cache qui pourraient être diffusées plutôt que la source d'annonces que vous avez choisie ne reçoive une demande.

Après avoir redémarré votre application, tous les emplacements de blocs d'annonces tentent d'afficher une annonce du réseau sélectionné uniquement. Lorsque vous lancez l'inspecteur d'annonces lorsqu'un test de source d'annonces spécifique est actif, la source d'annonces de test active s'affiche :

En mode de test d'une source d'annonces unique, toutes les demandes d'annonces tentent d'être satisfaites avec la source d'annonces sélectionnée, qu'elle ait été configurée pour les enchères ou la médiation pour le bloc d'annonces demandé. Si la source d'annonces que vous testez ne se trouve pas dans la cascade de médiation d'un bloc d'annonces, le message d'erreur "Pas de remplissage" s'affiche.

Lors du test d'une source d'annonces spécifique, vous pouvez appuyer sur un bloc d'annonces pour afficher le journal des requêtes SDK correspondant. Cela vous permet de savoir si la source d'annonces a répondu aux demandes d'annonces effectuées après l'activation du test d'une source d'annonces spécifique. Si la source d'annonces n'a pas pu charger une annonce, un message décrivant l'erreur s'affiche.

Si vous avez ajouté plusieurs instances de la source d'annonces sélectionnée à une cascade de médiation, la cascade affichera chaque instance de l'appel à la source d'annonces jusqu'à ce que la demande d'annonce ait été satisfaite ou que la cascade se soit terminée sans remplissage.

Arrêter un test de source d'annonces spécifique

Pour arrêter le test, mettez le bouton en position désactivée:

Un message de confirmation s'affiche alors sur l'écran de redémarrage suivant :

Nous vous recommandons de forcer le redémarrage de votre application après avoir arrêté le test afin d'invalider toutes les annonces mises en cache pour la source d'annonces testée.

Copier l'intégralité des sorties de débogage

L'outil d'inspection des annonces permet de copier une chaîne JSON contenant l'intégralité des sorties de débogage de l'outil, y compris les détails de votre application AdMob, les états d'initialisation de l'adaptateur et les résultats des tests de toutes les unités d'annonces.

Pour ce faire, appuyez sept fois sur l'icône de l'application jusqu'à ce que le message Copie du JSON de l'outil d'inspection des annonces dans le presse-papiers s'affiche.