Pour les annonces pour mobile Unity 7.0.0 et versions ultérieures, 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 ensemble les détails des enchères et de la médiation en cascade pour chaque réseau publicitaire et chaque demande
- Tester des sources d'annonces tierces pour les enchères et la médiation
Vérifiez que vous avez correctement configuré chaque bloc d'annonces pour les enchères et la médiation en cascade.
Tester les intégrations d'événements personnalisés
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 Unity Mobile Ads7.0.0 ou version ultérieure.
- Ajoutez votre appareil en tant qu'appareil de test. L'inspecteur d'annonces ne se lance que sur les appareils de test.
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 geste sélectionné dans l'interface utilisateur AdMob lors de l'enregistrement d'un appareil de test.
- Par programmation à l'aide de l'API fournie
- Utilisez le bouton de lancement dans le menu de débogage.
Lancer à l'aide de gestes
Aucune modification n'est requise de votre application pour lancer l'inspecteur d'annonces par un geste. Il vous suffit d'effectuer le geste (double effleurement ou secouer) que vous avez configuré dans AdMob pour cet appareil de test. En savoir plus
Après avoir défini un geste dans l'interface utilisateur AdMob (et attendu 15 minutes pour qu'il se propage), votre application doit envoyer une demande d'annonce pour que le SDK Google Mobile Ads puisse en savoir plus sur le paramètre de geste. Si le geste que vous avez spécifié ne fonctionne pas, 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:
public void OnButtonClick() {
MobileAds.OpenAdInspector(error => {
// Error will be set if there was an issue and the inspector was not displayed.
});
}
Cette API fonctionne pour les appareils de test enregistrés de manière programmatique ou dans l'interface utilisateur AdMob.
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 dans l'UI AdMob associé à votre ID d'application AdMob ayant des configurations d'enchères ou de médiation:
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 débutez avec les enchères, consultez la présentation.
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 procédure de dépannage des problèmes.
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 contacter directement la source pour obtenir de l'aide.
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.
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 les exemples 2 et exemple 3 de sources d'annonces associées à des enchères et participant à la cascade d'annonces dans un groupe de médiation.
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 AdMob 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 WebAdMob .
Si l'adaptateur est introuvable ou ne s'initialise pas, 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 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 votreAdMob 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.