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 informations détaillées 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érifiez 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 plug-in Flutter Mobile Ads1.3.0 ou 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 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 menu de débogage. Il vous suffit de rechercher une annonce diffusée par votre réseau Ad Manager et d'appuyer dessus de manière prolongée 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 permettant d'ouvrir l'inspecteur d'annonces à l'avenir sans avoir à passer par le menu de débogage.
Lancer par programmation
Vous pouvez également lancer l'inspecteur d'annonces de manière programmatique:
MobileAds.instance.openAdInspector(
(AdInspectorError? 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 manière programmatique.
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 effectué des demandes d'annonces depuis que l'inspecteur d'annonces a été activé au cours de cette session d'application. La liste contient également les blocs d'annonces pour lesquels Open Bidding est activé, classés chronologiquement en commençant par les demandes les plus récentes, et ceux pour lesquels aucune demande d'annonce n'a abouti (est grisée):
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 d'un bloc d'annonces
Appuyez sur un bloc d'annonces pour afficher le journal des requêtes du SDK, qui fournit des informations sur la cascade de médiation jusqu'au moment où l'annonce s'est affichée (ou la cascade s'est terminée 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 correspondant à cette requête, ainsi que les erreurs et la 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
Si vous n'avez jamais utilisé Open Bidding, consultez la présentation d'Open Bidding.
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 du SDK pour afficher les détails de chaque source d'annonces dans l'enchère bidding .
Les résultats bidding sont triés afin de rapprocher les éléments exploitables du 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 la les procédures de dépannage pour résoudre les problèmes, à la fin des bidding questions fréquentes.
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 être un indicateur de nombreux problèmes différents au niveau de la source d'annonces, car elle n'a peut-être pas d'enchère en raison de sa configuration ou de sa prise de décision. Vous pouvez consulter le guide de configuration de la source d'annonces ou Questions fréquentes sur Open Bidding pour en savoir plus.
Enfin, en bas de la liste se trouvent les réseaux publicitaires qui n'ont pas remporté l'enchèrebidding .
La cascade de médiation peut placer la source d'annonces qui a remporté l'enchèrebidding en fonction de sa valeur d'eCPM.
Une cascade de médiation est le résultat de plusieurs groupes de rendement en concurrence pour le même inventaire. Vous pouvez ajouter jusqu'à 10 partenaires de rendement tiers dans un même groupe de rendement, y compris des partenaires de rendement Open Bidding et de la médiation pour les partenaires de rendement d'applications mobiles.
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. Cela vous évite d'avoir à exécuter des 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 Ad Manager non compatibles. Dans la liste des adaptateurs, les événements personnalisés se distinguent des adaptateurs tiers standards par leurs noms de classe uniques. En plus de fournir le nom et l'état des classes, 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 ne s'initialise pas, 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 à y accéder dans l'interface utilisateur de votre application, vous pouvez le faire directement dans l'inspecteur d'annonces depuis l'écran d'informations du bloc d'annonces. En outre, vous pouvez tester plusieurs blocs d'annonces à la fois, charger et afficher de manière asynchrone vos demandes d'annonces tests, et même tester une source d'annonces unique.
Test 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 votre inspecteur d'annonces pour déclencher le test. Les résultats du test apparaissent ensuite dans le journal des requêtes du SDK sous l'en-tête Demandé de l'inspecteur d'annonces.
Test d'une source d'annonces unique
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 source d'annonces de médiation bidding unique 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é, activez le bouton Test de source d'annonces unique en bas de l'écran. La boîte de dialogue suivante s'affiche:
Avant de pouvoir tester une source d'annonces spécifique, vous devez initialiser le SDK Google Mobile Ads.
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 de la source d'annonces unique s'applique à toutes les demandes d'annonces que vous effectuerez par la suite 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. 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.
Une fois votre application redémarrée, tous les emplacements de blocs d'annonces tentent de diffuser une annonce provenant du réseau sélectionné uniquement. Si vous lancez l'inspecteur d'annonces lorsqu'un test de source d'annonces est actif, la source d'annonces 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 à un cascade de médiation, chaque instance de l'appel à la source d'annonces apparaîtra dans le cascade 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 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 sorties 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é l'inspecteur d'annonces JSON dans le presse-papiers s'affiche.