Inspecteur des publicités

Inspecteur d'annonces est une superposition intégrée à l'application qui permet aux appareils autorisés d'effectuer des analyses en temps réel des demandes d'annonces de test, directement dans une application mobile. Il est inclus dans la version du SDK Google Mobile Ads. 20.0.0 et versions ultérieures, peuvent être activées sans codage.

L'inspecteur d'annonces disponible dans les versions du SDK Mobile Ads antérieures à20.2.0vous permet:

  • Inspecter vos blocs d'annonces
  • Inspecter les adaptateurs tiers
  • vérifier que vos emplacements d'annonces se remplissent comme prévu ;
  • identifier les erreurs et consulter des explications détaillées pour les corriger ;
  • Afficher les détails de la médiation pour chaque réseau publicitaire par demande
  • Tester des sources d'annonces de médiation tierces spécifiques
  • Vérifiez que vous avez correctement configuré chaque bloc d'annonces pour la médiation en cascade.

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

  • Afficher les détails des enchères pour chaque réseau publicitaire par demande
  • Examinez ensemble les détails de la médiation en cascade et de la médiation en cascade pour chaque réseau publicitaire par demande.
  • Tester des sources d'annonces tierces associées à des enchères ou à la médiation en cascade
  • 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:

  • Suivez le guide de démarrage.

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

Lancer l'inspecteur d'annonces

L'inspecteur d'annonces peut être lancé où que vous soyez dans votre application. Vous pouvez lancer l'inspecteur d'annonces de trois manières différentes.

  1. Utilisez le geste sélectionné dans l'UI AdMob lors de l'enregistrement d'un appareil de test.

  2. de façon automatisée à l'aide de l'API fournie ;

  3. Utilisez le bouton de lancement du menu de débogage.

Lancer avec des gestes

Aucune modification n'est requise pour lancer l'inspecteur d'annonces d'un simple geste. Il vous suffit d'effectuer le geste (deux fois de suite ou secouer) 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 avant sa diffusion), votre application doit envoyer une demande d'annonce au SDK Google Mobile Ads pour en savoir plus sur votre paramètre de geste. Si le geste spécifié ne fonctionne pas, essayez de charger une annonce, de redémarrer l'application, puis de tester à nouveau le geste.

Lancement programmatique

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

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

Cette API fonctionne avec les appareils de test enregistré par programmation ou dans l'interface utilisateur AdMob.

Afficher les résultats de demandes d'annonces récents par bloc d'annonces

Une fois lancé, l'écran principal de l'inspecteur d'annonces s'affiche. Il contient une liste de tous les blocs d'annonces dans l'interface utilisateur AdMob associée à votre ID d'application AdMob qui ont des configurations d'enchères ou de médiation:

Les blocs d'annonces sont classés par ordre chronologique, en commençant par les plus récentes. Comme indiqué ci-dessus, les blocs d'annonces connus sans demande terminée sont grisés.

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

Afficher les adaptateurs disponibles

Accédez à l'onglet Adaptateurs. Vous y trouverez une 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, ainsi que leur état d'initialisation. dans le menu déroulant ; Si l'adaptateur est introuvable ou ne parvient pas à s'initialiser, consultez l'article du Centre d'aide pour résoudre le problème.

Afficher bidding les détails d'un bloc d'annonces

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

Si vous ne connaissez pas les enchères, consultez la présentation des enchères.

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

Appuyez sur le lien Afficher tous les enchérisseurs pour afficher tous biddingles réseaux publicitaires configurés pour le bloc d'annonces. Les résultatsbidding sont triés pour rapprocher les éléments exploitables en haut de la liste:

  • Le réseau publicitaire qui a remporté la mise en concurrence se trouve en haut de la page.

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

  • Ensuite, certains réseaux publicitaires n'ont renvoyé aucune annonce ou n'ont défini aucune enchère. Cet indicateur est à l'origine d'un grand nombre de problèmes différents avec la source d'annonce, car elle ne dispose pas d'enchère en raison de sa configuration ou de son mode de prise de décision. Veuillez vous reporter au guide de configuration de la source d'annonce ou contactez directement la source d'annonce pour obtenir de l'aide.

  • Enfin, les réseaux publicitaires qui ont perdu la mise aux enchèresbidding figurent en bas de la liste.

La cascade de médiation peut placer la source d'annonce qui a remporté la mise aux enchèresbidding en fonction de sa valeur d'eCPM.

Lorsque la source d'annonce est appelée dans la cascade de médiation, elle diffuse l'annonce. Pour en savoir plus sur le fonctionnement des enchères avec la cascade de médiation, consultez les exemples 2 et 3 de sources de cascade d'annonces et de cascades d'annonces dans un groupe de médiation.

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. Celui-ci fournit des détails sur la cascade de médiation jusqu'au moment où l'annonce a été remplie (ou la cascade sans remplissage) pour les dernières demandes d'annonces.

Chaque requête peut être développée à l'aide de l'indicateur de divulgation pour afficher les résultats de la cascade de médiation pour cette requête, ainsi que les erreurs et la latence applicables.

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

Effectuer un test de source d'annonce unique

L'inspecteur d'annonces propose une fonctionnalité permettant de limiter les demandes d'annonces pour votre application afin qu'elles ne soient diffusées qu'à partir d'une seule source bidding ou cascade d'annonces de médiation. Vous pouvez ainsi vérifier que vous avez correctement implémenté l'adaptateur tiers et que la source d'annonce est diffusée comme prévu.

Pour activer cette fonctionnalité, activez l'option Test de source d'annonce unique en bas de l'écran. La boîte de dialogue de sélection des sources d'annonces suivante s'affiche:

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

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

Le paramètre de test d'une source d'annonce spécifique s'applique à toutes les demandes d'annonces ultérieures que vous effectuez dans la même session. Cependant, elle ne s'appliquera pas aux annonces précédemment mises en cache dans cette session qui n'ont pas encore été diffusées. Il est recommandé de forcer le redémarrage de l'application lorsque vous appliquez un test de source d'annonce spécifique afin d'annuler la validation d'annonces mises en cache susceptibles d'être diffusées à la place de la source d'annonce que vous avez choisie.

Après le redémarrage de votre application, tous les emplacements de blocs d'annonces tentent de diffuser une annonce du réseau sélectionné uniquement. L'inspecteur d'annonces lance une source d'annonce test dès qu'un test de la source d'annonce est actif:

En mode test de source d'annonce unique, toutes les demandes d'annonces tentent de remplir la source d'annonce sélectionnée, qu'elles aient été configurées pour les enchères ou la médiation pour le bloc d'annonces demandé. En d'autres termes, si la source d'annonce 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'annonce spécifique, vous pouvez appuyer sur un bloc d'annonces pour afficher le journal des requêtes SDK. Cela vous permet de savoir si la source d'annonce a répondu aux demandes d'annonces envoyées après l'activation du test d'une seule source d'annonce. Si la source d'annonce n'a pas pu charger une annonce, un message d'erreur s'affiche.

Si vous avez ajouté plusieurs instances de la source d'annonce sélectionnée à une cascade de médiation, chaque instance de l'appel de la source d'annonce apparaît dans la cascade jusqu'à ce que l'annonce soit remplie ou que la cascade d'annonces se termine sans un remplissage.

Les événements personnalisés ne sont pas compatibles avec les tests d'une source d'annonce spécifique.

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

Pour arrêter le test, désactivez l'option suivante:

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 l'arrêt du test afin d'annuler les annonces mises en cache pour la source d'annonce testée.