Outils de prévisualisation et de diffusion des créations

Ce guide explique comment déboguer la diffusion d'annonces à l'aide de la prévisualisation dans une application et des outils de diffusion Ad Manager.

La prévisualisation dans une application vous permet d'inspecter vos propres créations affichées dans votre application mobile. Elle est particulièrement utile si vous disposez de créations qui interagissent avec l'application, ont un comportement spécifique ou dépendent de l'application pour un rendu (y compris les créations natives et MRAID).

Les outils de diffusion Ad Manager fournissent des informations sur les annonces diffusées. Ainsi, lorsque des annonces inattendues sont diffusées, vous pouvez utiliser ces outils pour en déterminer la raison.

Prérequis

Préparer votre application

Le débogage nécessite une interaction avec le menu d'options de débogage du SDK. Pour ouvrir le menu, nous vous recommandons d'inclure la fonction suivante dans votre application et de la déclencher en fonction d'une action de l'utilisateur :

Kotlin

// Opens a debug menu. Call this method based on a user action.
// Pass any Ad Manager ad unit ID associated with the app that you want to debug.
MobileAds.openDebugMenu(activity, "AD_UNIT_ID")

Java

// Opens a debug menu. Call this method based on a user action.
// Pass any Ad Manager ad unit ID associated with the app that you want to debug.
MobileAds.openDebugMenu(activity, "AD_UNIT_ID");

N'importe quel bloc d'annonces valide de votre compte Ad Manager suffit à ouvrir le menu d'options de débogage.

Vous pouvez également ouvrir le menu en appuyant longuement sur la création avec deux doigts , mais cela ne fonctionne pas pour tous les formats d'annonces, comme les annonces natives. Vous devez également veiller à ne pas cliquer sur l'annonce lorsque vous tentez de balayer l'écran. L'appel de la méthode précédente est beaucoup plus fiable.

Après avoir ajouté la capacité d'ouvrir le menu d'options de débogage, exécutez votre application et déclenchez la fonction. Le menu suivant s'affiche :

Sélectionnez Creative Preview pour associer votre appareil. Un navigateur s'ouvre et vous redirige automatiquement vers une page où vous pouvez vous connecter à Ad Manager. Une fois connecté, nommez votre appareil pour l'enregistrer dans votre compte Ad Manager. Cliquez ensuite sur Valider.

Vous pouvez alors vérifier que votre appareil a été associé dans l'interface utilisateur Ad Manager. Vous pouvez également autoriser d'autres personnes à accéder à vos appareils.

Prévisualisation dans une application

Suivez la procédure pour transférer une création vers votre appareil associé. Assurez-vous que la création transférée fait partie d'un élément de campagne actif ciblant l'emplacement publicitaire où vous souhaitez l'afficher.

Après avoir transféré une création depuis l'interface utilisateur, déclenchez à nouveau le menu d'options de débogage sur votre appareil et sélectionnez Creative Preview. Cette étape permet au SDK de vérifier dans Ad Manager que l'association de l'appareil a réussi et d'obtenir des informations sur la création que vous avez transférée. Si l'association de l'appareil a réussi précédemment, le menu de débogage se ferme immédiatement. Si elle a échoué, vous êtes invité à associer à nouveau votre compte.

Enfin, chargez une annonce pour l'emplacement que vous souhaitez prévisualiser afin de voir votre création.

Outils de diffusion

Suivez les étapes décrites dans Inspecter la diffusion dans Ad Manager pour résoudre les problèmes de diffusion de vos annonces. Si vous avez correctement suivi les étapes, la requête s'affiche dans l'interface utilisateur Ad Manager et vous pouvez afficher plus d'informations sur l'annonce diffusée.