google.
google.ima ad alanı, SDK'nın sınıflarına, arayüzlerine, numaralandırmalarına ve özelliklerine erişim sağlar.
Sınıflar
Reklam
Farklı reklam türlerini temsil eden sınıflar tarafından genişletilen bir reklam sınıfı.
AdCuePoints
İşaret noktası listesi, reklam aralarının zaman çizelgesini temsil eder. Reklam arasındaki tek reklamların programa dahil edilmediğini unutmayın.
Reklam GörüntülemeKapsayıcısı
Bu sınıf, reklam görüntülemek için bir kapsayıcıdır. SDK, video ve yer paylaşımlı reklamları barındırmak için otomatik olarak containerElement parametresinin içinde yapılar oluşturur.
Bu sınıfın bir örneği oluşturulduğunda, containerElement içinde bir IFRAME oluşturur ve SDK çekirdekini yükler. SDK'nın düzgün çalışması için bu IFRAME korunmalıdır. Tüm reklamlar oynatıldıktan sonra SDK'ya artık ihtiyaç duyulmadığında SDK'yı kaldırmak için destroy() yöntemini kullanın.
containerElement parametresi, DOM'un parçası olan bir öğe olmalıdır. Reklamların doğru şekilde görüntülenebilmesi için containerElement öğesini doğru şekilde konumlandırmanız gerekir. İçerik video oynatıcının üstüne yerleştirmeniz ve tüm video oynatıcıyı kapsayacak şekilde boyutlandırmanız önerilir. Önerilen uygulamalarla ilgili ayrıntılar için SDK dokümanlarına bakın.
Not: initialize() yönteminin, bir kullanıcı işlemi (tıklama veya dokunma gibi) tarafından doğrudan çağrılan kodda her zaman çağrılması gerekir.
Reklam Hatası
AdError, reklam yükleme veya oynama sırasında bir hata oluşup oluşmadığına dair bilgileri kullanıcıya gösterir. errorType erişimi, hatanın reklam yükleme sırasında mı yoksa reklam oynatma sırasında mı gerçekleştiği hakkında bilgi sağlar.
AdErrorEvent
Bu etkinlik, Google veya DoubleClick sunucularından bir reklam yüklenirken hata oluştuğunda yükseltilir. AdsLoader ve AdsManager, etkinliğe kaydolabilirsiniz.
Reklam Etkinliği
Bu etkinlik türü, reklam durumu değiştiğinde ve kullanıcılar reklamla etkileşimde bulunduğunda reklam tarafından bildirim olarak iletilir. Örneğin, reklam oynatılmaya başladığında, tıklandığında vb. AdsManager'da durum değişikliği yapılan çeşitli etkinliklere kaydolabilirsiniz.
AdmetadataEvent
Bu sınıf kullanımdan kaldırıldı. AdsManager.getCuePoints() API'yi kullanın. Meta verileri taşıyan belirli bir reklam etkinliği.
AdPodInfo
Reklam, bir reklam kapsülünün parçası olabilir. Bu nesne, kapsüldeki reklam sayısı ve kapsül içindeki reklam konumu gibi ilgili kapsülle ilgili meta verileri açığa çıkarır.
Bu nesnedeki getTotalAds API genellikle doğru olmakla birlikte bazı durumlarda SDK'nın en iyi tahminini temsil eder. Daha fazla bilgi için ilgili yöntemin dokümanlarına bakın.
Reklamİlerleme Durumu Verileri
Bu nesne, bir reklam oynatılırken mevcut ilerleme durumu hakkında bilgi verir.
AdsLoader
AdsLoader, müşterilerin reklam sunucularından reklam istemesine olanak tanır. Bunu yapmak için kullanıcıların AdsManagerLoadedEvent etkinliğine kaydolması ve ardından reklam istemesi gerekir.
AdsManager
Dış genel API'yi yayıncıya sağlar ve Ads Manager'ın iç örneğiyle iletişim kurar.
AdsManagerLoadedEtkinlik
Bu etkinlik, reklamlar bir AdsLoader üzerinden Google veya DoubleClick reklam sunucularından başarıyla yüklendiğinde tetiklenir. Bu etkinliğe AdsLoader'dan kaydolabilirsiniz.
Reklam Oluşturma Ayarları
Reklamların oluşturulmasını kontrol eden parametreleri tanımlar.
Reklam İsteği
Reklam isteğinin özelliklerini belirtmek için kullanılan sınıf.
Tamamlayıcı Reklam
Tamamlayıcı reklamı temsil eder.
CompanionAdSelectionSettings (Tamamlayıcı Reklam Seçimi Ayarları)
CompanionAdSelectionSettings nesnesi, ima.Ad.getCompanionAds işlevini çağırırken seçim ölçütlerini tanımlamak için kullanılır.
ImaSdkAyarlar
Bu sınıf, SDK genelinde geçerli olan ayarları içerir.
UniversalAdIdInfo
Bu nesne, reklam kimliği değeri ve reklam kimliği kaydı dahil olmak üzere reklam öğesiyle ilişkili evrensel reklam kimliğiyle ilgili bilgileri gösterir.
Sıralamalar
OmidErişim Modu
string
Web için OMID'nin doğrulama komut dosyasının ne kadarına erişebildiğini kontrol eden kullanılabilir erişim modları.
Değer |
|
|---|---|
|
SINIRLI |
Doğrulama komut dosyası korumalı alan içinde bulunuyor, reklam öğesine veya yayıncı sayfasına erişemiyor ve reklam öğesinin hangi yayıncı alanında olduğunu doğrudan onaylayamıyor. |
|
ALAN ADI |
Doğrulama komut dosyası korumalı alanda ve reklam öğesi veya yayıncı sayfasına erişemiyor. Ancak komut dosyası, hangi yayıncı alanında olduğunu doğrudan doğrulayacak şekilde yüklenir. |
|
TAM |
Doğrulama komut dosyasının reklam öğesine ve yayıncı sayfasına doğrudan erişimi vardır. |
OmidDoğrulama Sağlayıcısı
sayı
OMID doğrulama tedarikçi firmasını tanımlar. Sağlayıcılar alfabetik sıraya göre listelenir.
Değer |
|
|---|---|
|
KARŞILAŞTIRMA |
|
|
ÇİFTLEŞTİRME |
|
|
|
|
|
INTEGRAL_AD_SCIENCE |
|
|
ORTA DÜZEY |
|
|
MOAT |
|
|
NIELSEN |
|
|
İKAZ |
|
|
DİĞER |
Komut dosyası URL'si başka bir sağlayıcıyla eşleşmediğinde kullanılacak varsayılan tedarikçi firma. |
Kullanıcı Öğeleri
string
Görüntülenecek veya gizlenebilecek farklı kullanıcı arayüzü öğeleri belirten enum. Bu ayarlar AdSense ve ADX reklamları için yoksayılabilir.
Değer |
|
|---|---|
|
REKLAM_ATTRIBUTION |
Reklam kullanıcı arayüzündeki "Reklam" metnini gösterir. Geri sayım zamanlayıcının gösterilmesi gerekir. |
|
COUNTDOWN |
Geri sayım zamanlayıcının gösterilmesi için reklam ilişkilendirmesi gereklidir. |
Görüntüleme Modu
string
Reklamlar için farklı VPAID görüntüleme modları belirten enum.
Değer |
|
|---|---|
|
NORMAL |
Normal reklam görüntüleme modu. |
|
Tam ekran |
Tam ekran reklam görüntüleme modu. Reklam yöneticisine, yayıncının geçerli AdDisplayContainer düzenlemesini tam ekran olarak kabul ettiğini (örneğin, tam ekran simülasyonu) gösterir. Bu durum, reklam yöneticisinin tam ekrana geçmesine neden olmaz. |
- Kullanımdan kaldırıldı
Özellikler
OmidErişim Modu
string
Web için OMID'nin doğrulama komut dosyasının ne kadarına erişebildiğini kontrol eden kullanılabilir erişim modları.
Değer |
|
|---|---|
|
SINIRLI |
Doğrulama komut dosyası korumalı alan içinde bulunuyor, reklam öğesine veya yayıncı sayfasına erişemiyor ve reklam öğesinin hangi yayıncı alanında olduğunu doğrudan onaylayamıyor. |
|
ALAN ADI |
Doğrulama komut dosyası korumalı alanda ve reklam öğesi veya yayıncı sayfasına erişemiyor. Ancak komut dosyası, hangi yayıncı alanında olduğunu doğrudan doğrulayacak şekilde yüklenir. |
|
TAM |
Doğrulama komut dosyasının reklam öğesine ve yayıncı sayfasına doğrudan erişimi vardır. |
OmidDoğrulama Sağlayıcısı
sayı
OMID doğrulama tedarikçi firmasını tanımlar. Sağlayıcılar alfabetik sıraya göre listelenir.
Değer |
|
|---|---|
|
KARŞILAŞTIRMA |
|
|
ÇİFTLEŞTİRME |
|
|
|
|
|
INTEGRAL_AD_SCIENCE |
|
|
ORTA DÜZEY |
|
|
MOAT |
|
|
NIELSEN |
|
|
İKAZ |
|
|
DİĞER |
Komut dosyası URL'si başka bir sağlayıcıyla eşleşmediğinde kullanılacak varsayılan tedarikçi firma. |
Kullanıcı Öğeleri
string
Görüntülenecek veya gizlenebilecek farklı kullanıcı arayüzü öğeleri belirten enum. Bu ayarlar AdSense ve ADX reklamları için yoksayılabilir.
Değer |
|
|---|---|
|
REKLAM_ATTRIBUTION |
Reklam kullanıcı arayüzündeki "Reklam" metnini gösterir. Geri sayım zamanlayıcının gösterilmesi gerekir. |
|
COUNTDOWN |
Geri sayım zamanlayıcının gösterilmesi için reklam ilişkilendirmesi gereklidir. |
Görüntüleme Modu
string
Reklamlar için farklı VPAID görüntüleme modları belirten enum.
Değer |
|
|---|---|
|
NORMAL |
Normal reklam görüntüleme modu. |
|
Tam ekran |
Tam ekran reklam görüntüleme modu. Reklam yöneticisine, yayıncının geçerli AdDisplayContainer düzenlemesini tam ekran olarak kabul ettiğini (örneğin, tam ekran simülasyonu) gösterir. Bu durum, reklam yöneticisinin tam ekrana geçmesine neden olmaz. |
- Kullanımdan kaldırıldı
ayarlar
null olmayan ImaSdkSettings
Global singleton settings örneği.