Häufig gestellte Fragen zum Google Interactive Media Ads SDK
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
- Warum werden nicht bei allen Formaten Anzeigen zurückgegeben?
-
Die Testanzeigen-Tags sind so eingerichtet, dass bei gültigen Anfragen immer Anzeigen zurückgegeben werden. Dies ist
soll die Integration erleichtern und es einfacher machen, zu testen, wie Ihr Player
fordert und rendert Anzeigen. Anzeigen sind jedoch nicht immer in allen
für Ihre Website, Ihr Konto oder Ihren Anzeigenblock. Wenn deine Integration funktioniert
nicht korrekt für das Test-Tag, aber nicht für Ihr eigenes Tag, könnte eine der folgenden Ursachen vorliegen:
Folgendes:
<ph type="x-smartling-placeholder">
</ph>
- Sie stellen in Ihrer Umgebung Videos in einem nicht unterstützten Format bereit. Beispiel:
nur HTML5-Anzeigen für iOS oder Android schalten.
- Wenn Sie Ad Manager verwenden, enthält Ihre Publisher-ID möglicherweise keine Anzeigen, auf die
zu diesem Zeitpunkt. Stellen Sie außerdem sicher, dass Sie die relevanten Anzeigen freigegeben und
Creatives in Ad Manager.
- Bei Verwendung von AdSense werden die Ausrichtungskriterien für Ihre Website oder Testseite möglicherweise
keine aktiven Anzeigen enthalten. Die häufigste Ursache ist die Verwendung von
privaten, nicht gecrawlten Websites.
- Wenn Sie die Verwaltung von Werbenetzwerkpartnern in Ad Exchange nutzen,
descriptionURL ist nicht festgelegt oder befindet sich nicht im Eigentum bzw. von diesem Unternehmen betrieben
Domainverwaltungsliste, werden hier keine Anzeigen ausgeliefert.
- Sehen Sie sich die in Ad Exchange für Videos festgelegten Grenzwerte für minCPM an. A
kann ein recht hoher CPM zu sehr niedrigen Ausführungsraten führen. Versuchen Sie Folgendes, um das Problem zu beheben:
Entfernen des minCPM oder Entfernen des Anzeigenblockparameters aus der Anzeigenanfrage
(z.B. Anzeigenflächenname), um zu überprüfen, ob sich dies auf die Ausführungsrate auswirkt.
- Wie sieht eine gute
descriptionUrl aus?
-
Am effektivsten ist, dass der Inhalt der Seite,
descriptionUrl
die auf eine Sammlung von Wörtern oder Wortgruppen,
1 bis 3 Absätze, in denen der Inhalt und Ihre Rolle bei der Bereitstellung beschrieben werden.
Eine Methode, die sich in der Vergangenheit bewährt hat, ist das Zusammenfügen
descriptionUrl-Seiteninhalt dynamisch aus vordefinierten Blöcken.
Zum Beispiel einige Sätze über den Inhalt, einige Sätze zu Ihrem
und einige vordefinierte Snippets, die mit den einzelnen
AdSense-Kanal (z. B. „Unterhaltung“ oder „Sport“). Daher wird jedes Stück
Inhalte weisen eine hinreichend eindeutige descriptionUrl auf, die mit
die sowohl allgemeine Informationen (z. B. Genrebeschreibungen) als auch
als spezifische Informationen (Inhalt direkt über den Inhalt)
Dieses Metadaten-HTML sollte einfach sein, zum 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 "Anzeigenantwort enthält keinen gültigen Anzeigentyp"?
- Dieser Fehler tritt im Allgemeinen auf, weil keine Anzeigen auf die
spezifische
publisherId (für den angegebenen Zeitraum) Diese Bedingung
kann sich im Laufe des Tages oder auch über mehrere Tage mit Beginn und Ende einer Kampagne ändern.
Stellen Sie sicher, dass die gewünschte Anzeige nicht abgelaufen ist und
die Targeting-Kriterien der Anzeige korrekt sind.
Wenn Anzeigen ordnungsgemäß angefordert, empfangen und gerendert werden
Test-publisherId können Sie sicher sein, dass diese Anzeigen
wie mit dem Live-publisherId verarbeitet, wenn die Anzeigen
verfügbar.
- Verfügen Sie über ein Ad Manager-Videoanzeigen-Tag, das ich zum Testen verwenden kann?
- Beispiel-Tags finden Sie auf der Seite Beispiel-Tags.
- Soll ich für
adSlotWidth und adSlotHeight denselben Wert festlegen?
als sz in meinem Ad Manager-Anzeigen-Tag festlegen?
- Nicht unbedingt.
adSlotWidth und adSlotHeight
muss auf die Breite/Höhe des Players oder Bereichs festgelegt sein, in dem Ihre Anzeigen
füllen. Sie werden von AdSense verwendet, um zu bestimmen, welche Anzeigen für die Anpassung verfügbar sind.
in diesen Bereich verschieben. Das Schlüssel/Wert-Paar sz in Ihrem Ad Manager-Anzeigen-Tag ist
ist ein Targeting-Parameter und wirkt sich nicht unbedingt auf das ausgelieferte Creative aus
(weitere Informationen siehe unten).
- Das Demo-Anzeigen-Tag sieht gut aus, aber wenn ich es mit meinem Anzeigen-Tag wechsle, erscheint keine Anzeige.
-
Stellen Sie sicher, dass ein Trafficking an das Anzeigen-Tag erfolgt,
anfragen. Der einfachste Weg, dies herauszufinden, besteht darin, den HTTP-Traffic zu beobachten. Wenn ein
1x1 pixel graue.gif-Bild in einem HTML-Ankerblock zurückgegeben
müssen Sie das Targeting in Ad Manager überprüfen.
- Ich möchte Anzeigen mit demselben Tag mehrmals anfordern, aber ich sehe nur Anzeigen für die erste
Wie kann ich das beheben?
-
Wenn Sie Anzeigen mehrmals anfragen, muss der Ad-Server darüber informiert werden.
dass es sich dabei um legitime Anfragen und nicht um versehentliche Duplikate handelt. Das SDK
dies für Sie mit zwei schnellen API-Aufrufen:
<ph type="x-smartling-placeholder">
</ph>
- Rufen Sie
destroy() auf der Instanz AdsManager auf.
Dadurch wird verhindert, dass Post-Rolls abgespielt werden, wenn Sie den folgenden Aufruf an
contentComplete() Du erhältst ein neues AdsManager
wenn Sie Ihre nächste Anfrage stellen.
contentComplete() auf AdsLoader anrufen
Instanz. Dadurch wird das SDK zurückgesetzt, sodass die neue Anzeigenanfrage
Duplikat der vorherigen.
Nachdem du die beiden oben genannten Anrufe getätigt hast, kannst du requestAds() aufrufen auf
AdsLoader-Instanz, damit ein weiterer Satz Anzeigen
für ein neues Video.
- Wie fordere ich Overlay- und Full-Slot-AdSense-Anzeigen mit dem IMA SDK an?
-
Um AdSense-Anzeigen mithilfe des SDK anzufordern, müssen Sie zunächst eine
Anzeigen-Tag enthält. Weitere Informationen dazu findest du in der AdSense-Hilfe
für Videos. Sobald Sie Ihr Tag haben, müssen Sie Folgendes tun:
um entweder eine Overlay-Anzeige oder eine Full-Slot-Anzeigenanfrage zu senden:
Overlay-Anzeigen
<ph type="x-smartling-placeholder"></ph>
- Lege in
AdsRequest die Ansichtsmodi fest auf
NORMAL.
- Fügen Sie Ihrem Anzeigen-Tag den Parameter
overlay=1 hinzu.
Full-Slot-Anzeigen
<ph type="x-smartling-placeholder"></ph>
- Lege in
AdsRequest die Ansichtsmodi fest auf
FULLSCREEN.
- Fügen Sie Ihrem Anzeigen-Tag den Parameter
overlay=0 hinzu.
- Ich erhalte die Fehlermeldung "Ungültige Klick-URL" wenn ich auf meine Anzeige klicke. Woran könnte das liegen?
-
Die häufigste Ursache für diesen Fehler ist ein falsch maskierter Klick
URL Falls dieser Fehler angezeigt wird, überprüfen Sie, ob Ihre Klick-Conversions
Die URL ist in der VAST-Antwort richtig maskiert.
- Gibt es im Android- und iOS-SDK eine Möglichkeit, die gesamte Videoanzeige anklickbar zu machen?
- Beim Klick-Tracking für das gesamte Video
Bei Videos für Mobilgeräte hat sich herausgestellt, dass das Tippen auf ein Video
pausiert ihn oder ruft die Steuerelemente des Videoplayers auf. Um Nutzer zu vermeiden
auf Anzeigen klicken, aber eigentlich nur Zugriff
Steuerelemente des Videoplayers werden über die Schaltfläche Weitere Informationen
auf eine Anzeige klicken, um mehr über das beworbene Produkt zu erfahren.
- Warum wird die Meldung „VAST-Dokument ist leer“ angezeigt? Fehler?
- Dieser Fehler tritt auf, wenn vom Anzeigen-Tag ein leeres VAST-Dokument zurückgegeben wird. Dies weist darauf hin,
dass die Anzeige nicht ordnungsgemäß geschaltet wurde. Sprechen Sie mit Ihrem Account Manager.
oder Ad-Server-Beauftragten, um zu sehen, warum Ihr Anzeigen-Tag nicht funktioniert.
- Kann ich die Größe oder den Text des Felds Anzeige überspringen oder anderer Elemente der Benutzeroberfläche ändern?
- Die IMA SDKs unterstützen das Ändern des Layouts, der Größe oder des Inhalts von UI-Elementen nicht.
Weitere Informationen zu UI-Elementen findest du unter
AdsManager.uiElements.
- Warum erhalte ich die Meldung „Keine virtuelle Methode“? Fehler während der Laufzeit?
-
Fehlermeldungen wie die folgenden werden durch die Verwendung einer älteren Version verursacht.
der Google Play-Dienste ohne die Werbe-ID.
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'
Dieses Problem lässt sich durch ein Upgrade auf Version 4.0 oder höher (vorzugsweise auf die neueste Version) lösen.
- Kann ich mehrere Threads verwenden, um die UI zu initialisieren und zu bearbeiten?
-
Nein. Jegliche Initialisierung und Bearbeitung der Benutzeroberfläche müssen auf der
im Hauptthread. In Android sind UI-Objekte nicht threadsicher. Weitere Informationen finden Sie unter
<ph type="x-smartling-placeholder"></ph>
Threads finden Sie weitere Informationen dazu.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-31 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-31 (UTC)."],[[["\u003cp\u003eThe test ad tags always return ads for valid requests to help with integration and testing; however, live ads might not always be available due to factors like ad targeting, formats, and publisher settings.\u003c/p\u003e\n"],["\u003cp\u003eWhen using your own ad tag, ensure it's properly trafficked and targeted in Ad Manager to avoid issues like no ads appearing or a 1x1 pixel grey.gif being returned.\u003c/p\u003e\n"],["\u003cp\u003eFor repeated ad requests using the same tag, use \u003ccode\u003edestroy()\u003c/code\u003e on the \u003ccode\u003eAdsManager\u003c/code\u003e and \u003ccode\u003econtentComplete()\u003c/code\u003e on the \u003ccode\u003eAdsLoader\u003c/code\u003e to prevent duplicate requests and ensure proper ad serving.\u003c/p\u003e\n"],["\u003cp\u003eAn "Ad response does not contain a valid ad type" error usually indicates an issue with ad targeting for your publisher ID; verify the ad's status and targeting criteria in Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eadSlotWidth\u003c/code\u003e and \u003ccode\u003eadSlotHeight\u003c/code\u003e should be set to the player's dimensions for ad fitting, while the \u003ccode\u003esz\u003c/code\u003e parameter in the Ad Manager tag is for targeting and may not directly influence creative selection.\u003c/p\u003e\n"]]],[],null,["# Google Interactive Media Ads SDK FAQs\n\n- [Why am I not getting ads back for all formats?](#1)\n- [What does a good descriptionUrl look like?](#2)\n- [Why am I receiving the error \"Ad response does not contain a valid ad type\"?](#3)\n- [Do you have an Ad Manager video ad tag that I can use for testing?](#4)\n- [Should I set the adSlotWidth and adSlotHeight to the same values\n as the sz in my Ad Manager ad tag?](#5)\n- [The demo ad tag looks great, but when I switch it with my ad tag,\n no ad appears.](#7)\n- [I want to request ads using the same tag more than once, but I\n only get ads for my first request. How do I fix this?](#8)\n- [How do I request overlay and full slot AdSense ads using the IMA\n SDK?](#9)\n- [I'm getting an \"Invalid clickthrough URL\" error when I click on my\n ad. What could be the cause?](#10)\n- [In the Android and iOS SDKs, is there a way to make the entire video\n ad clickable?](#11)\n- [Why do I see a \"VAST Document Empty\" error?](#12)\n- [Can I change the size/text of the \"Skip Ad\" box or other UI elements?](#13)\n- [Why am I getting \"No virtual method\" errors at runtime?](#14)\n- [Can I use multiple threads to initialize and manipulate the UI?](#18)\n\n*** ** * ** ***\n\nWhy am I not getting ads back for all formats?\n:\n The test ad tags are set up to always return ads for valid requests. This is\n meant to facilitate integration and make it easier to test how your player\n requests and renders ads. However, ads are not always available in every\n format for your site, account, or ad unit. If your integration is working\n properly for the test tag but not for your own tag, the cause may be one of\n the following:\n\n - You're serving videos of an unsupported format to your environment. For example, you're serving only HTML5 ads to iOS or Android.\n - If you're using Ad Manager, your publisher ID may not have any ads targeted to it at this time. Also, ensure that you have approved the relevant ads and creatives in Ad Manager.\n - If you're using AdSense, the targeting criteria for your site or test page may not have any active advertisements. The most common cause is the use of private, uncrawled websites.\n - If you're using Ad Exchange Network Partner Management and `descriptionURL` is not set or is not on the owned or operated domains management list, ads do not serve to this.\n - Check the *minCPM* thresholds defined in Ad Exchange Video. A fairly high CPM may result in very low fill rates. To correct this, try either removing the minCPM or removing the ad unit parameter from the ad request (i.e., slotname) to verify whether this is affecting the fill rate.\n\nWhat does a good `descriptionUrl` look like?\n:\n To be most effective, the content of the page that `descriptionUrl`\n points to shouldn't be a collection of words or phrases but rather\n 1-3 paragraphs actually describing the content and your role in providing it.\n One method that has been successful in the past is to stitch together\n `descriptionUrl` page content dynamically from predefined blocks.\n For example, a few sentences about the content, a few sentences about your\n site's offering, and then a few predefined snippets associated with each\n AdSense channel (like \"Entertainment\" or \"Sports\"). As a result, each piece of\n content has a reasonably distinct `descriptionUrl` associated with\n it that provides both general information (such as genre descriptors) as well\n as specific information (content about the content directly).\n\n This metadata HTML should be simple, for example:\n\n ```text\n \u003chtml\u003e\n \u003chead\u003e\n \u003ctitle\u003eDomain.com - Your tag line here!\u003c/title\u003e\n \u003c/head\u003e\n \u003cbody\u003e\n \u003ch1\u003eDescriptions\u003c/h1\u003e\n \u003ch2\u003eAbout this Content\u003c/h2\u003e\n \u003cp\u003eLorem ipsum dolor sit amet, consectetur adipiscing elit. ...\u003c/p\u003e\n \u003ch2\u003eAbout Domain.com\u003c/h2\u003e\n \u003cp\u003eLorem ipsum dolor sit amet, consectetur adipiscing elit. ...\u003c/p\u003e\n \u003c/body\u003e\n \u003c/html\u003e\n \n ```\n\nWhy am I receiving the error \"Ad response does not contain a valid ad type\"?\n: This error generally appears because no ads have been targeted to the\n specific `publisherId` (for the given time period). This condition\n may vary throughout the day, or over several days as campaigns begin and end.\n You should check that the ad you wish to target has not expired and that the\n ad targeting criteria are correct.\n As long as ads are properly requested, received, and rendered using\n the test `publisherId`, you can be sure that these ads are\n properly handled using your live `publisherId` when the ads are\n available.\n\nDo you have an Ad Manager video ad tag that I can use for testing?\n: Sample tags are available on the [sample tags](/interactive-media-ads/docs/sdks/android/client-side/tags) page.\n\nShould I set the `adSlotWidth` and `adSlotHeight` to the same\nvalues as the `sz` in my Ad Manager ad tag?\n: Not necessarily. The `adSlotWidth` and `adSlotHeight`\n must be set to the width/height of the player or area you want your ads to\n fill. They are used by AdSense to determine which ads are available to fit\n into that space. The `sz` key/value pair in your Ad Manager ad tag is\n a targeting parameter and does not necessarily affect the creative served\n (more information below).\n\nThe demo ad tag looks great, but when I switch it with my ad tag, no ad appears.\n:\n Check to ensure that something is trafficked to the ad tag you are\n requesting. The easiest way to find out is to watch the HTTP traffic. If a\n **1x1 pixel grey.gif** image is returned within an HTML anchor block,\n then you need to check your targeting in Ad Manager.\n\nI want to request ads using the same tag more than once, but I only get ads for my first\nrequest. How do I fix this?\n:\n When you request ads more than once, you need to let the ad server know\n that these are legitimate requests, and not accidental duplicates. The SDK\n does this for you with two quick API calls:\n\n 1. Call `destroy()` on your `AdsManager` instance. This prevents any post-rolls from playing when you make the below call to `contentComplete()`. You get a new `AdsManager` when you make your next request.\n 2. Call `contentComplete()` on your `AdsLoader` instance. This resets the SDK so the new ad request doesn't look like a duplicate of the previous one.\n\n\n After making the two calls above, you can call `requestAds()` on\n your `AdsLoader` instance to get another set of ads to play for your\n new video.\n\nHow do I request overlay and full slot AdSense ads using the IMA SDK?\n\n: To request AdSense ads using the SDK, you need to first obtain an AdSense\n ad tag. You can learn more about that on the [AdSense\n for Video page](//support.google.com/adsense/answer/1705822). Once you have your tag, you need to take the following\n steps to make either an overlay or a full slot ad request:\n\n **Overlay ads**\n\n 1. In your `AdsRequest`, set your ViewModes to `NORMAL`.\n 2. In your ad tag, add the parameter `overlay=1`.\n\n **Full slot ads**\n\n 1. In your `AdsRequest`, set your ViewModes to `FULLSCREEN`.\n 2. In your ad tag, add the parameter `overlay=0`.\n\nI'm getting an \"Invalid clickthrough URL\" error when I click on my ad. What could be the cause?\n:\n The most common cause for this error is an improperly escaped clickthrough\n URL. If you're seeing this error, check to make sure that your clickthrough\n URL is properly escaped in your VAST response.\n\nIn the Android and iOS SDKs, is there a way to make the entire video ad clickable?\n: As far as whole-video click tracking goes, the standard viewer experience\n for mobile video that has emerged is that tapping on a video either\n pauses it or brings up the player controls. To avoid users\n unintentionally clicking on ads when they really just want access to the\n player controls IMA uses the **Learn more** button to let\n users click on an ad and learn more about the product being advertised.\n\nWhy do I see a \"VAST Document Empty\" error?\n: This error occurs when the ad tag returns an empty VAST document, indicating\n that the ad was not served properly. Talk to your account manager\n or ad server representative to see why your ad tag is not working.\n\nCan I change the size/text of the **Skip Ad** box or other UI elements?\n: The IMA SDKs do not support changing the layout, size, or content of UI elements.\n For more details on UI elements, see `AdsManager.uiElements`.\n\nWhy am I getting \"No virtual method\" errors at runtime?\n\n: Error messages similar to the following are caused by using an older version\n of Google Play services that does not include the advertising ID.\n\n ```\n No virtual method\n getInfo()Lcom/google/android/gms/ads/identifier/AdvertisingIdClient$Info; in\n class Lcom/google/android/gms/ads/identifier/AdvertisingIdClient; or its\n super classes (declaration of 'com.google.android.gms.ads.identifier.AdvertisingIdClient'\n ```\n\n Upgrading to version 4.0 or later (but preferably the latest) solves this problem.\n\nCan I use multiple threads to initialize and manipulate the UI?\n:\n\n No, all initialization and manipulation of the UI must be done on the\n main thread. In Android, UI objects are not thread-safe. See\n [Threads](//developer.android.com/guide/components/processes-and-threads.html#Threads) for more information."]]
