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.
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.
Les commandes vidéo natives sont-elles compatibles avec le SDK HTML5 ?
Non. Le SDK HTML5 n'est pas compatible avec les commandes natives.
Le message "Échec de l'exécution de "lecture" sur "HTMLMediaElement" : l'API ne peut être lancé que par un geste de l'utilisateur" s'affiche dans mon implémentation HTML5. Comment résoudre ce problème ?
Sur les appareils mobiles, vous devez appeler adDisplayContainer.initialize() à la suite d'une action de l'utilisateur (par exemple, une pression du doigt). Si vous voyez cette erreur, vous l'appelez probablement dans un contexte non déclenché par l'utilisateur. Notez qu'il doit s'agir du résultat direct d'une action de l'utilisateur. Par exemple, si vous répondez à un événement "Appuyer" en lisant une vidéo, puis que vous utilisez l'événement "play" du lecteur vidéo pour appeler initialize(), le SDK renvoie cette erreur. Vous devez appeler initialize() en tant que résultat de l'événement tactile lui-même.
Comment gérer les clics sur le clavier lors des clics sur les annonces ?
Si vous utilisez les commandes clavier de votre lecteur, vous remarquerez peut-être qu'elles ne fonctionneront plus après les clics sur le adDisplayContainer. En effet, lorsqu'un internaute clique sur une annonce, le curseur se place sur l'iFrame IMA. Pour conserver la sélection du clavier sur le lecteur de contenu, veuillez utiliser l'événement CLICK afin de replacer la sélection sur le conteneur souhaité. Pour en savoir plus, consultez l'extrait de code suivant : 
adsManager.addEventListener(
      google.ima.AdEvent.Type.CLICK,
      function(){
        window.focus();
        // Or another method to return focus to the desired container.
      });