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

Ce guide explique comment déboguer la diffusion d'annonces à l'aide de la prévisualisation dans une application et des outils de diffusion Ad Manager.

La prévisualisation dans une application vous permet d'inspecter vos propres créations affichées dans votre application mobile. Elle est particulièrement utile si vous disposez de créations qui interagissent avec l'application, ont un comportement spécifique ou dépendent de l'application pour un 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, vous pouvez utiliser ces outils pour en déterminer la raison.

Prérequis

  • SDK Google Mobile Ads 10.2.0 ou version ultérieure

Préparer votre application

Le débogage nécessite une interaction avec le menu des options de débogage du SDK. Pour ouvrir le menu, nous vous recommandons d'inclure la fonction suivante dans votre application et de 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")
  }
}

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 longuement sur la création avec deux doigts, mais cela ne fonctionne pas pour tous les formats d'annonces, comme les annonces natives. De plus, 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 fiable.

Après avoir ajouté la possibilité d'ouvrir le menu des options de débogage, exécutez votre application et déclenchez la fonction. Le menu suivant s'affiche :

Sélectionnez Aperçu de la création pour associer votre appareil. Un navigateur s'ouvre et vous redirige automatiquement vers une page où vous pouvez vous connecter à Ad Manager. Une fois connecté, nommez votre appareil pour l'enregistrer dans votre compte Ad Manager. Cliquez ensuite sur Valider.

Vous pouvez alors vérifier que votre appareil a été associé dans l'interface utilisateur Ad Manager. Vous pouvez également autoriser d'autres personnes à accéder à vos appareils.

Prévisualisation dans une application

Suivez la procédure 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 ciblant l'emplacement publicitaire où vous souhaitez l'afficher.

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 dans Ad Manager que l'association de l'appareil a réussi et d'obtenir des informations sur la création que vous avez transférée. Si l'association de l'appareil a réussi précédemment, le menu de débogage se ferme immédiatement. Si elle 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 effectué les étapes correctement, la requête s'affiche dans l'interface utilisateur Ad Manager et vous pouvez afficher plus d'informations sur l'annonce diffusée.