SIMID desteğini inceleme

HTML5 için Google Interactive Media Ads (IMA) SDK'sı, Güvenli Etkileşimli Medya Arayüzü Tanımı (SIMID) 1.1 sürümünü destekler. Bu kılavuzda, IMA SDK'nın desteklediği belirli SIMID özellikleri ve mesajları ele alınmaktadır.

Reklam öğesinden oyuncuya gönderilen mesajları anlama

Aşağıdaki tabloda, SIMID reklam öğesinin IMA SDK'sına gönderebileceği mesajlar listelenmektedir:

Mesaj Açıklama
clickThru Reklam öğesinin sağladığı URI'ye göre reklam tıklamalarını işler.
fatalError Reklam oturumunu sonlandırır ve reklam öğesinden önemli bir hata bildirir.
getMediaState URI, currentTime, duration, volume ve muted durumu dahil olmak üzere medya oynatıcının mevcut durumunu döndürür.
log Hata ayıklama için reklam öğesi günlük mesajlarını IMA SDK'ya yönlendirir.
reportTracking IMA SDK, reklam öğesi adına izleme URL'lerine ping göndermesini ister.
requestChangeAdDuration Reklam oturumunun toplam süresini değiştirme istekleri.
requestNavigation Harici bir URI'ye gitme isteğinde bulunur.
requestPause IMA SDK'nın medya oynatıcıyı duraklatmasını ister.
requestPlay IMA SDK'nın medya oynatıcıyı devam ettirmesini veya oynatmasını isteyen istekler.
requestResize Video oynatıcının yeniden boyutlandırılması istekleri. Oynatıcı yeniden boyutlandırmaya izin veriyorsa IMA SDK oynatıcıyı yeniden boyutlandırır.
requestSkip SDK'nın mevcut reklamı atlamasını isteyen istekler.
requestStop SDK'nın reklam oturumunu durdurmasını isteyen istekler.
handleSkipShown Reklam öğesinin, reklamı atlama kullanıcı arayüzünü gösterdiğini IMA SDK'ya bildirir.
requestFocus Reklam öğesinin iFrame'i için odaklanma isteğinde bulunur.

Oyuncuya gönderilen, desteklenmeyen reklam öğesi mesajlarını inceleme

IMA SDK, aşağıdaki CreativeMessage türlerini işlemez:

  • requestChangeVolume
  • requestFullscreen
  • requestExitFullscreen

Oyuncudan reklam öğesine gönderilen mesajları anlama

Aşağıdaki tabloda, IMA SDK'nın SIMID reklam öğesine göndermeyi desteklediği mesajlar listelenmiştir:

Mesaj Açıklama
init Oturum kurulumu sırasında ortam verileri ve reklam parametreleriyle birlikte gönderilir.
startCreative Reklam öğesini, reklam öğesi iFrame'ini başlatıp göstermesi için bilgilendirir.
adStopped Reklam oturumunun sona erdiğini, neden kodu da dahil ederek bildirir.
adSkipped Kullanıcının veya IMA SDK'nın reklamı atladığını reklam öğesine bildirir.
resize Reklam öğesini oynatıcı veya video boyutu değişiklikleri konusunda bilgilendirir.
appBackgrounded Uygulamanın arka plana girdiğini reklam öğesine bildirir.
appForegrounded Uygulamanın ön plana döndüğünü reklam öğesine bildirir.
fatalError Reklam öğesini, oynatıcı tarafında bir hata oluştuğu konusunda bilgilendirir.
log Oynatıcıdan reklam öğesine günlük mesajları gönderir.
focusIn Reklam öğesinin odaklandığını bildirir.

Medya durumu güncellemelerini inceleme

IMA SDK, aşağıdaki etkinlikler için reklam öğesine mediaStateUpdate mesajları gönderir:

  • play
  • pause
  • stalled (arabelleğe alma)
  • seeking
  • seeked
  • ended
  • durationchange
  • timeupdate, belirli aralıklarla.
  • volumechange (ses kapatma durumu dahil)