Aperçu des créations et outils de diffusion

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 vous avez des créations qui interagissent avec l'application, ont un comportement unique ou dépendent de l'application pour certains rendus (y compris les 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 outils de diffusion pour savoir pourquoi.

Prérequis

• Version 10.2.0 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:

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");
  }
}

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 de votre compte Ad Manager suffit à ouvrir le menu des options de débogage.

Vous pouvez également ouvrir le menu en appuyant de manière prolongée à deux doigts sur la création. Toutefois, cette méthode ne fonctionne pas avec tous les formats d'annonces, comme les annonces natives. De plus, vous devez faire attention à ne pas cliquer sur l'annonce lorsque vous essayez de balayer l'écran. L'appel de la méthode ci-dessus est beaucoup plus robuste.

Associer votre appareil

Après avoir ajouté la capacité 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 (Aperçu de la création) pour associer votre appareil. Un navigateur s'ouvre et vous permet de vous connecter automatiquement à Ad Manager. Après vous être connecté, nommez 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 du Gestionnaire d'annonces. Vous pouvez également autoriser d'autres utilisateurs à accéder à vos appareils.

Aperçu dans l'application

Suivez la procédure pour transférer une création vers votre appareil associé. Assurez-vous que la création transmise 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 Aperçu de la création. Cette étape permet au SDK de vérifier Ad Manager pour s'assurer que l'association de l'appareil a réussi et d'obtenir des informations sur la création que vous avez transmise. Si l'association de l'appareil a déjà réussi, le menu de débogage se ferme immédiatement. Si l'association a échoué, vous êtes invité à réassocier votre compte.

Enfin, chargez une annonce pour l'espace publicitaire que vous souhaitez prévisualiser pour voir votre création.

Outils de diffusion

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