Aperçu des créations et inspecteur de diffusion

Ce guide explique comment déboguer la diffusion d'annonces à l'aide de l'aperçu dans l'application et de l'inspecteur de diffusion.

L'aperçu dans une application vous permet d'afficher vos propres créations dans votre application mobile. Il est particulièrement utile pour les éditeurs dont les créations interagissent avec l'application, ont un comportement spécifique ou s'appuient sur l'application pour une partie de leur affichage (y compris les créations natives et MRAID).

L'inspecteur de diffusion fournit des informations sur les annonces diffusées. Utilisez l'inspecteur de diffusion pour savoir pourquoi des annonces inattendues sont diffusées.

Conditions préalables

  • Version 7.13.1 ou ultérieure du SDK Google Mobile Ads
  • Accès à un compte Google Ad Manager
  • Suivez les instructions de la section 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:

Swift

@IBAction func openDebugOptions(sender: AnyObject) {
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  let debugOptionsViewController = GADDebugOptionsViewController(adUnitID: "YOUR_AD_UNIT_ID")
  self.present(debugOptionsViewController, animated: true, completion: nil)
}

Objective-C

- (IBAction)openDebugOptions:(id)sender {
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  GADDebugOptionsViewController *debugOptionsViewController =
      [GADDebugOptionsViewController debugOptionsViewControllerWithAdUnitID:@"YOUR_AD_UNIT_ID"];
  [self presentViewController:debugOptionsViewController animated:YES completion:nil];
}

Pour ouvrir le menu des options de débogage, vous pouvez ajouter un bloc d'annonces valide dans votre compte Ad Manager.

Soyez averti lorsque le menu de débogage se ferme

Lorsque vous ouvrez le menu d'options de débogage par programmation, vous pouvez choisir d'implémenter GADDebugOptionsViewControllerDelegate pour être averti lorsque le contrôleur de vue est fermé. Pour ce faire, assurez-vous que votre classe est conforme au délégué:

Swift

import GoogleMobileAds
 
class ViewController: UIViewController, GADDebugOptionsViewControllerDelegate {
}

Objective-C

@import GoogleMobileAds;
 
@interface ViewController : UIViewController <GADDebugOptionsViewControllerDelegate> {
}
 
@end

Définissez le délégué sur votre GADDebugOptionsViewController:

Swift

@IBAction func openDebugOptions(sender: AnyObject) {
  let debugOptionsViewController = GADDebugOptionsViewController(adUnitID: "YOUR_AD_UNIT_ID")
  debugOptionsViewController.delegate = self
  self.present(debugOptionsViewController, animated: true, completion: nil)
}

Objective-C

- (IBAction)openDebugOptions:(id)sender {
  GADDebugOptionsViewController *debugOptionsViewController =
      [GADDebugOptionsViewController debugOptionsViewControllerWithAdUnitID:@"YOUR_AD_UNIT_ID"];
  debugOptionsViewController.delegate = self;
  [self presentViewController:debugOptionsViewController animated:YES completion:nil];
}

Enfin, implémentez le délégué:

Swift

func debugOptionsViewControllerDidDismiss(controller: GADDebugOptionsViewController) {
  print("Debug options view controller dismissed.")
}

Objective-C 

- (void)debugOptionsViewControllerDidDismiss:(GADDebugOptionsViewController *)controller {
  NSLog(@"Debug options view controller dismissed.");
}

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. Un 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, puis cliquez sur Valider.

Vous avez associé votre appareil. À ce stade, votre appareil est associé dans l'interface Ad Manager. Vous pouvez également autoriser d'autres personnes à accéder à vos appareils.

Aperçu dans l'application

Suivez les étapes permettant de transférer une création vers votre appareil associé. Vérifiez que la création transférée fait partie d'un élément de campagne actif ciblant l'espace publicitaire dans lequel vous souhaitez afficher la création.

Après avoir transféré une création depuis l'interface, déclenchez à nouveau le menu des options de débogage sur votre appareil, puis sélectionnez à nouveau Creative Preview. Cette étape permet au SDK de vérifier à nouveau Ad Manager pour vérifier que l'appareil a bien été associé et pour obtenir des informations sur la création que vous avez transférée. Si l'association de l'appareil a déjà abouti, 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 de voir votre création.

Inspecteur de diffusion

Suivez les étapes de la section Commencer le dépannage de l'application pour dépanner votre application. Si vous réussissez, la demande s'affiche dans l'interface Ad Manager, et vous pouvez consulter plus d'informations sur l'annonce diffusée.