Questions fréquentes sur le SDK Google Interactive Media Ads


Pourquoi est-ce que je ne reçois pas toutes les annonces pour tous les formats ?
Les tags d'emplacement publicitaire de test sont configurés de manière à toujours renvoyer des annonces pour les demandes valides. L'objectif est de faciliter l'intégration et de tester plus facilement la manière dont le lecteur demande et diffuse les annonces. Toutefois, les annonces ne sont pas toujours disponibles dans tous les formats pour votre site, votre compte ou votre bloc d'annonces. Si votre intégration fonctionne correctement pour le tag de test, mais pas pour votre propre tag, l'une des causes suivantes peut être en cause :
  • Vous diffusez des vidéos dans un format non compatible dans votre environnement. Par exemple, vous ne diffusez que des annonces HTML5 sur iOS ou Android.
  • Si vous utilisez Ad Manager, il est possible qu'aucune annonce ne soit ciblée pour votre référence éditeur pour le moment. Assurez-vous également d'avoir approuvé les annonces et créations pertinentes dans Ad Manager.
  • Si vous utilisez AdSense, il est possible que les critères de ciblage de votre site ou de votre page de test ne contiennent pas de publicité active. La cause la plus fréquente est l'utilisation de sites Web privés non explorés.
  • Si vous utilisez la gestion des partenaires du réseau Ad Exchange et que descriptionURL n'est pas défini ou ne figure pas sur la liste de gestion des domaines détenus ou gérés, les annonces ne sont pas diffusées dans ce cas.
  • Vérifiez les seuils minCPM définis dans Ad Exchange pour les vidéos. Un CPM assez élevé peut entraîner de très faibles taux de remplissage. Pour résoudre ce problème, essayez de supprimer le CPM minimal ou le paramètre de bloc d'annonces de la demande d'annonce (c'est-à-dire le nom d'espace publicitaire) pour vérifier si cela affecte le taux de remplissage.
À quoi ressemble un bon descriptionUrl ?
Pour être plus efficace, le contenu de la page vers laquelle descriptionUrl renvoie l'internaute ne doit pas être un ensemble de mots ou d'expressions, mais plutôt un ou trois paragraphes décrivant le contenu et le rôle de votre contenu. Une des méthodes qui ont été efficaces par le passé consiste à assembler le contenu de la page descriptionUrl de manière dynamique à partir de blocs prédéfinis. Par exemple, quelques phrases sur le contenu, quelques phrases sur l'offre de votre site, puis quelques extraits prédéfinis associés à chaque canal AdSense (comme "Divertissement" ou "Sports"). Par conséquent, chaque contenu est associé à un descriptionUrl raisonnablement distinct qui fournit à la fois des informations générales (telles que des descripteurs de genre) et des informations spécifiques (contenu directement lié au contenu).

Ce code HTML de métadonnées doit être simple, par exemple:

<html>
  <head>
    <title>Domain.com - Your tag line here!</title>
  </head>
  <body>
    <h1>Descriptions</h1>
    <h2>About this Content</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
    <h2>About Domain.com</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
  </body>
</html>
  
Pourquoi le message d'erreur "La réponse d'annonce ne contient pas un type d'annonce valide" s'affiche-t-il ?
Cette erreur se produit généralement car aucune annonce n'a été ciblée sur l'élément publisherId spécifique (pour la période donnée). Cette condition peut varier tout au long de la journée ou sur plusieurs jours à mesure que les campagnes commencent et se terminent. Vous devez vérifier que l'annonce que vous souhaitez cibler n'a pas expiré et que les critères de ciblage des annonces sont corrects. Tant que les annonces sont correctement demandées, reçues et affichées à l'aide de l'publisherId de test, vous pouvez vous assurer qu'elles sont correctement gérées à l'aide de votre publisherId en direct lorsqu'elles sont disponibles.
Avez-vous un tag publicitaire vidéo Ad Manager à utiliser pour les tests ?
Des exemples de tags sont disponibles sur la page Exemples de tags.
Dois-je définir adSlotWidth et adSlotHeight sur les mêmes valeurs que sz dans mon tag d'emplacement publicitaire Ad Manager ?
Pas forcément. Les propriétés adSlotWidth et adSlotHeight doivent être définies sur la largeur/hauteur du lecteur ou de la zone que vous souhaitez insérer dans vos annonces. Elles permettent à AdSense de déterminer les annonces disponibles pour s'adapter à cet espace. La paire clé-valeur sz dans votre tag d'emplacement publicitaire Ad Manager est un paramètre de ciblage. Elle n'a pas nécessairement d'incidence sur la création diffusée (plus d'informations ci-dessous).
Le tag d'emplacement publicitaire de démonstration semble parfait, mais lorsque je le remplace avec mon tag d'emplacement publicitaire, aucune annonce n'apparaît.
Assurez-vous qu'un élément fait l'objet d'un trafficking vers le tag d'emplacement publicitaire que vous demandez. Le plus simple est de surveiller le trafic HTTP. Si une image gris.gif 1 x 1 pixel est renvoyée dans un bloc d'ancrage HTML, vous devez vérifier votre ciblage dans Ad Manager.
Je souhaite demander plusieurs fois le même tag, mais je n'obtiens des annonces que pour ma première demande. Comment résoudre ce problème ?
Lorsque vous demandez des annonces plusieurs fois, vous devez indiquer à l'ad server qu'il s'agit de demandes légitimes et qu'il ne s'agit pas de doublons accidentels. Pour ce faire, le SDK vous propose deux appels d'API rapides :
  1. Appelez destroy() sur votre instance AdsManager. Cela permet d'empêcher la lecture des annonces vidéo post-roll lorsque vous effectuez l'appel ci-dessous à contentComplete(). Vous obtiendrez un nouveau AdsManager lorsque vous effectuerez votre prochaine requête.
  2. Appelez contentComplete() sur votre instance AdsLoader. Cette opération réinitialise le SDK pour que la nouvelle demande d'annonce ne ressemble pas à la précédente.
Après avoir effectué les deux appels ci-dessus, vous pouvez appeler requestAds() sur votre instance AdsLoader pour diffuser un autre ensemble d'annonces pour votre nouvelle vidéo.
Comment puis-je demander des annonces AdSense en superposition et en plein espace à l'aide du SDK IMA ?

Pour demander des annonces AdSense à l'aide du SDK, vous devez d'abord obtenir un tag d'emplacement publicitaire AdSense. Pour en savoir plus, consultez la page AdSense pour les vidéos. Une fois que vous avez obtenu votre tag, vous devez suivre les étapes ci-dessous pour effectuer une demande d'annonce en superposition ou en plein espace:

Annonces en superposition
  1. Dans votre AdsRequest, définissez vos ViewModes sur NORMAL.
  2. Dans votre tag d'emplacement publicitaire, ajoutez le paramètre overlay=1.
Annonces en plein espace
  1. Dans votre AdsRequest, définissez vos ViewModes sur FULLSCREEN.
  2. Dans votre tag d'emplacement publicitaire, ajoutez le paramètre overlay=0.
Je reçois le message d'erreur "URL de destination non valide" lorsque je clique sur mon annonce. Quelle peut en être la cause ?
Cette erreur se produit généralement en cas d'échappement incorrect de l'URL de destination. Si vous rencontrez cette erreur, vérifiez que votre URL de destination est correctement échappée dans votre réponse VAST.
Dans les SDK Android et iOS, est-il possible de rendre l'ensemble de l'annonce vidéo cliquable ?
En ce qui concerne le suivi des clics sur l'intégralité de la vidéo, l'expérience habituelle des spectateurs sur mobile est de constater qu'en appuyant dessus, la vidéo est mise en pause ou les commandes du lecteur s'affichent. Pour éviter que les utilisateurs ne cliquent involontairement sur des annonces alors qu'ils souhaitent uniquement accéder aux commandes du lecteur, le bouton En savoir plus permet aux utilisateurs de cliquer sur une annonce et d'en savoir plus sur le produit faisant l'objet de la publicité.
Pourquoi le message d'erreur "Document VAST vide" s'affiche-t-il ?
Cette erreur se produit lorsque le tag d'emplacement publicitaire renvoie un document VAST vide, indiquant que l'annonce n'a pas été diffusée correctement. Contactez votre responsable de compte ou votre représentant de serveur publicitaire pour savoir pourquoi votre tag d'emplacement publicitaire ne fonctionne pas.
Puis-je modifier la taille/le texte du champ Ignorer l'annonce ou d'autres éléments de l'interface utilisateur ?
Le SDK IMA ne permet pas de modifier la mise en page, la taille ni le contenu des éléments de l'interface utilisateur. Pour en savoir plus sur les éléments de l'interface utilisateur, consultez AdsManager.uiElements.
Pourquoi reçois-je le message d'erreur "Aucune méthode virtuelle" au moment de l'exécution ?

Les messages d'erreur semblables à ceux ci-dessous sont dus à l'utilisation d'une ancienne version des services Google Play qui n'inclut pas l'identifiant publicitaire.

No virtual method
getInfo()Lcom/google/android/gms/ads/identifier/AdvertisingIdClient$Info; in
class Lcom/google/android/gms/ads/identifier/AdvertisingIdClient; or its
super classes (declaration of 'com.google.android.gms.ads.identifier.AdvertisingIdClient'

La mise à niveau vers la version 4.0 ou ultérieure (mais de préférence la plus récente) permet de résoudre ce problème.

Puis-je utiliser plusieurs threads pour initialiser et manipuler l'UI ?
Non. Toutes les opérations d'initialisation et de manipulation de l'interface utilisateur doivent être effectuées sur le thread principal. Sous Android, les objets de l'interface utilisateur ne sont pas sécurisés. Pour en savoir plus, consultez Threads.