Ce guide explique comment déboguer la diffusion des annonces à l'aide de l'aperçu dans l'application et des outils de diffusion Ad Manager.
L'aperçu dans une application vous permet d'inspecter vos propres créations affichées dans votre application mobile. Il est particulièrement utile si certaines de vos créations interagissent avec l'application, ont un comportement unique ou dépendent de l'application pour certains affichages (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, utilisez les outils de diffusion pour en découvrir la raison.
Conditions préalables
- Le SDK Google Mobile Ads doit disposer de la version 10.2.0 ou ultérieure.
- Un accès à un compte Google Ad Manager.
- Suivez la procédure Commencer.
Préparer votre application
Le débogage nécessite une interaction avec le menu d'options de débogage du SDK. La méthode recommandée pour ouvrir le menu consiste à inclure la fonction ci-dessous dans votre application et à la déclencher en fonction d'une action de l'utilisateur:
Java
public class MainActivity extends AppCompatActivity {
...
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// Initialize the Mobile Ads SDK.
MobileAds.initialize(this);
}
...
// Opens a debug menu. Call this method based on a user action.
// TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
public void openDebugMenu() {
MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID");
}
}
Kotlin
class MainActivity : AppCompatActivity() {
...
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
// Initialize the Mobile Ads SDK.
MobileAds.initialize(this)
}
...
// Opens a debug menu. Call this method based on a user action.
// TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
fun openDebugMenu() {
MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID")
}
}
N'importe quel bloc d'annonces valide dans votre compte Ad Manager suffit pour ouvrir le menu des options de débogage.
Vous pouvez également ouvrir le menu en appuyant de manière prolongée avec deux doigts sur la création, mais cela ne fonctionnera pas pour tous les formats d'annonces, tels que les annonces natives. Veillez à ne pas cliquer sur l'annonce lorsque vous tentez de balayer l'écran. L'appel de la méthode ci-dessus est beaucoup plus robuste.
Associer votre appareil
Après avoir ajouté la possibilité d'ouvrir le menu d'options de débogage, exécutez votre application et déclenchez la fonction ci-dessus. Le menu suivant s'ouvre:
Sélectionnez Creative Preview pour associer votre appareil. Une fenêtre de navigateur s'ouvre et vous redirige automatiquement vers un navigateur pour vous connecter à Ad Manager. Une fois connecté, attribuez un nom à votre appareil pour l'enregistrer avec votre compte Ad Manager. Cliquez ensuite sur Verify (Valider).
À ce stade, vous pouvez vérifier que votre appareil a été associé dans l'interface utilisateur d'Ad Manager. Vous pouvez également autoriser d'autres personnes à accéder à vos appareils.
Aperçu dans l'application
Suivez les étapes 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 ciblé sur l'espace publicitaire dans lequel vous souhaitez la créer.
Après avoir transféré une création depuis l'interface utilisateur, activez à nouveau le menu des options de débogage sur votre appareil, puis sélectionnez de nouveau Creative Preview. Cette étape permet au SDK de vérifier Ad Manager pour s'assurer que l'appareil a bien été associé et pour obtenir des informations sur la création transférée. Si l'appareil a déjà été associé, le menu de débogage se ferme immédiatement. En cas d'échec, vous êtes invité à réassocier votre compte.
Enfin, chargez une annonce pour l'espace publicitaire que vous souhaitez prévisualiser afin d'afficher votre création.
Outils de diffusion
Suivez les étapes de la section Inspecter la diffusion dans Ad Manager pour résoudre les problèmes de diffusion des annonces. Si vous avez terminé ces étapes, la demande s'affiche dans l'interface utilisateur d'Ad Manager et vous pouvez consulter plus d'informations sur l'annonce diffusée.
