Inspecteur d'annonces

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

Utiliser l'inspecteur d'annonces dans les versions du SDK Mobile Ads antérieures à 8.5.0, vous pouvez:

  • Inspecter vos blocs d'annonces
  • Inspecter les adaptateurs tiers
  • Vérifier si vos annonces se remplissent comme prévu
  • Identifier les erreurs et afficher des informations détaillées sur la façon de les résoudre
  • Afficher les détails de la médiation pour chaque réseau publicitaire par 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 8.5.0 ou version ultérieure, vous devez peut é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 annonce réseau par requête
  • Tester des sources d'annonces individuelles associées à des enchères tierces ou à la médiation en cascade
  • Vérifiez que vous avez correctement configuré chaque bloc d'annonces pour les enchères et médiation en cascade

Ce guide explique comment lancer et utiliser les différentes fonctionnalités en tant qu'inspecteur.

Prérequis

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

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

Lancer l'inspecteur d'annonces

Vous pouvez lancer l'inspecteur d'annonces où que vous soyez dans votre application de différentes manières:

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

Lancer à l'aide de gestes

Vous n'avez pas besoin de modifier votre application pour lancer l'inspecteur d'annonces en un geste. juste effectuez le geste (double effleurement ou secoue) que vous avez configuré dans AdMob cet appareil de test. En savoir plus

Après avoir défini un geste dans l'interface utilisateur AdMob (après 15 minutes, s'applique), votre application doit envoyer une demande d'annonce pour la fonctionnalité SDK pour en savoir plus sur les paramètres des gestes. Si le geste que vous avez spécifié 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 manière programmatique:

Swift

GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
  // Error will be non-nil if there was an issue and the inspector was not displayed.
}

Objective-C

[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
  completionHandler:^(NSError *error) {
    // Error will be non-nil if there was an issue and the inspector was not displayed.
}];

Cette API fonctionne pour les appareils de test inscrit(e) par programmation ou dans l'UI AdMob.

Assurez-vous que le contrôleur de vue transmis à cette API est déjà entièrement visible sur écran (viewDidAppear: a été appelé). Si le contrôleur de vue transmis est Le processus d'affichage, par exemple lorsque l'API est appelée dans la vue la fonction viewDidLoad du contrôleur, puis la présentation de l'inspecteur d'annonces est défaillant.

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. Il contient la liste de toutes les annonces unités dans l'UI AdMob associée à votre ID d'application AdMob avec enchères ou médiation Configurations:

Nous vous recommandons d'initialiser les annonces Google pour mobile SDK avant d'utiliser l'inspecteur d'annonces.

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

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

Chaque demande peut être développée à l'aide de l'indicateur de divulgation pour afficher les résultats. de la cascade de médiation correspondant à cette demande, ainsi que les éventuelles erreurs et latences applicable à cette demande.

Pour les sources d'annonces tierces, les messages d'erreur sont envoyés directement la source d'annonces. 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 8.5.0 ou supérieur

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

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

Les résultats bidding sont triés afin d'afficher les éléments exploitables situés en haut de la liste:

  • En haut de la page se trouve le réseau publicitaire qui a remporté l'enchère.

  • Viennent ensuite les réseaux publicitaires qui présentent des problèmes. Vous pouvez suivre les la procédure de dépannage à suivre.

  • 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. Ce est un indicateur possible de nombreux problèmes différents au niveau de la source d'annonces, car n'ont peut-être pas défini d'enchère en raison de leur configuration ou de leur décision. Vous pouvez faire référence à l'annonce le guide de configuration de la source contactez directement la source d'annonces compatibles.

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

La cascade de médiation peut placer la source d'annonces qui a remporté la bidding en fonction de leur 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 exemple 2 et exemple 3 d'enchères et celles participant à la cascade d'annonces dans un groupe de médiation.

Débogage avancé des blocs d'annonces

Pour résoudre les problèmes liés aux blocs d'annonces, il peut être utile d'examiner la demande d'annonce et une réponse pour identifier la défaillance ou pour partager avec Google Assistance pour le débogage. Appuyez sur l'icône de menu en haut de la cascade et sélectionnez Partager la demande et la réponse d'annonce pour exporter la demande d'annonce complète. et la réponse. Cela vous évite d'avoir à exécuter des traces réseau sur votre propre application.

Vous pouvez également 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 demande. . Vous obtenez ainsi des informations détaillées sur les paramètres d'enchères tiers des problèmes, ce qui vous aidera à déboguer votre application ou à vérifier qu'un réseau à collecter correctement ses signaux.

Afficher les adaptateurs disponibles

Cliquez sur l'onglet Adaptateurs pour afficher la liste de tous les adaptateurs tiers associés. avec les 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 afficher des événements personnalisés adaptateurs. Les événements personnalisés permettent les éditeurs utilisent des réseaux publicitaires AdMob n'est pas compatible. Les événements personnalisés se distinguent des événements tiers standards dans la liste d'adaptateurs par leur nom de classe unique. En plus de et fournit des informations sur l'état et le nom de la classe, l'inspecteur d'annonces affiche également et libellés attribués à ces événements personnalisés AdMob .

Si l'adaptateur est introuvable ou ne parvient pas à s'initialiser, consultez 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 votre dans l'UI de l'application, l'inspecteur d'annonces permet d'effectuer cette opération directement depuis l'écran d'informations du bloc d'annonces. Vous pouvez aussi tester plusieurs blocs d'annonces en même temps, en les chargeant de manière asynchrone et consulter vos demandes d'annonces tests, et même tester une source d'annonce spécifique.

Test des annonces

Les tests d'annonces présentés dans cette section avec l'inspecteur d'annonces sont un excellent outil pour valider votre expérience publicitaire de base et votre médiation lorsqu'elle est utilisée avec des tests sur une seule source d'annonces.

Lorsque vous êtes prêt à tester votre bloc d'annonces, appuyez sur le bouton Demander une annonce test à l'adresse en haut de l'écran de l'inspecteur d'annonces. Tests les résultats apparaissent alors dans le journal des requêtes du SDK, sous l'en-tête Requested dans l'inspecteur d'annonces.

Découvrez comment utiliser l'inspecteur d'annonces l'application

Test d'une source d'annonces unique

L'inspecteur d'annonces dispose d'une fonctionnalité qui permet de restreindre les demandes d'annonces dans votre application afin qu'elles ne soient diffusées d'une annonce unique bidding ou d'une annonce de médiation en cascade source. Cela vous permet de vérifier que vous avez correctement implémenté l'API et que la source d'annonces 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 suivante pour sélectionner une source d'annonces s'affiche:

Vous devez initialiser les annonces Google pour mobile SDK avant de pouvoir tester une source d'annonces spécifique.

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

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

Une fois votre application redémarrée, tous les emplacements de blocs d'annonces tentent de diffuser une annonce à partir du uniquement sur le réseau sélectionné. Lancement de l'inspecteur d'annonces lorsqu'un test de source d'annonces spécifique affiche la source d'annonces test active:

En mode de test d'une source d'annonces unique, toutes les demandes d'annonces tentent de répondre à l'aide de l'élément sélectionné source d'annonces, qu'elle ait été configurée pour les enchères ou 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 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 le test d'une source d'annonces spécifique est activé. Si la source d'annonces n'a pas pu charger une annonce, un message d'erreur décrivant l'erreur s'affiche.

Si vous avez ajouté plusieurs instances de la source d'annonces sélectionnée à une médiation chaque instance de l'appel à la source d'annonces jusqu'à ce que l'annonce soit remplie ou que la cascade se termine 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 invalider les annonces mises en cache pour la source d'annonces testée.

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

L'inspecteur d'annonces permet de copier une chaîne JSON contenant l'intégralité du débogage les résultats générés par l'outil, y compris les détails AdMob l'état d'initialisation de l'adaptateur pour tester les résultats de tous les blocs d'annonces.

Pour ce faire, appuyez sept fois sur l'icône de l'application jusqu'à ce que le message Annonce copiée s'affiche. dans le presse-papiers.