L'inspecteur d'annonces est une nouvelle fonctionnalité disponible dans la dernière version du SDK Google Mobile Ads (20.0.0 ou ultérieure pour Android, 7.68.0 ou ultérieure pour iOS). Il fournit des renseignements utiles sur la diffusion et permet de tester les sources d'annonces tierces en temps réel, sans aucun codage.
D'un simple geste, par exemple en secouant ou en faisant pivoter l'appareil de test, vous pouvez afficher l'inspecteur d'annonces en superposition dans vos applications. L'inspecteur d'annonces vous permet :
- d'inspecter vos blocs d'annonces ;
- de vérifier que vos emplacements d'annonces se remplissent comme prévu ;
- d'identifier les erreurs et de consulter des explications détaillées pour les résoudre ;
- d'afficher les détails de la cascade de médiation pour chaque demande ;
- de vérifier l'état de votre adaptateur SDK de source d'annonces tierce ;
- de tester différentes sources de cascade d'annonces tierces ;
- de vérifier que vous avez correctement configuré la source d'annonce pour la médiation ;
- d'examiner les performances de chacune de vos sources d'annonces par bloc d'annonces.
Premiers pas
Pour utiliser l'inspecteur d'annonces :
- Installez et initialisez la dernière version du SDK Google Mobile Ads (20.0.0 ou ultérieure pour Android, 7.68.0 ou ultérieure pour iOS).
- Configurez un appareil de test et sélectionnez le geste que vous souhaitez utiliser pour appeler l'inspecteur d'annonces sur votre appareil. Découvrez comment ajouter un appareil de test.
- Sur votre appareil de test, ouvrez votre application et commencez à interagir avec elle pour que le nombre de demandes d'annonces à analyser soit suffisant. Notez qu'un ensemble de demandes d'annonces peut même s'afficher au démarrage de l'application si vous avez activé la mise en cache des annonces dans votre application.
- Après avoir interagi avec votre application sur votre appareil de test, appelez l'inspecteur d'annonces à l'aide du geste sélectionné à l'étape 2.
Vous pouvez également activer l'inspecteur d'annonces sur votre appareil de test via un appel d'API pour Android ou iOS.
Fonctionnement
L'inspecteur d'annonces commence automatiquement à inspecter la diffusion d'annonces lorsque vous ouvrez votre application sur un appareil de test enregistré.
Vous devez interagir avec votre application pour faire en sorte que le nombre de demandes d'annonces à analyser soit suffisant. Notez qu'un ensemble de demandes d'annonces peut même s'afficher au démarrage de l'application si elle précharge les annonces.
Une fois que vous appelez l'inspecteur d'annonces sur votre appareil de test d'un simple geste ou via un appel d'API personnalisé, l'onglet "Blocs d'annonces" s'affiche. Il liste les blocs d'annonces de votre application dans l'ordre de leur dernière activité (qu'ils aient diffusé ou non une annonce). Un autre onglet vous permettant de vérifier les adaptateurs SDK tiers s'affiche également. En savoir plus sur les problèmes courants liés aux adaptateurs SDK
Remarque : Nous vous recommandons d'initialiser le SDK Google Mobile Ads avant d'utiliser l'inspecteur d'annonces, sans quoi vous ne pourrez pas consulter la liste complète de vos blocs d'annonces. En savoir plus sur l'initialisation du SDK Google Mobile Ads (Android, iOS)
De plus, les blocs d'annonces de votre application qui ne sont pas associés à votre identifiant d'application AdMob ne s'affichent que si au moins une demande a été satisfaite pour ces blocs d'annonces.
Appuyez sur un bloc d'annonces pour afficher le journal des requêtes SDK, qui détaille la cascade de médiation pour les dernières demandes d'annonces jusqu'au moment où elles ont été satisfaites ou la cascade s'est terminée sans remplissage. Vous pouvez alors développer chaque source d'annonce n'ayant pas rempli d'emplacement pour obtenir plus d'informations sur l'erreur "Pas de remplissage".
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 d'annonce tierce.
Tester des sources d'annonces spécifiques
L'inspecteur d'annonces vous permet de tester la configuration d'une source de cascade d'annonces tierce spécifique. Vous pouvez ainsi vérifier si vous avez correctement intégré l'adaptateur de médiation tiers et si la source d'annonce est diffusée comme prévu.
Pour lancer le test d'une source d'annonce spécifique, activez l'option Tester une source d'annonce spécifique en bas de l'application. Ensuite, sélectionnez la source d'annonce que vous souhaitez tester. Lorsque l'inspecteur d'annonces est activé pour tester une source d'annonce spécifique, toutes les demandes d'annonces ultérieures tentent d'afficher les annonces provenant de la source d'annonce sélectionnée.
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 déterminer si la source d'annonce a répondu aux demandes d'annonces effectuées après l'activation du test de la source d'annonce spécifique. Si la source d'annonce n'a répondu à aucune demande d'annonce, un message d'erreur s'affiche en indiquant pourquoi l'erreur "Pas de remplissage" s'est produite.
Si vous avez ajouté plusieurs instances de la source d'annonce sélectionnée à une cascade de médiation, cette dernière affichera chaque instance de l'appel à la source d'annonce jusqu'au moment où la demande d'annonce a été satisfaite ou la cascade s'est terminée sans remplissage.
Notez que le test d'une source d'annonce spécifique expire automatiquement au bout de 60 minutes.
Forcer le redémarrage
Lorsque vous activez le test d'une source d'annonce spécifique, vous devez forcer le redémarrage de votre application. Cela permet de s'assurer que ce test s'applique à chaque demande d'annonce de la session de test, car certaines applications mettent en cache les annonces au démarrage.
Pour les appareils Android, vous pouvez généralement forcer le redémarrage d'une application via l'option Paramètres de votre téléphone (qui peut être différente selon les modèles). Pour en savoir plus, adressez-vous au fabricant de votre appareil.
Découvrez comment forcer le redémarrage d'une application sur les appareils iOS.
Comprendre les problèmes liés aux adaptateurs SDK
Pour vérifier l'état de vos adaptateurs SDK, cliquez sur l'onglet Adaptateur.
Il est possible que vous rencontriez deux problèmes lors de la vérification de l'adaptateur SDK de votre source d'annonces tierce. Consultez les sections suivantes pour comprendre le problème et découvrir comment le résoudre.
Adaptateur introuvable
Certaines sources d'annonces tierces ont besoin d'un SDK et de son adaptateur spécifique SDK GMA pour charger et afficher des annonces à partir de cette source. Cette erreur signifie que le SDK GMA ne parvient pas à trouver votre SDK ou votre adaptateur tiers. Vérifiez que vous avez installé l'adaptateur SDK correctement. En savoir plus pour Android et iOS
Échec de l'initialisation
Chaque adaptateur SDK de source d'annonces tierce doit être explicitement initialisé dans votre codebase avec les paramètres nécessaires. Assurez-vous d'avoir bien suivi le guide d'intégration. En cas d'erreurs d'initialisation spécifiques, veuillez consulter la documentation de votre source d'annonces tierce. En savoir plus pour Android et iOS