SDK desteğini ve uyumluluğunu inceleme

Bu sayfada, tarayıcılar, video biçimleri ve platformlar için IMA DAI desteği ve uyumluluğu hakkında genel bilgiler verilmektedir.

Desteklenen video biçimleri ve tarayıcılar

HTML5, yeni ve gelişmekte olan bir standarttır. Bu nedenle, çeşitli özellikler için destek tarayıcılar arasında farklılık gösterir ve tüm büyük tarayıcılar tarafından desteklenen tek bir varsayılan video biçimi yoktur. Çoğu tarayıcıda kullanılan üç ana video biçimi H.264, HLS ve Dash'tir.

VAST etkinliği uyumluluğu

Bu bölümde, VAST yanıtında döndürülen bilgilere göre sunucuya otomatik olarak bildirilen VAST etkinlikleri listelenmektedir.

Tamamen desteklenen

complete, creativeView, firstQuartile, impression, midpoint, pause, resume, rewind (geriye doğru önemli bir sarma işlemi olduğunda tetiklenir), start, thirdQuartile.

Kısmen destekleniyor

  • click

    Click etkinliği yalnızca video reklamlar için gönderilir. Android, iOS veya masaüstündeki yerel tam ekran oynatıcılarda tıklamalar yakalanamaz ancak video kapatıldığında tıklamalar sayfa içi tıklama izleme öğesi tarafından yakalanabilir. Ancak video öğesi iPad'de yerel kontrolleri kullanıyorsa tıklamalar yakalanamaz.

  • fullscreen

    IMA, videonun tarayıcı penceresinin tamamını kapladığı bir simüle edilmiş tam ekran modunu destekler. IMA, bir videonun offsetWidth ve offsetHeight değerleri doküman gövdesinin boyutu kadar olduğunda videoyu tam ekran modunda kabul eder. Bu mod tüm tarayıcılarda desteklenir.

    iPhone ve 3.0 öncesi Android platformlarda video her zaman tam ekran modunda oynatılır.

  • mute, unmute

    iOS ve Android'de yalnızca yerel ses seviyesi kontrolü bulunur. Bu nedenle IMA, ses düzeyini veya sessize alma durumunu belirleyemez ve SDK değişikliklerden haberdar olmaz. Aşağıda, mute ve unmute sembollerini destekleyen ve desteklemeyen tarayıcı sürümlerinin listesi verilmiştir:

    • Desteklenenler: Firefox 3.5 ve üstü, Chrome 8 ve üstü, Safari 4 ve üstü
    • Desteklenmiyor: iOS, Android

VAST reklam sunma hakkında daha fazla bilgi için IAB yönergelerine bakın.

Reklam araları yeniden izlenirken reklam etkinlikleri

IMA, reklamlar yeniden izlenirken aşağıdaki nedenlerle reklam etkinliklerini tetiklemez:

  • Etkinlik URL'leri yalnızca bir kez tetiklenmelidir. Aksi takdirde spam olarak değerlendirilebilir.
  • Bu sayede kullanıcılar, daha önce izledikleri reklam aralarında ileri veya geri sarabilir ve daha iyi bir sarma deneyimi yaşayabilir.

Reklam araları yeniden izlenirken yalnızca aşağıdaki etkinlikler tetiklenir:

  • AD_PERIOD_STARTED
  • AD_PERIOD_ENDED

Desteklenen video oynatıcı platformları

Google IMA SDK'ları aşağıdaki platformlarda desteklenir:

Platform Sürüm
HTML5 Masaüstü: Chrome, Firefox, Safari, Edge, Opera
Mobil: Chrome/Android Tarayıcı (telefonlar ve tabletler için Android), Safari ve Chrome (iOS)
iOS iOS 10.0 veya sonraki sürümler
Android Android 4.4+
Google Cast Tüm Yayın cihazları
tvOS tvOS 14 veya sonraki sürümler
Roku Roku'dan yazılım güncellemesi almaya devam eden tüm cihazlar

Video akışı biçimi desteği

IMA, SDK'larında hem HLS hem de DASH'i destekler. Belirli SDK platformlarında destek için bu tabloya bakın. Akışın düzgün şekilde oynatılması için video oynatıcınızın kullanılan akış türünü desteklemesi gerekir.

IMA SDK platformu HLS DASH
HTML5 Onay işareti Onay işareti
iOS Onay işareti Red-X
Android Onay işareti Onay işareti
Google Cast Onay işareti Onay işareti
tvOS Onay işareti Red-X
Roku Onay işareti Onay işareti

Video özellikleri ve SDK sürümleri

Aşağıdaki özellikler hakkında daha fazla bilgi edinmek için video reklamcılığa genel bakış başlıklı makaleyi okuyun.

IAB Video Suite Destek
VAST 4 Uyarı 1
VAST 3 Uyarı 2
VAST 2 Onay işareti
VPAID 2 Red-X
VMAP 1.0.1 Uyarı 3
Ad Manager Video özellikleri Destek
Doğrusal reklamlar Onay işareti
Doğrusal olmayan reklamlar (yer paylaşımlı reklamlar) Red-X
Tamamlayıcılar Uyarı 4
VAST 3 alternatif tamamlayıcı reklam kaynakları Red-X
Aktif Görüntüleme görüntülenebilirliği Onay işareti
VAST yönlendirmeleri Onay işareti
Görüntülü reklam isteğiyle birlikte yedek doldurma Red-X
Google Yayıncı Etiketi (GPT) uyumluluğu Red-X
İçerik farkındalığı Red-X
Reklam kuralları Onay işareti
Kapsülleme Onay işareti
Bumper Onay işareti
Çoklu etkinlik izleme (MET) hakkında rapor oluşturma Onay işareti
Atlanabilir (rezervasyon / TrueView olmayan) Uyarı 5
Video İçin AdSense özellikleri 7 Destek
TrueView Yayın İçi Uyarı 6
Yayın içi seçim Onay işareti
Standart yayın içi Onay işareti
Tam slot Red-X
Tamamlayıcılar Uyarı 4
Tamamlayıcı dolgu Red-X
Katmanlar Red-X
Ad Manager Ad Exchange özellikleri Destek
TrueView Yayın İçi Uyarı 6
Yayın içi seçim Onay işareti
Standart yayın içi Onay işareti
Tam slot Red-X
Tamamlayıcılar Uyarı 4
Tamamlayıcı dolgu Red-X
Katmanlar Red-X
Aktif Görüntüleme görüntülenebilirliği Onay işareti
Neden bu reklam gösteriliyor? Uyarı 8

1 Google Ad Manager tarafından desteklenen VAST 4 özelliklerinden IMA aşağıdaki özellikleri destekler:

2 Aşağıdaki VAST 3.0 özellikleri henüz desteklenmemektedir:

  • Tamamlayıcı adSlotId
  • Tamamlayıcı yayınlanma seçenekleri
  • Simgeler

3 Aşağıdaki VMAP özellikleri henüz desteklenmemektedir:

  • VMAP'e özgü izleme etkinlikleri
  • VMAP'ye özgü hata kodları
  • Yer paylaşımlı reklamlar
  • ss:dd:ss veya "start" ve "end" dışındaki zaman farkları
  • Ekran breakType özelliği
  • repeatAfter özellik

4 Yalnızca resim eşlikçileri desteklenir. Resim eşlikçilerinin reklamlarla doldurulması için özel uygulama gerekir. Tamamlayıcı reklamlar tvOS'te desteklenmez.

5 Geleneksel atlanabilir reklamlar yalnızca HTML5, iOS, tvOS, Roku ve Android (Android TV dahil) için IMA DAI SDK'larında desteklenir. Cast SDK ile, geleneksel olarak atlanabilir reklamları desteklemek için atlama özelliğini StreamRequest.senderCanSkip ile beyan etmeniz gerekir.

6 TrueView atlanabilir reklamları yalnızca HTML5, iOS ve Android (Android TV dahil) için IMA DAI SDK'larında desteklenir.

7 AdSense özelliği, Cast SDK'sında desteklenmez.

8 Neden bu reklam?, StreamManager oluşturulurken adUiElement parametresinin iletilmesini gerektirir. Neden Bu Reklam?, Cast SDK'sında desteklenmez.

JavaScript çerçeveleriyle ilgili uyarılar

IMA HTML5 SDK ile React veya AngularJS gibi bir JavaScript çerçevesi kullanırken dikkat edilmesi gereken bazı noktalar vardır. Bu çerçeveler genellikle DOM öğelerini taşır. Bu durum, IMA SDK'nın başlatıldığında DOM'un statik olmasını beklemesi nedeniyle SDK'nın çalışmasını engelleyebilir. IMA SDK, SDK, çerçeve DOM öğelerini taşımayı tamamladıktan sonra başlatıldığı sürece JavaScript çerçevelerini destekler. Özellikle, StreamManager oluşturulurken adUiElement bağımsız değişkeni olarak iletilen HTML5 öğesi, örneği oluşturulduktan sonra taşınmamalıdır.

Apple AirPlay desteği

IMA SDK, Apple AirPlay'i desteklemez. AirPlay'i devre dışı bırakın veya AirPlay algılandığında reklam isteklerini devre dışı bırakın.