Blocs d'annonces de test

Sélectionnez la plate-forme : Android (bêta) Nouveau Android iOS Unity Flutter

L'inspecteur d'annonces est compatible avec les tests suivants :

  • Test en contexte : chargez des annonces à partir des blocs d'annonces de votre application. Vous pouvez ouvrir l'inspecteur d'annonces pour afficher des informations sur les requêtes effectuées à partir de blocs d'annonces.
  • Test hors contexte : testez votre bloc d'annonces directement dans l'inspecteur d'annonces sans accéder à l'interface utilisateur de votre application. Vous pouvez tester plusieurs blocs d'annonces à la fois, charger et afficher de manière asynchrone vos demandes d'annonces tests, et effectuer des tests de source d'annonce unique.

Lorsque vous effectuez un test hors contexte, vos requêtes ne comportent pas les paramètres nécessaires pour s'exécuter dans l'interface utilisateur de votre application, y compris la configuration du traitement destiné aux enfants, le ciblage personnalisé, les options réseau et les différentes tailles. En raison de la limitation de ces requêtes, nous vous recommandons d'utiliser les tests en contexte dans l'interface utilisateur de votre application.

Prérequis

Avant de continuer, procédez comme suit :

  • Effectuez toutes les étapes des prérequis initiaux Prerequisites pour créer un compte Ad Manager, configurer votre appareil de test, initialiser Google Mobile Ads SDK, et installer la dernière version.
  • Lancez l'inspecteur d'annonces.

Demander une annonce test

Pour demander une annonce test dans l'inspecteur d'annonces, procédez comme suit. Pour en savoir plus, consultez Inspecteur d'annonces (bêta).

  • En contexte :

    1. Sur un appareil de test, accédez à l'interface utilisateur de votre application et chargez une annonce.
    2. Ouvrez l'inspecteur d'annonces. Dans l'onglet Bloc d'annonces, recherchez le bloc d'annonces dans lequel vous avez chargé l'annonce.
    3. Dans Journal des requêtes SDK, affichez les détails de l'annonce test demandée.
  • Out-of-context:

    1. Dans l'onglet Bloc d'annonces , appuyez sur votre bloc d'annonces, puis cliquez sur Demander une annonce test.
    2. Dans Journal des requêtes SDK, affichez les détails de l'annonce test demandée.

Si le format du bloc d'annonces affiche Inconnu, l'option Demander une annonce test est grisée. Si vous demandez plusieurs formats pour un seul bloc d'annonces, l'inspecteur d'annonces utilise le dernier bloc d'annonces.

Personnaliser une annonce test

L'inspecteur d'annonces vous permet de créer une annonce test personnalisée sur la page Configurer une demande d'annonce personnalisée. Cette page contient des paramètres que vous utilisez pour définir et demander une annonce test personnalisée. Pour demander une annonce test avec les paramètres par défaut, suivez Demander une annonce test.

Pour créer une annonce test personnalisée, procédez comme suit :

  1. Dans l'onglet Bloc d'annonces, appuyez sur le bloc d'annonces pour lequel vous souhaitez créer une annonce test personnalisée.
  2. Cliquez sur modifierModifier:

    Page du journal des requêtes SDK avec l'icône de modification

    La page Configurer une demande d'annonce personnalisée s'affiche. L'exemple suivant montre la page Configurer une demande d'annonce personnalisée pour une annonce de type bannière :

    Configurer une page de demande d'annonce personnalisée pour une bannière publicitaire

  3. Saisissez votre demande d'annonce et vos informations dans les champs suivants :

    • Demande d'annonce:
      • URL du contenu : URL du contenu environnant. Pour en savoir plus, consultez URL du contenu.
      • URL du contenu voisin : URL du contenu qui s'affiche avant et après une annonce. Pour en savoir plus, consultez Mappage de contenu pour les applications.
      • Exclusions de catégories : bloque les annonces de certains annonceurs, marques, ou catégories. Pour en savoir plus, consultez Exclusions de catégories.
      • ID fourni par l'éditeur : définissez un identifiant dans la limitation de la fréquence d'exposition et les commandes de diffusion des annonces en fonction de l'audience sur les différents types d'appareil. Pour en savoir plus, consultez Identifiants fournis par l'éditeur.
    • En fonction du format de l'annonce, saisissez les informations suivantes :
      • Annonces de type bannière : saisissez la largeur et la hauteur de l'annonce. Pour en savoir plus, consultez Annonces de type bannière.
      • Annonces natives:
        • Format du contenu multimédia : sélectionnez le format de contenu multimédia de votre choix. Pour en savoir plus, consultez Afficher une annonce native en plein écran.
        • Désactiver le chargement des images : indique si Google Mobile Ads SDK doit charger le contenu de l'élément d'image. Pour en savoir plus, consultez Contrôle du téléchargement d'images.
        • Ignorer cette annonce personnalisée : indique si vous souhaitez utiliser la fonctionnalité personnalisée "Ignorer cette annonce". Pour en savoir plus, consultez setRequestCustomMuteThisAd.
        • Position préférée des choix publicitaires : indique l'emplacement préféré de l'icône Choix publicitaires. Pour en savoir plus, consultez Emplacements Choix publicitaires.
    • Options vidéo :

      • Démarrer en mode silencieux : activez cette option pour désactiver le son de votre contenu au démarrage. Pour en savoir plus, consultez Comportement de démarrage en mode silencieux.
      • Cliquer pour développer demandé : indique si la vidéo demandée doit avoir le comportement "Cliquer pour développer". Pour en savoir plus, consultez setClickToExpandRequested.
  4. Cliquez sur Demander une annonce test personnalisée. Si l'opération réussit, l'annonce test personnalisée s'affiche dans le Journal des requêtes SDK.

Tester une source d'annonce unique

L'inspecteur d'annonces peut limiter les demandes d'annonces dans votre application afin de diffuser des annonces à partir d'une seule source d'annonces d'enchères ou de cascade. Cette approche vous permet de vérifier que vous avez correctement intégré l'adaptateur tiers et que la source d'annonces est diffusée comme prévu.

Pour tester une source d'annonce unique, procédez comme suit :

  1. Dans l'inspecteur d'annonces, cliquez sur le bouton Test d'une source d'annonce unique. Une boîte de dialogue Test d'une source d'annonce unique s'affiche :

  2. Sélectionnez une source d'annonces à tester. Vous recevez ensuite la page Forcer le redémarrage de l'application :

Le paramètre de test de source d'annonce unique s'applique à toutes les demandes d'annonces futures que vous effectuez. Ce test ne s'applique pas aux annonces mises en cache précédemment dans cette session. Nous vous recommandons de forcer le redémarrage de votre application lorsque vous appliquez un test de source d'annonce unique. Cette approche invalide les annonces mises en cache qui pourraient s'afficher au lieu de la source d'annonces choisie recevant une demande.

Après avoir redémarré votre application, tous les emplacements de blocs d'annonces tentent d'afficher une annonce provenant de la source d'annonces sélectionnée. Le lancement de l'inspecteur d'annonces lorsqu'un test de source d'annonce unique est actif affiche la source d'annonces test active :

En mode de test de source d'annonce unique, toutes les demandes d'annonces tentent de se remplir avec la source d'annonces sélectionnée, que cette source d'annonces ait été configurée pour les enchères ou la cascade. Si la source d'annonces que vous testez n'est pas configurée pour les enchères ou la cascade pour le bloc d'annonces, le message d'erreur suivant s'affiche :

Ad Unit has no applicable adapter for single ad source testing on network: AD_SOURCE_ADAPTER_CLASS_NAME

Pour vérifier si la source d'annonces a rempli les demandes d'annonces après le démarrage d'un test de source d'annonce unique, appuyez sur un bloc d'annonces pour afficher le journal des requêtes SDK. Si la source d'annonces n'a pas réussi à charger une annonce, un message d'erreur s'affiche, décrivant l'erreur, par exemple Adapter failed to initialize.

Si vous avez ajouté plusieurs instances de la source d'annonces sélectionnée à une cascade, vous voyez chaque instance d'appel à la source d'annonces. Ce processus s'affiche jusqu'à ce que l'annonce soit remplie ou que la cascade se termine sans remplissage.

Arrêter un test de source d'annonce unique

Pour arrêter le test, procédez comme suit :

  1. Dans l'inspecteur d'annonces, désactivez le bouton Test d'une source d'annonce unique. La boîte de dialogue Arrêter le test d'une source d'annonce unique ? s'affiche.
  2. Appuyez sur Arrêter le test.

    Si l'opération réussit, un message de confirmation s'affiche au-dessus de Forcer le redémarrage de l'application :

Pour révoquer les annonces mises en cache pour la source d'annonces testée, nous vous recommandons de forcer le redémarrage de l'application après avoir arrêté le test.