Grâce à l'inspecteur d'annonces, vous pouvez:
- Inspecter vos blocs d'annonces
- Vérifier si vos annonces se remplissent comme prévu
- Identifier les erreurs et afficher des détails sur la façon de les résoudre
- Afficher les détails de chaque réseau publicitaire Open Bidding pour chaque demande
- Afficher les détails de la médiation pour chaque réseau publicitaire par demande
- Tester des sources d'annonces tierces Open Bidding ou de médiation en cascade
- vérifier que vous avez correctement configuré chaque bloc d'annonces pour Open Bidding ; 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:
- Suivez le guide de démarrage.
- Utilisez le SDK Google Mobile Ads 8.10.0 ou une version ultérieure.
- Activer le test mode ou lien votre appareil à Ad Manager. L'inspecteur d'annonces ne se lance que sur les appareils de test ou associés.
Lancer l'inspecteur d'annonces
Vous pouvez lancer l'inspecteur d'annonces où que vous soyez dans votre application de différentes manières:
- Utilisez le bouton de lancement dans le menu de débogage.
- Effectuez le geste que vous avez sélectionné dans les paramètres de l'inspecteur d'annonces.
- Par programmation à l'aide de l'API fournie
Lancer avec le menu de débogage
Aucune modification n'est requise de votre application pour lancer l'inspecteur d'annonces via le débogage menu; recherchez une annonce diffusée par votre réseau Ad Manager, puis appuyez de manière prolongée sur avec deux doigts pour ouvrir l'annonce le menu de débogage. Sélectionnez ensuite Ouvrir l'inspecteur d'annonces.
Si vous n'avez pas associé votre appareil, vous pouvez être invité pour vous connecter à votre compte Ad Manager.
Vous pouvez également sélectionner Paramètres de l'inspecteur d'annonces dans les paramètres de débogage. Choisissez un geste permettant d'ouvrir l'inspecteur d'annonces sans avoir à y accéder via le menu de débogage.
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) de manière programmatique.
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 l'appareil a effectué des demandes d'annonces depuis que l'inspecteur d'annonces a été activé au cours de cette session d'application. La liste inclut aussi des blocs d'annonces dans lesquels Open Bidding est activé, ordonnés chronologiquement, en commençant par les requêtes les plus récentes, et celles ayant aucune demande d'annonce terminée (en grisé):
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
Si vous n'avez jamais utilisé Open Bidding, consultez la présentation d'Open Bidding Enchères.
Dans le journal des requêtes du SDK, vous pouvez voir les Open 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 Open Bidding dans l'enchère.
Les résultats Open 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 les étapes de dépannage à suivre à la fin de la Open Bidding FAQ.
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 Questions fréquentes sur Open Bidding de l'assistance.
Enfin, en bas de la liste figurent les réseaux publicitaires qui n'ont plus Open Bidding mise aux enchères.
La cascade de médiation peut placer la source d'annonces qui a remporté la Open Bidding en fonction de leur valeur d'eCPM.
Une cascade de médiation est le résultat de la mise en concurrence de plusieurs groupes de rendement pour même inventaire. Vous pouvez ajouter jusqu'à 10 partenaires de rendement tiers groupe de rendement, y compris les partenaires de rendement Open Bidding et la médiation pour les mobiles partenaires de rendement pour les applications mobiles.
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 Ad Manager 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 Ad Manager .
Si l'adaptateur est introuvable ou ne parvient pas à s'initialiser, consultez Inspecter la diffusion des annonces dans une application mobile pour en savoir plus.
Tester vos blocs d'annonces
Si vous souhaitez tester votre bloc d'annonces sans avoir à accéder à celui-ci 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.
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 Open Bidding ou d'une annonce de médiation en cascade source. Cela vous permet de vérifier que vous avez correctement mis en œuvre 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 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 Ad Manager 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.