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

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 spécifique ou s'appuient sur l'application pour un certain 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, utilisez les outils de diffusion pour en savoir plus.

Prérequis

  • Version 10.2.0 ou ultérieure du SDK Google Mobile Ads.

Préparer votre application

Le débogage nécessite d'interagir avec le menu d'options de débogage du SDK. La méthode recommandée pour ouvrir le menu consiste à inclure la fonction suivante 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.
  // 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.
  // Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  fun openDebugMenu() {
    MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID")
  }
}

Tout bloc d'annonces valide de 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. Toutefois, cela ne fonctionne pas pour tous les formats d'annonces, comme les annonces natives, et vous devez veiller à ne pas cliquer sur l'annonce lorsque vous essayez de balayer l'écran. L'appel de la méthode précédente est beaucoup plus robuste.

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'ouvre :

Sélectionnez Creative Preview pour associer votre appareil. Un navigateur s'ouvre et vous redirige automatiquement vers une page de connexion à Ad Manager. Après vous être connecté, nommez votre appareil pour l'enregistrer dans votre compte Ad Manager. puis cliquez sur Valider.

À ce stade, vous pouvez vérifier que votre appareil a été associé dans l'interface utilisateur d'Ad Manager. Vous pouvez également permettre à d'autres utilisateurs d'accéder à vos appareils.

Aperçu dans l'application

Suivez la procédure pour envoyer une création vers votre appareil associé. Assurez-vous que la création envoyée fait partie d'un élément de campagne actif ciblant l'espace publicitaire dans lequel vous souhaitez diffuser la création.

Après avoir envoyé une création depuis l'UI, déclenchez à nouveau le menu d'options de débogage sur votre appareil, puis sélectionnez une nouvelle fois Creative Preview. Cette étape permet au SDK de vérifier dans Ad Manager que l'association de l'appareil a bien été effectuée et d'obtenir des informations sur la création que vous avez envoyée. 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é à 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 suivi la procédure correctement, la demande s'affiche dans l'UI d'Ad Manager, et vous pouvez afficher plus d'informations sur l'annonce diffusée.