Ce guide explique comment déboguer la diffusion d'annonces à l'aide de l'aperçu dans l'application et des outils de diffusion Ad Manager.
L'aperçu dans l'application vous permet d'inspecter vos propres créations affichées dans votre application mobile. Cet aperçu est particulièrement utile si certaines de vos créations interagissent avec l'application, ont un comportement spécifique ou si vous utilisez l'application pour un affichage (y compris des créations natives et MRAID).
Les outils de diffusion Ad Manager fournissent des informations sur les annonces diffusées. Par conséquent, lorsque des annonces inattendues sont diffusées, utilisez-les pour en connaître la raison.
Prérequis
- Version 10.2.0 ou ultérieure du SDK Google Mobile Ads
- Un accès à un compte Google Ad Manager
- Suivez les instructions de la section Premiers pas.
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")
}
}
Pour ouvrir le menu des options de débogage, il suffit d'utiliser un bloc d'annonces valide de votre compte Ad Manager.
Vous pouvez également ouvrir le menu en appuyant de manière prolongée avec deux doigts sur la création. Toutefois, cela ne fonctionnera pas pour tous les formats d'annonces, tels que les annonces natives. Veillez à ne pas cliquer sur l'annonce lorsque vous essayez de balayer l'écran. L'appel de la méthode ci-dessus est beaucoup plus efficace.
Associer votre appareil
Après avoir ajouté la possibilité d'ouvrir le menu des 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 dans votre compte Ad Manager. Cliquez ensuite sur 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 l'appareil associé. Assurez-vous que la création transférée fait partie d'un élément de campagne actif ciblant l'espace publicitaire dans lequel vous souhaitez la diffuser.
Après avoir transféré une création depuis l'interface utilisateur, déclenchez à nouveau le menu des options de débogage sur votre appareil et sélectionnez à nouveau Creative Preview. Cette étape permet au SDK de vérifier dans Ad Manager que l'appareil a bien été associé et d'obtenir des informations sur la création que vous avez transférée. Si l'appareil a déjà été associé, le menu de débogage se ferme immédiatement. Si l'opération a échoué, 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 de vos annonces. Si vous avez terminé ces étapes, la demande s'affiche dans l'interface utilisateur d'Ad Manager. Vous pouvez alors obtenir plus d'informations sur l'annonce diffusée.
