google.
Reklam isteğinin özelliklerini belirtmek için kullanılan bir sınıf.
Marka
Reklam İsteği
yeni AdsRequest()
- Uygulama işlemleri
- google.ima.AdsRequestInterface
Özellikler
reklam yanıtı
(null, dize veya boş olmayan Doküman)
Reklam etiketi URL'si üzerinden istekte bulunmak yerine, reklam yanıtı olarak kullanılacak bir VAST 2.0 dokümanını belirtir. Bu, hata ayıklama ve VAST yanıtının zaten mevcut olduğu diğer durumlarda yararlı olabilir.
Bu parametre isteğe bağlıdır.
adTagUrl'si
string
Reklam sunucusundan istenen reklam etiketi URL'sini belirtir. Reklam etiketi URL'sini oluşturma hakkında ayrıntılı bilgi için Manuel olarak ana reklam video etiketi oluşturma bölümüne bakın.
Bu parametre zorunludur.
içerikSüresi
(null veya sayı)
Gösterilecek içeriğin süresini saniye cinsinden belirtir. Bu dosya 2 durumda kullanılır: 1) AdX reklam hedefleme ve 2) VMAP'nin videodan sonra ne zaman önceden yükleneceğine karar verme.
Bu parametre isteğe bağlıdır.
içerikAnahtar Kelimeleri
(null veya null olmayan dize dizisi)
Gösterilecek içeriği açıklamak için kullanılan anahtar kelimeleri belirtir. AdX isteklerinde kullanılır.
Bu parametre isteğe bağlıdır.
içerikBaşlığı
(null veya dize)
Gösterilecek içeriğin başlığını belirtir. AdX isteklerinde kullanılır.
Bu parametre isteğe bağlıdır.
Zorunlu OlmayanDoğrusalTamAlan
boolean
Doğrusal olmayan AdSense reklamlarını doğrusal alanın tamamını kullanarak gösterilmeye zorlar. Ayarlanırsa içerik videosu duraklatılır ve doğrusal olmayan metin veya resim reklam, alanın tamamını oluşturur. İçerik videosu, reklam atlandığında veya kapatıldıktan sonra devam ettirilir.
doğrusalAdSlotYükseklik
number (sayı)
Bir doğrusal reklamın gösterildiği dikdörtgen alanın yüksekliğini belirtir. Bu değer, reklam seçimi için ölçütlerden biri olarak kullanılır. Bu değerin gerçek reklamın yüksekliğiyle eşleşmesi gerekmez.
Bu parametre zorunludur.
doğrusalAdSlotGenişliği
number (sayı)
Bir doğrusal reklamın gösterildiği dikdörtgen alanın genişliğini belirtir. Bu değer, reklam seçimi için ölçütlerden biri olarak kullanılır. Bu değerin gerçek reklamın genişliğiyle eşleşmesi gerekmez.
Bu parametre zorunludur.
canlıYayın Ön Getirme Saniyeleri
number (sayı)
Reklam etiketi URL'sini istemeden önce requestAds çağrıldıktan sonra saniye cinsinden maksimum bekleme süresini belirtir. İstek sayısındaki ani artışları azaltmak amacıyla bu özellik, bir canlı yayın etkinliği sırasında istekleri zamana yaymak için kullanılabilir.
Doğrusal OlmayanReklamAlanıYükseklik
number (sayı)
Doğrusal olmayan bir reklamın görüntüleneceği dikdörtgen alanın yüksekliğini belirtir. Bu değer, reklam seçimi için kullanılan ölçütlerden biri olarak kullanılır. Bu değerin gerçek reklamın yüksekliğiyle eşleşmesi gerekmez.
Bu parametre zorunludur.
Doğrusal olmayanAdSlotGenişliği
number (sayı)
Doğrusal olmayan bir reklamın görüntüleneceği dikdörtgen alanın genişliğini belirtir. Bu değer, reklam seçimi için kullanılan ölçütlerden biri olarak kullanılır. Bu değerin gerçek reklamın genişliğiyle eşleşmesi gerekmez.
Bu parametre zorunludur.
omidAccessModeKuralları
Dize özellikleri bulunan boş olmayan nesne
Doğrulama tedarikçilerini OMID Erişim Modlarıyla eşlemeye ilişkin ayarlar nesnesi. Anahtarlar, google.ima.OmidVerificationprovider içindeki değerler, değerler de google.ima.OmidAccessMode'daki değerler olmalıdır.
Doğrulama komut dosyası URL'leri, bir OmidVerificationTedarikçi anahtarıyla çözümlenmek üzere tedarikçi firma tarafından sağlanan normal ifadelerle dahili olarak eşleştirilir. Ardından IMA, bu nesneyi kullanan sağlayıcının erişim modunu arar.
Bilinen bir satıcıya çözümlenmeyen komut dosyası URL'leri için veya çözülmüş OmidVerificationTedarikçi bu nesnede sağlanmazsa IMA, OmidVerificationTedarikçi için sağlanan erişim modunu kullanır.OTHER. OmidVerificationprovider.OTHER sağlanmazsa Sınırlı erişim modu kullanılır.
sayfa URL'si
(null veya dize)
Google reklam isteğine hedefleme için eklenecek sayfanın tam URL'sini belirtir. URL geçerli bir URL olmalıdır. Belirtilirse bu değer [PAGEURL] VAST makrosu için kullanılır.
Bu parametre isteğe bağlıdır.
vastLoadTimeout
number (sayı)
Tek bir sarmalayıcıda milisaniye cinsinden varsayılan VAST yük zaman aşımı için geçersiz kılma. Varsayılan zaman aşımı süresi 5.000 ms'dir.
Bu parametre isteğe bağlıdır.
Yöntemler
ReklamAdıOtomatikOyna
setAd WillAutoPlay(autoPlay) geçersiz değeri döndürür
Oynatıcının içerik ve reklamı bir kullanıcı işlemine yanıt olarak mı başlatmak istediğini yoksa otomatik olarak oynatılıp oynatılmayacağını SDK'ya bildirir. Bu ayarın değiştirilmesi reklam oynatmayı etkilemez.
Parametre |
|
|---|---|
|
otomatik oynat |
boolean İçerik ve reklamın otomatik olarak mı oynatılacağı yoksa bir kullanıcı tarafından mı başlatılacağı. |
- İadeler
-
void
ReklamAdıPlaySesi kapalı
setAdWillPlayMuted(sesi kapalı) geçersiz sonucu döndürür
Oynatıcının sesi kapalıyken reklam başlatma niyetinde olup olmadığını SDK'ya bildirir. Bu ayarın değiştirilmesi reklam oynatmayı etkilemez ancak alıcıların sesi kapalı envanter için teklif vermesini sağlamak amacıyla reklam isteğinde uygun sinyali gönderir.
Parametre |
|
|---|---|
|
ses kapatıldı |
boolean Reklamın sesi kapalıyken de oynatılıp oynatılmayacağı. |
- İadeler
-
void
Sürekli Oynatma
setKesinti oynatma(sürekli Oynatma) geçersiz değer döndürür
Oynatıcının, TV yayınına benzer şekilde içerik videolarını art arda sürekli olarak oynatmaya hazır olup olmadığını SDK'ya bildirir. Bu ayar değiştirildiğinde reklam yayını etkilenmez. Ancak alıcıların reklam envanteri türü için teklif verebilmesi amacıyla bu reklam isteğindeki uygun sinyal gönderilir.
Parametre |
|
|---|---|
|
kesintisiz oynatma |
boolean İçerik videosunun sürekli art arda oynatılıp oynatılmadığı. |
- İadeler
-
void