Häufig gestellte Fragen zum Google Interactive Media Ads SDK


Warum sehe ich keine Anzeigen für alle Formate?
Die Testanzeigen-Tags sind so eingerichtet, dass bei gültigen Anfragen immer Anzeigen zurückgegeben werden. Dies soll die Integration vereinfachen und es leichter machen, zu testen, wie Ihr Player Anzeigen anfordert und rendert. Anzeigen sind jedoch nicht immer in jedem Format für Ihre Website, Ihr Konto oder Ihren Anzeigenblock verfügbar. Wenn die Integration für das Test-Tag, aber nicht für Ihr eigenes Tag ordnungsgemäß funktioniert, kann dies folgende Gründe haben:
  • Sie stellen Videos in einem nicht unterstützten Format in Ihrer Umgebung bereit. So werden beispielsweise nur HTML5-Anzeigen für iOS oder Android ausgeliefert.
  • Wenn Sie Ad Manager verwenden, sind derzeit keine Publisher-IDs für das Targeting von Anzeigen verfügbar. Prüfen Sie außerdem, ob Sie die relevanten Anzeigen und Creatives in Ad Manager genehmigt haben.
  • Wenn du AdSense verwendest, sind für die Ausrichtungskriterien deiner Website oder Testseite möglicherweise keine aktiven Anzeigen vorhanden. Die häufigste Ursache ist die Verwendung privater, nicht gecrawlter Websites.
  • Wenn Sie die Verwaltung von Werbenetzwerkpartnern in Ad Exchange verwenden und descriptionURL nicht festgelegt ist oder nicht auf der Verwaltungsliste der eigenen oder von Ihnen betriebenen Domains aufgeführt ist, werden Anzeigen nicht ausgeliefert.
  • Prüfen Sie die in Ad Exchange für Videos definierten minCPM-Grenzwerte. Ein relativ hoher CPM kann zu sehr niedrigen Ausführungsraten führen. Sie können den Fehler beheben, indem Sie entweder den min. CPM entfernen oder den Anzeigenblockparameter aus der Anzeigenanfrage (d. h. Slotname) entfernen. So können Sie feststellen, ob sich dies auf die Ausführungsrate auswirkt.
Was macht ein gutes descriptionUrl aus?
Um möglichst effektiv zu sein, sollte der Inhalt der Seite, auf die descriptionUrl verweist, keine Sammlung von Wörtern oder Wortgruppen, sondern ein bis drei Absätze sein, die den Inhalt und deine Rolle bei der Bereitstellung des Inhalts beschreiben. Eine Methode, die in der Vergangenheit erfolgreich war, besteht darin, descriptionUrl-Seiteninhalt dynamisch aus vordefinierten Blöcken zusammenzufügen. Beispielsweise ein paar Sätze über den Inhalt, ein paar Sätze über das Angebot eurer Website und dann einige vordefinierte Snippets, die jedem AdSense-Channel zugeordnet sind (z. B. „Unterhaltung“ oder „Sport“). Daher ist jedem Inhalt ein angemessen eindeutiger descriptionUrl zugeordnet, der sowohl allgemeine Informationen (z. B. Genre-Deskriptoren) als auch spezifische Informationen (Inhalte) direkt enthält.

Der Metadaten-HTML-Code sollte einfach sein. Beispiel:

<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>
  
Warum erhalte ich die Fehlermeldung „Die Anzeigenantwort enthält keinen gültigen Anzeigentyp“?
Dieser Fehler tritt in der Regel auf, weil im angegebenen Zeitraum keine Anzeigen auf die jeweilige publisherId ausgerichtet sind. Diese Bedingung kann im Laufe des Tages oder über mehrere Tage zu Beginn und am Ende der Kampagnen variieren. Prüfen Sie, ob die Anzeige, auf die Sie eine Ausrichtung vornehmen möchten, nicht abgelaufen ist und die Kriterien für die Anzeigenausrichtung korrekt sind. Solange Anzeigen mit dem Test-publisherId angefordert, empfangen und gerendert werden, kannst du sicher sein, dass diese Anzeigen mit deiner Live-publisherId ordnungsgemäß verarbeitet werden, wenn die Anzeigen verfügbar sind.
Haben Sie ein Ad Manager-Videoanzeigen-Tag, das ich zum Testen verwenden kann?
Beispiel-Tags sind auf der Seite Beispiel-Tags verfügbar.
Sollte ich adSlotWidth und adSlotHeight auf dieselben Werte wie die sz in meinem Ad Manager-Anzeigen-Tag festlegen?
Nicht unbedingt. Für adSlotWidth und adSlotHeight muss die Breite/Höhe des Players oder des Bereichs festgelegt werden, mit dem Sie Ihre Anzeigen füllen möchten. Sie werden von AdSense verwendet, um zu ermitteln, welche Anzeigen in diesen Bereich passen. Das Schlüssel/Wert-Paar sz in Ihrem Ad Manager-Anzeigen-Tag ist ein Targeting-Parameter, der sich nicht zwangsläufig auf das ausgelieferte Creative auswirkt. Weitere Informationen finden Sie unten.
Das Demoanzeigen-Tag sieht gut aus, aber wenn ich es mit meinem Anzeigen-Tag ändere, wird keine Anzeige eingeblendet.
Prüfen Sie, ob das Trafficking für das angeforderte Anzeigen-Tag erfolgt. Am einfachsten ist es, den HTTP-Traffic zu beobachten. Wenn in einem HTML-Ankerblock ein 1 x 1-Pixel großes graues GIF-Bild zurückgegeben wird, müssen Sie das Targeting in Ad Manager überprüfen.
Ich möchte Anzeigen mehrmals mit demselben Tag anfragen, aber ich erhalte nur Anzeigen für meine erste Anfrage. Was kann ich tun?
Wenn Sie Anzeigen mehrmals anfordern, müssen Sie den Ad-Server darüber informieren, dass es sich dabei um legitime Anfragen und nicht um versehentliche Duplikate handelt. Das SDK übernimmt dies mit zwei kurzen API-Aufrufen:
  1. Rufen Sie destroy() auf Ihrer AdsManager-Instanz auf. Dadurch wird verhindert, dass Post-Rolls abgespielt werden, wenn du contentComplete() aufrufst. Sie erhalten ein neues AdsManager, wenn Sie Ihre nächste Anfrage stellen.
  2. Rufen Sie contentComplete() auf der Instanz AdsLoader auf. Dadurch wird das SDK zurückgesetzt, sodass die neue Anzeigenanfrage nicht wie die vorherige Anfrage aussieht.
Nachdem Sie die beiden obigen Aufrufe ausgeführt haben, können Sie requestAds() auf Ihrer AdsLoader-Instanz aufrufen, um weitere Anzeigen für Ihr neues Video abzurufen.
Wie fordere ich Overlay- und Full-Slot-AdSense-Anzeigen mit dem IMA SDK an?

Wenn Sie AdSense-Anzeigen über das SDK anfordern möchten, müssen Sie zuerst ein AdSense-Anzeigen-Tag abrufen. Weitere Informationen dazu findest du auf der Seite AdSense für Videos. Sobald du das Tag hast, musst du die folgenden Schritte ausführen, um entweder eine Overlay- oder eine Full-Slot-Anzeigenanfrage zu senden:

Overlay-Anzeigen
  1. Legen Sie in AdsRequest die ViewModes auf NORMAL fest.
  2. Fügen Sie in Ihrem Anzeigen-Tag den Parameter overlay=1 ein.
Anzeigen für Full-Slot-Anzeigen
  1. Legen Sie in AdsRequest die ViewModes auf FULLSCREEN fest.
  2. Fügen Sie in Ihrem Anzeigen-Tag den Parameter overlay=0 ein.
Ich erhalte die Fehlermeldung „Ungültige Klick-URL“, wenn ich auf meine Anzeige klicke. Woran könnte das liegen?
Der häufigste Grund für diesen Fehler ist eine falsch maskierte Klick-URL. Falls dieser Fehler auftritt, prüfen Sie, ob die Klick-URL in der VAST-Antwort richtig maskiert ist.
Warum wird die Fehlermeldung „Leeres VAST-Dokument“ angezeigt?
Dieser Fehler tritt auf, wenn das Anzeigen-Tag ein leeres VAST-Dokument zurückgibt. Das bedeutet, dass die Anzeige nicht richtig ausgeliefert wurde. Wenden Sie sich an Ihren Account Manager oder Ad-Server-Ansprechpartner, um zu erfahren, warum Ihr Anzeigen-Tag nicht funktioniert.
Kann ich die Größe bzw. den Text des Felds Anzeige überspringen oder andere UI-Elemente ändern?
Das IMA SDK kann das Layout, die Größe oder den Inhalt von UI-Elementen nicht ändern. Weitere Informationen zu UI-Elementen finden Sie unter AdsManager.uiElements.
Werden native Videosteuerelemente mit dem HTML5 SDK unterstützt?
Nein, das HTML5 SDK unterstützt keine nativen Steuerelemente.
Ich sehe in meiner HTML5-Implementierung die Meldung, dass die Wiedergabe bei HTMLHTMLElement nicht ausgeführt werden kann: API kann nur durch eine Nutzergeste ausgelöst werden. Was kann ich tun?
Auf Mobilgeräten müssen Sie adDisplayContainer.initialize() als Ergebnis einer Nutzeraktion (z. B. Tippen) aufrufen. Wenn dieser Fehler auftritt, rufen Sie ihn wahrscheinlich in einem Kontext auf, der nicht vom Nutzer initiiert wird. Es muss das direkte Ergebnis einer Nutzeraktion sein. Wenn du beispielsweise auf ein „tippen“-Ereignis mit der Wiedergabe eines Videos reagierst und anschließend das „play“-Ereignis des Videoplayers verwendest, um initialize() aufzurufen, gibt das SDK diesen Fehler zurück. Du musst initialize() als Ergebnis des Tippereignisses selbst aufrufen.
Wie handhabe ich den Tastaturfokus auf Anzeigenklicks?
Wenn du die Tastatursteuerung für deinen Player verwendest, kann es sein, dass er nach dem Klicken auf adDisplayContainer nicht mehr funktioniert. Der Grund dafür ist, dass beim Anklicken einer Anzeige der Tastaturfokus auf den IMA iFrame gesetzt wird. Damit der Tastaturfokus auf dem Content-Player bleibt, verwenden Sie das Ereignis CLICK, um den Tastaturfokus wieder auf den gewünschten Container zu übertragen. Weitere Informationen finden Sie im folgenden Code-Snippet:
adsManager.addEventListener(
      google.ima.AdEvent.Type.CLICK,
      function(){
        window.focus();
        // Or another method to return focus to the desired container.
      });