Sınıf: AdsRequest

Marka

Reklam İsteği

yeni AdsRequest()

Uygulama
google.ima.AdsRequestInterface

Özellikler

reklamEtiketi URL'si

string

Reklam sunucusundan istenen reklam etiketi URL'sini belirtir. Reklam etiketi URL'sinin oluşturulmasıyla ilgili ayrıntılar için Manuel olarak ana reklam video etiketi oluşturma bölümüne bakın.

Bu parametre zorunludur.

adsYanıt

(null, dize veya boş değerli doküman)

Reklam etiketi URL'si aracılığıyla istekte bulunmak yerine, reklam yanıtı olarak kullanılacak bir VAST 2.0 dokümanı belirtir. Bu, hata ayıklama ve VAST yanıtının zaten mevcut olduğu diğer durumlarda faydalı olabilir.

Bu parametre isteğe bağlıdır.

içerikSüresi

(null veya sayı)

İçeriğin gösterileceği süreyi saniye cinsinden belirtir. 2 durumda kullanılır: 1) AdX reklam hedefleme ve 2) Videodan sonra gösterilen VMAP'nin ne zaman önceden yükleneceğine karar verme.

Bu parametre isteğe bağlıdır.

içerikAnahtar Kelimeleri

(null veya boş olmayan bir dizi 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ığı

(boş 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 Olmayan Doğrusal Tam Alan

boolean

Doğrusal olmayan AdSense reklamlarını doğrusal tam alan olarak oluşturmaya zorlar. Bu politika ayarlandığında, içerik videosu duraklatılır ve doğrusal olmayan metin veya resim reklam tam alan olarak oluşturulur. İçerik videosu, reklam atlandığında veya kapatıldığında devam ettirilir.

doğrusalAdSlotHeight

sayı

Doğrusal bir reklamın içinde göründüğü dikdörtgen alanın yüksekliğini belirtir. Bu değer, reklam seçimi ölçütlerinden 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

sayı

Doğrusal reklamın içinde görüntüleneceği dikdörtgen alanın genişliğini belirtir. Bu değer, reklam seçimi ölçütlerinden 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

sayı

Reklam etiketi URL'sini istemeden önce, requestAds çağrıldıktan sonra saniye cinsinden beklenecek maksimum süreyi belirtir. Bu, istek sayısındaki ani artışları azaltmak amacıyla canlı yayın etkinliği sırasında istekleri derlemek için kullanılabilir.

Doğrusal OlmayanReklamAlanıYükseklik

sayı

Doğrusal olmayan bir reklamın içinde görüntüleneceği dikdörtgen alanın yüksekliğini belirtir. Bu değer, reklam seçimi ölçütlerinden 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

sayı

Doğrusal olmayan bir reklamın gösterildiği dikdörtgen alanın genişliğini belirtir. Bu değer, reklam seçimi ölçütlerinden biri olarak kullanılır. Bu değerin gerçek reklamın genişliğiyle eşleşmesi gerekmez.

Bu parametre zorunludur.

omidAccessModeKuralları

Dize özelliklerine sahip boş olmayan nesne

Doğrulama tedarikçi firmalarını OMID Erişim Modlarıyla eşlemeyle ilgili ayarlar nesnesi. Anahtarlar, google.ima.OmidVerificationVendor değeri ve google.ima.OmidAccessMode değerindeki değerler olmalıdır.

Doğrulama komut dosyası URL'leri, bir OmidVerificationVendor anahtarıyla çözümlenmek üzere tedarikçi firma tarafından sağlanan normal ifadelerle dahili olarak eşleştirilir. Daha sonra IMA, bu nesneyi kullanarak belirtilen tedarikçinin erişim modunu arar.

Bilinen bir tedarikçi firmaya çözümlenmeyen komut dosyası URL'leri için veya çözülmüş OmidVerificationVendor bu nesnede sağlanmazsa IMA, OmidVerificationVendor için sağlanan erişim modunu kullanır.OTHER. OmidVerificationProvider.OTHER sağlanmazsa LIMITED erişim modu kullanılır.

sayfa URL'si

(boş veya dize)

Hedefleme amacıyla Google reklam isteğine dahil edilecek 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

sayı

Tek bir sarmalayıcıdaki varsayılan VAST yükleme zaman aşımı için milisaniye cinsinden geçersiz kılın. Varsayılan zaman aşımı süresi 5.000 ms'dir.

Bu parametre isteğe bağlıdır.

Yöntemler

ReklamOtomatik Oynat

setAdWillAutoPlay(autoPlay) geçersiz durum döndürür

Oynatıcının, bir kullanıcı işlemine yanıt olarak içeriği ve reklamı başlatmak isteyip istemediğini veya otomatik olarak oynatılıp oynatılmayacağını SDK'ya bildirir. Bu ayarın değiştirilmesi, reklamın oynatılmasını etkilemez.

Parametre

otomatik oynat

boolean

İçeriğin ve reklamın otomatik olarak oynatılıp oynatılmayacağı veya bir kullanıcı işlemi tarafından başlatılıp başlatılmayacağı.

İadeler

void 

SetAdWillPlayMuted

setAdWillPlayMuted(muted) durum döndürme

Oynatıcının, sesi kapalı olduğunda reklamı başlatmayı isteyip istemediğini 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 oynatılıp oynatılmayacağı.

İadeler

void 

Sürekli Oynatma

setKesinti Oynatma(sürekli Oynatma) sonucu döndürülür

Oynatıcının, TV yayınına benzer şekilde içerik videolarını sürekli olarak oynatmayı isteyip istemediğini SDK'ya bildirir. Bu ayarın değiştirilmesi reklam oynatmayı etkilemez ancak alıcıların reklam envanteri türü için teklif vermesini sağlamak üzere bu reklam isteğinde uygun sinyali gönderir.

Parametre

kesintisiz oynatma

boolean

İçerik videosunun birbiri ardına oynatılıp oynatılmadığı.

İadeler

void