google. ima. AdsManager
Yayıncıya herkese açık harici API'yi sağlar ve Ads Manager'ın iç örneğiyle iletişim kurar.
Yöntemler
daralt
Daralt()
Geçerli reklamı daralt. Bu, HTML5 SDK'sı için işlemsizdir.
YapılandıranAdsManager
ConfigureAdsManager(içerik, adsrenderSettings)
AdsManagerLoaded etkinliğinden bu Ad Manager'a referans almak için gereken parametreleri ayarlar.
Parametre |
|
---|---|
içerik |
Nesne Yayıncının içeriğini oynatan nesne. Değer boş olmamalıdır. |
adsOluşturma Ayarları |
İsteğe bağlı Reklam Oluşturma Ayarları Reklamların oluşturulmasını kontrol etmek için isteğe bağlı ayarlar. Değer boş olabilir. |
destroy
yok et()
Çalışma zamanında yüklenen ve reklam tamamlandığında uygun şekilde kaldırılması gereken reklam öğelerini kaldırıp reklamı ve tüm izlemeyi durdurur.
reklam arasını sil
adAdBreak()
Bir reklam arası şu anda oynatılıyorsa içeriği kaldırıp içeriği devam ettirin. Aksi takdirde, programlanan bir sonraki reklam arasını yoksayın. Örneğin, bir kullanıcı videodan önce gösterilen reklamları veya videodan sonra gösterilen reklamları kaybetmeden videodan önce gösterilen reklamı yoksaymak için reklam yöneticisi yüklendikten hemen sonra çağrılabilir. Bu, reklam isteği bir oynatma listesi veya VMAP yanıtı döndürmediği sürece işlemsizdir.
genişlet
genişletme()
Mevcut reklamı genişletin. Bu, HTML5 SDK'sı için işlemsizdir.
odak
odak()
Odağı, varsa atla düğmesine yerleştirir. Mevcut değilse simgeler veya etkileşimli reklam öğeleri dahil olmak üzere etkileşimli öğelere odaklanılır.
getAdAtlanabilirState
getAdAtlanabilirState() boole'yi döndürür
Reklam şu anda atlanabilirse doğru değerini döndürür. Bu değer değiştiğinde, AdsManager
bir AdEvent.SKIPPABLE_STATE_CHANGED
etkinliği tetikler.
- İadeler
-
boolean
Reklam şu anda atlanabilirse yanlış, aksi takdirde yanlış değerini alır.
getCuePoints
getCuePoints() sayı dizisi döndürür
Planlanmış bir reklam arasının ne zaman oynatılacağını belirten saniye cinsinden ofsetleri döndürür. Videodan önce gösterilen reklam 0 ile, videodan sonra gösterilen reklam ise -1 ile gösterilir. Boş dizi, reklam veya reklam kapsülünün zaman planlaması olmadığını ve istediğiniz zaman oynatılabileceğini gösterir.
- İadeler
-
non-null Array of number
Zaman farkının saniye cinsinden listesi.
Kalan Süre
getRemainingTime() dönüştürülen sayı
Şu anda oynatılan reklamın kalan süresini öğrenin. Reklam henüz yüklenmediyse veya oynatılmadıysa API -1 döndürür.
- İadeler
-
number
Geçerli reklam için kalan süreyi döndürür. Mevcut reklam için kalan süre tanımlanmamışsa (örneğin, özel reklamlar) değer -1 döndürür.
getVolume
getVolume() sonuç sayısı
Mevcut reklamın hacmini öğrenin.
- İadeler
-
number
Geçerli reklamın 0 (sesi kapalı) - 1 (en yüksek) arası hacmi.
init
init(genişlik, yükseklik, görünümModu, videoElement)
Reklam yöneticisinde reklam deneyimini başlatmak için init'i çağırın.
Parametre |
|
---|---|
genişlik |
number (sayı) Reklamın seçilen genişliği. |
yükseklik |
number (sayı) Reklamın seçilen yüksekliği. |
Görünüm Modu |
Görünüm Modu Seçili görünüm modu. Değer boş olmamalıdır. |
video Öğesi |
İsteğe bağlı HTMLVideo Öğesi Özel oynatma için video öğesi. Bu video öğesi, AdDisplayKapsayıcı oluşturucuda sağlanan öğeyi geçersiz kılar. Bu özelliği yalnızca kesinlikle gerekliyse kullanın. Aksi takdirde, AdDisplayKapsayıcı'yı oluştururken bu video öğesini belirtmenizi öneririz. Değer boş olabilir. |
Özel Tıklama Takibi
isCustomClickTrackingUsed() boole döndürür
Mevcut reklamda tıklama izleme için özel bir tıklama izleme öğesi kullanılıyorsa doğru değerini döndürür. Özel tıklama izleme yalnızca AdDisplayContainer
özelliğine isteğe bağlı tıklama izleme öğesi sağlandığında, özel oynatma kullanıldığında ve geçerli reklam bir AdSense/AdX reklamı olmadığında kullanılır.
- İadeler
-
boolean
Özel tıklama izleme kullanılıp kullanılmadığı.
ÖzelOynatmaKullanıldı
isCustomoyUsed() Boole değerini döndürür
Mevcut reklamı oynatmak için özel bir video öğesi kullanılıyorsa doğru değerini
döndürür. Özel oynatma, daha sorunsuz bir reklam görüntüleme deneyimi sağlayacak platformlarda AdDisplayContainer
için isteğe bağlı bir video öğesi sağlandığında gerçekleşir.
- İadeler
-
boolean
Özel oynatmanın kullanılıp kullanılmayacağı.
duraklat
duraklatma()
Oynatılmakta olan reklamı duraklatır. Bu işlev, statik yer paylaşımı gösterilirken veya reklam henüz yüklenmediyse ya da oynatma tamamlandığında işlem yapmaz.
resize
yeniden boyutlandır(genişlik, yükseklik, görünümModu)
Mevcut reklamı yeniden boyutlandırır.
Parametre |
|
---|---|
genişlik |
number (sayı) Yeni reklam alanı genişliği. |
yükseklik |
number (sayı) Yeni reklam alanı yüksekliği. |
Görünüm Modu |
Görünüm Modu Yeni görünüm modu. Değer boş olmamalıdır. |
resume
öznitelik()
Yüklenmiş ve duraklatılmış mevcut reklamı devam ettirir. Bu işlev, statik yer paylaşımı gösterilirken veya reklam henüz yüklenmediyse ya da oynatma tamamlandığında işlem yapmaz.
ses düzeyini ayarla
setVolume(ses)
Mevcut reklamın hacmini belirleyin.
Parametre |
|
---|---|
ses düzeyi |
number (sayı) 0 (sessiz) ile 1 (en yüksek) arasında ayarlanmış ses düzeyi. |
atla
Skip()
AdsManager.getAdSkippableState()
doğru olduğunda mevcut reklamı atlar. Başka koşullar altında çağrıldığında, atlamanın hiçbir etkisi olmaz. Atlama işlemi tamamlandıktan sonra, AdsManager
bir AdEvent.SKIPPED
etkinliği tetikler.
start
başlangıç()
Reklamları oynatmaya başlayın.
Geliştiriciler önce AdDisplayContainer.initialize()
numarasını çağırmalıdırlar.
stop
durdur()
Reklamları oynatmayın. Bunu yaptığınızda yayıncı içeriğe yeniden yönlendirilir.
AdsAdsOluşturma Ayarları
updateAdsrenderSettings(adsCreationSettings)
Reklam oluşturma ayarlarını günceller. Bu, özellikle bit hızı gibi reklam oluşturma ayarlarının güncellenmesi gerektiğinde reklam araları arasındaki VMAP kullanım alanları için kullanılmalıdır.
Parametre |
|
---|---|
adsOluşturma Ayarları |
Reklam Oluşturma Ayarları Güncellenen reklam oluşturma ayarları. Değer boş olmamalıdır. |