Google Interactive Media Ads SDK'sı Hakkında SSS
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
- Neden tüm biçimlerde reklam döndürülmüyor?
- .
Test reklamı etiketleri, geçerli istekler için her zaman reklam döndürecek şekilde ayarlanmıştır. Bu
ve oynatıcınızın performansını test etmeyi ve oyuncularınızın oyundaki
ve reklamları oluşturur. Ancak reklamlar her zaman her
biçimi belirleyebilirsiniz. Entegrasyonunuz çalışıyorsa
etiketi için uygun olmayan bir şekilde etiketlenmişse, bunun nedeni şunlardan biri olabilir:
şu:
- Ortamınıza desteklenmeyen bir biçime sahip videolar sunuyorsunuz. Örneğin,
iOS veya Android'e yalnızca HTML5 reklamlar yayınlıyorsanız.
- Ad Manager kullanıyorsanız yayıncı kimliğinizde
gerekiyor. Ayrıca, alakalı reklamları onayladığınızdan ve
reklam öğelerini kontrol edin.
- AdSense kullanıyorsanız, sitenize veya test sayfanıza ait hedefleme ölçütleri
etkin reklamı olmamalıdır. En yaygın nedeni,
taranmamış web sitelerini ziyaret edebilir.
- Ad Exchange Ağ İş Ortağı Yönetimi ve
descriptionURL ayarlanmamış veya sahibi ya da işletilmeyen site üzerinde değil
bu listeye reklam yayınlanmaz.
- Ad Exchange Video'da tanımlanan minCPM eşiklerini kontrol edin. CEVAP
BGBM'nin oldukça yüksek olması, doluluk oranlarının çok düşük olmasına yol açabilir. Bu sorunu düzeltmek için şunlardan birini deneyin:
Min. BGBM'yi veya reklam birimi parametresini reklam isteğinden kaldırma
(ör. alanadı) kullanarak bu durumun doluluk oranını etkileyip etkilemediğini doğrulayabilirsiniz.
- İyi bir
descriptionUrl nasıl görünür?
- .
En etkili olmak için
descriptionUrl.
kelime veya deyimler derlemesi değil,
İçeriği ve içeriğin sağlanmasındaki rolünüz açıklayan 1-3 paragraf.
Geçmişte başarılı olan yöntemlerden biri,
descriptionUrl sayfa içeriği, önceden tanımlanmış bloklardan dinamik olarak içeriyor.
Örneğin, içerik hakkında birkaç cümle, içeriğiniz hakkında birkaç cümle
ve ardından her biriyle ilişkili önceden tanımlı birkaç snippet'i
AdSense kanalı ("Eğlence" veya "Spor" gibi). Sonuç olarak, ekibinizin
içeriğin makul ölçüde farklı bir descriptionUrl değerine sahip olması
hem genel bilgiler (tür tanımlayıcıları gibi) sağlar hem de
(doğrudan içerikle ilgili içerik)
Bu meta veri HTML'si basit olmalıdır. Örneğin:
<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>
- Neden "Reklam yanıtı geçerli bir reklam türü içermiyor" hatasını alıyorum?
- Bu hata genellikle
belirli
publisherId (belirtilen dönem için). Bu koşul
gün içinde veya kampanyalar başlayıp bittikçe birkaç gün içinde değişebilir.
Hedeflemek istediğiniz reklamın süresinin dolmadığından ve
reklam hedefleme ölçütlerinin doğru olduğundan emin olun.
Reklamlar, doğru bir şekilde istenilen, alınan ve oluşturulan,
publisherId test ederseniz bu reklamların
reklamlar, yayındaki publisherId kullanılarak düzgün şekilde işlenir.
kullanılabilir.
- Test için kullanabileceğim bir Ad Manager video reklam etiketiniz var mı?
- Örnek etiketleri örnek etiketler sayfasında bulabilirsiniz.
adSlotWidth ve adSlotHeight öğelerini aynı şekilde mi ayarlayayım
değerlerini Ad Manager reklam etiketimde sz olarak ayarlayacağım.- Her zaman değil.
adSlotWidth ve adSlotHeight
reklamların gösterilmesini istediğiniz oynatıcının veya alanın genişliğine/yüksekliğine ayarlanmalıdır
doldur. Bunlar, AdSense tarafından hangi reklamların sığabileceğini belirlemek için kullanılır.
çok kolaylaşır. Ad Manager reklam etiketinizdeki sz anahtar/değer çifti:
bir hedefleme parametresidir ve yayınlanan reklam öğesini etkilemesi gerekmez
(aşağıda daha fazla bilgi verilmiştir).
- Demo reklam etiketi harika görünüyor ancak bunu reklam etiketimle değiştirdiğimde hiç reklam görünmüyor.
- .
Çalıştırdığınız reklam etiketine bir şeyin trafiğe eklendiğinden emin olun
üzerine konuşacağız. Bunu öğrenmenin en kolay yolu HTTP trafiğini izlemektir.
1x1 piksel gri.gif resmi bir HTML bağlantı bloğu içinde döndürülür,
Ad Manager'da hedeflemenizi kontrol etmeniz gerekir.
- Aynı etiketi kullanan reklamları birden çok kez istemek istiyorum, ancak yalnızca ilk reklamım için reklam alıyorum
isteğinde bulunabilirsiniz. Bu sorunu nasıl çözebilirim?
- .
Birden fazla reklam isteğinde bulunduğunuzda bunu reklam sunucusuna bildirmeniz gerekir
bunların yanlışlıkla tekrarlanmadığından ve meşru talepler olduğundan emin olun. SDK
iki hızlı API çağrısı ile bunu sizin için yapıyor:
AdsManager örneğinizde destroy() öğesini çağırın.
Bu,
contentComplete() Yeni bir AdsManager kazandınız
lütfen kontrol edin.AdsLoader cihazınızda contentComplete() adlı kuruluşu arayın
kullanır. Bu işlem SDK'yı sıfırlar ve yeni reklam isteği
aynısı olacaktır.
ziyaret edin.
Yukarıdaki iki aramayı yaptıktan sonra requestAds() numaralı telefonu şu numaradan arayabilirsiniz:
hesabınızda oynatılacak başka bir reklam grubu elde etmek için AdsLoader örneğinizi
yeni bir video oluşturabilirsiniz.
- IMA SDK'yı kullanarak yer paylaşımlı ve alanın tamamını kullanan AdSense reklamlarını nasıl isteyebilirim?
-
SDK'yı kullanarak AdSense reklamları istemek için öncelikle bir AdSense hesabı edinmeniz gerekir
reklam etiketi. Daha fazla bilgiyi AdSense
. Etiketinizi aldıktan sonra aşağıdakileri almanız gerekir
Yer paylaşımı veya alanın tamamını reklam isteğinde bulunmak için şu adımları uygulayın:
Yer paylaşımlı reklamlar
AdsRequest cihazınızda Görüntü Modlarınızı şu şekilde ayarlayın:
NORMAL.- Reklam etiketinize
overlay=1 parametresini ekleyin.
ziyaret edin.
Alanın tamamını kullanan reklamlar
AdsRequest cihazınızda Görüntü Modlarınızı şu şekilde ayarlayın:
FULLSCREEN.- Reklam etiketinize
overlay=0 parametresini ekleyin.
- "Geçersiz tıklama URL'si" görüyorum hata mesajı alıyorum. Bunun nedeni ne olabilir?
- .
Bu hatanın en yaygın nedeni, hatalı şekilde kod dışına alınmış bir tıklamadır.
URL'yi tıklayın. Bu hatayı görüyorsanız, tıklama ayarlarınızın
URL, VAST yanıtınızda düzgün şekilde kod dışına alınmış.
- Android ve iOS SDK'larında video reklamın tamamını tıklanabilir hale getirmenin bir yolu var mı?
- Videonun tamamında tıklama izleme kapsamında, standart izleyici deneyimi
en yaygın nedeni,
bir videoya dokunulduğunda veya bir videoya
duraklattığında veya oynatıcı kontrollerini görüntülediğinde Kullanıcılardan kaçınmak için
yalnızca içeriğe erişmek istediklerinde, istemeden reklamları
oynatıcı kontrolleri IMA, Daha fazla bilgi edinin düğmesini kullanarak
Kullanıcılar bir reklamı tıklar ve reklamı yapılan ürün hakkında daha fazla bilgi edinir.
- Neden "VAST Dokümanı Boş" görüyorum? hatası?
- Bu hata, reklam etiketi boş bir VAST belgesi döndürdüğünde ortaya çıkar.
reklamın düzgün yayınlanmadığını belirtir. Hesap yöneticinizle görüşün
veya reklam sunucusu temsilcisini kontrol ederek reklam etiketinizin neden çalışmadığını öğrenin.
- Reklamı Atla kutusunun veya diğer kullanıcı arayüzü öğelerinin boyutunu/metnini değiştirebilir miyim?
- IMA SDK'ları, kullanıcı arayüzü öğelerinin düzeninin, boyutunun veya içeriğinin değiştirilmesini desteklemez.
Kullanıcı arayüzü öğeleri hakkında daha fazla ayrıntı için
AdsManager.uiElements öğesine bakın.
- Neden "Sanal yöntem yok" mesajını alıyorum hata oluşmasını sağlar mı?
-
Aşağıdakilere benzer hata mesajları, eski bir sürümün kullanılmasından kaynaklanır
izin verilmez.
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'
4.0 veya daha yeni bir sürüme (ancak tercihen en son sürüme) geçmek bu sorunu çözer.
- Kullanıcı arayüzünü başlatmak ve değiştirmek için birden fazla iş parçacığı kullanabilir miyim?
- .
Hayır, kullanıcı arayüzünün tüm başlatma ve değiştirme işlemleri
iş parçacığı. Android'de, kullanıcı arayüzü nesneleri iş parçacığı açısından güvenli değildir. Görüntüleyin
İleti dizileri'ni ziyaret edin.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-31 UTC.
[null,null,["Son güncelleme tarihi: 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."]]
