Avec l'inspecteur d'annonces, vous pouvez:
- Inspecter vos blocs d'annonces
- vérifier que vos annonces se remplissent comme prévu ;
- d'identifier les erreurs et de consulter des explications détaillées pour 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 et pour chaque demande
- Tester des sources d'annonces tierces Open Bidding ou de médiation en cascade d'annonces individuelles
- Vérifier que vous avez correctement configuré chaque bloc d'annonces pour Open Bidding et la médiation en cascade
Ce guide explique comment lancer et utiliser les différentes fonctionnalités de l'inspecteur d'annonces.
Conditions préalables
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.
- Activez le mode test ou associez 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 depuis n'importe quel emplacement de votre application comme suit:
- Utilisez le bouton de lancement du menu de débogage.
- Utilisez 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 nécessaire dans votre application pour lancer l'inspecteur d'annonces via le menu de débogage. Il vous suffit de rechercher une annonce diffusée par votre réseau Ad Manager, puis d'appuyer de manière prolongée sur l'annonce avec deux doigts pour ouvrir le menu de débogage. Sélectionnez ensuite Ouvrir l'inspecteur d'annonces.
Si vous n'avez pas associé votre appareil, vous serez peut-être invité à 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 et choisir un geste qui permettra d'ouvrir l'inspecteur d'annonces à l'avenir sans avoir à passer par le menu de débogage.
Lancer de manière programmatique
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 enregistrés de façon programmatique.
Assurez-vous que le contrôleur de vue transmis à cette API est déjà entièrement visible à l'écran (viewDidAppear: a été appelé). Si le contrôleur de vue transmis est en cours d'affichage, par exemple lorsque l'API est appelée dans sa fonction viewDidLoad, l'inspecteur d'annonces échoue.
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 tous les blocs d'annonces l'appareil a envoyé des demandes d'annonces depuis que l'inspecteur d'annonces a été activé lors de cette session d'application. La liste contient également les blocs d'annonces pour lesquels Open Bidding est activé. Les blocs d'annonces sont classés par ordre chronologique en commençant par les demandes les plus récentes et ceux pour lesquels aucune demande d'annonce n'a été finalisée (en gris):
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 détails sur la cascade de médiation jusqu'au moment où l'annonce a été satisfaite (ou que la cascade s'est terminée sans remplissage) pour les dernières demandes d'annonces.
Chaque demande peut être étendue à l'aide de l'indicateur de divulgation afin d'afficher les résultats de la cascade de médiation pour cette requête, ainsi que les erreurs et la latence applicables à cette demande.
Pour les sources d'annonces tierces, les messages d'erreur sont envoyés directement à partir de 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 ne connaissez pas Open Bidding, consultez la présentation d'Open Bidding.
Dans ce journal, vous pouvez voir les Open 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'annonces dans l' Open Bidding enchère.
Les résultats Open Bidding sont triés de manière à placer les éléments exploitables en haut de la liste:
Le réseau publicitaire qui a remporté l'enchère apparaît en haut de l'écran.
Viennent ensuite les réseaux publicitaires présentant des problèmes. Vous pouvez suivre la la procédure de dépannage à suivre à la fin des Open Bidding questions fréquentes.
Viennent ensuite les réseaux publicitaires qui n'ont diffusé aucune annonce ou qui n'ont enchéri. Il s'agit d'un indicateur possible de nombreux problèmes différents concernant la source d'annonces, car celle-ci n'est peut-être associée à aucune enchère en raison de sa configuration ou de sa décision. Consultez le guide de configuration de la source d'annonces ou Questions fréquentes sur Open Bidding pour obtenir une assistance supplémentaire.
Enfin, en bas de la liste figurent les réseaux publicitaires qui ont perdu la mise aux enchèresOpen Bidding .
La cascade de médiation peut placer la source d'annonces ayant remporté l'Open Bidding enchère en fonction de sa valeur d'eCPM.
Une cascade de médiation est le résultat de la mise en concurrence de plusieurs groupes de rendement pour le même inventaire. Vous pouvez ajouter jusqu'à 10 partenaires de rendement tiers à un seul groupe de rendement, y compris à la fois des partenaires de rendement Open Bidding et la médiation pour les partenaires de rendement pour les applications mobiles.
Débogage avancé des blocs d'annonces
Lors du dépannage des blocs d'annonces, il peut être utile d'étudier en détail la demande et la réponse d'annonce afin d'identifier l'origine du problème, ou de partager le problème avec l'assistance Google pour faciliter le débogage. Appuyez sur l'icône de menu en haut de la chaîne de cascades d'annonces, puis sélectionnez Partager la demande d'annonce et la réponse 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.
De plus, 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 requête. Vous obtenez ainsi des informations sur les paramètres d'enchères tiers qui peuvent présenter des problèmes. Cela vous aide à déboguer votre application ou à vérifier qu'un réseau collecte bien ses signaux.
Voir 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 leur version 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 Ad Managernon compatibles. 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 WebAd Manager .
Si l'adaptateur est introuvable ou échoue à s'initialiser, consultez Inspecter la diffusion des annonces sur une application mobile 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, l'inspecteur d'annonces vous permet d'effectuer cette opération directement à partir de l'écran d'informations du bloc d'annonces. De plus, vous pouvez tester plusieurs blocs d'annonces à la fois, charger et afficher vos demandes d'annonces tests de manière asynchrone, et même tester une source d'annonces spécifique.
Test des annonces
Les tests d'annonces de l'inspecteur d'annonces décrits dans cette section sont un excellent outil pour vérifier l'expérience publicitaire de base et valider votre configuration de médiation lorsqu'elle est utilisée avec des tests d'une source d'annonce spécifique.
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 lancer le test. Les résultats des tests apparaissent ensuite dans le journal des requêtes SDK, sous l'en-tête Demandée depuis l'inspecteur d'annonces.
Test d'une source d'annonce spécifique
L'inspecteur d'annonces dispose d'une fonctionnalité permettant de limiter les demandes d'annonces dans votre application de sorte qu'elles ne diffusent que les annonces d'une seule source d'annonces de médiation Open Bidding ou 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é, cliquez sur le bouton bascule Test d'une source d'annonces unique en bas de l'écran. La boîte de dialogue de sélection de la source d'annonces suivante s'affiche:
Avant de pouvoir tester une source d'annonce spécifique, vous devez initialiser le SDK Google Mobile Ads.
Vous pouvez ensuite sélectionner une seule source d'annonces à tester. L'écran suivant s'affiche alors:
Le paramètre de test d'une source d'annonces unique s'applique à toutes les demandes d'annonces ultérieures que vous effectuerez au cours de 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. Il est recommandé de forcer le redémarrage de votre application lors de l'application d'un seul test de source d'annonces. Vous risqueriez ainsi d'invalider les annonces mises en cache qui pourraient être diffusées, au lieu que la source d'annonces sélectionnée ne reçoive une demande.
Après avoir redémarré votre application, tous les emplacements de blocs d'annonces tentent de diffuser une annonce provenant uniquement du réseau sélectionné. Le fait de lancer l'inspecteur d'annonces lorsqu'une seule source d'annonce est active affiche la source d'annonce test active:
En mode test d'une source d'annonces spécifique, toutes les demandes d'annonces tentent de remplir 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. Cela vous permet de savoir si la source d'annonce a répondu aux demandes d'annonces effectuées après l'activation du test d'une source d'annonce unique. Si la source d'annonces n'a pas réussi à charger une annonce, un message d'erreur s'affiche et décrit l'erreur.
Si vous avez ajouté plusieurs instances de la source d'annonces sélectionnée à une cascade de médiation, vous verrez chaque instance de l'appel à la source d'annonces dans la cascade jusqu'à ce que l'annonce soit satisfaite ou que la cascade se termine sans remplissage.
Arrêter le test d'une seule source d'annonces
Pour arrêter le test, placez 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 l'arrêt du test afin d'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é des résultats de débogage de l'outil, y compris les détails de votreAd Manager application, les états d'initialisation de l'adaptateur et les résultats des tests de tous les blocs d'annonces.
Pour ce faire, appuyez sept fois sur l'icône de l'application jusqu'à ce que le message Copié de l'inspecteur d'annonces dans le presse-papiers s'affiche.