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 oynatıcıya gönderilen mesajları anlama

Aşağıdaki tabloda, SIMID reklam öğesinin IMA SDK'ya gönderebileceği mesajlar listelenmiştir:

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 kaynaklanan önemli bir hatayı bildirir.
getMediaState URI, currentTime, duration, volume ve muted durumları 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 Reklam öğesi adına izleme URL'lerine ping göndermek için IMA SDK'dan istekte bulunur.
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ı ister.
requestResize Video oynatıcıyı yeniden boyutlandırma 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ı ister.
requestStop SDK'nın reklam oturumunu durdurmasını ister.
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.

Desteklenmeyen reklam öğesi-oynatıcı mesajlarını inceleme

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

  • requestChangeVolume
  • requestFullscreen
  • requestExitFullscreen

Oynatıcıdan reklam öğesi mesajlarını 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 öğesi iFrame'ini başlatması ve göstermesi için reklam öğesini bilgilendirir.
adStopped Reklam oturumunun sona erdiğini bildirir ve bir neden kodu içerir.
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 hakkında bilgilendirir.
appBackgrounded Reklam öğesine, uygulamanın arka plana geçtiğini bildirir.
appForegrounded Reklam öğesine, uygulamanın ön plana döndüğünü bildirir.
fatalError Reklam öğesini oynatıcı tarafındaki bir hata 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'sı, aşağıdaki etkinlikler için reklam öğesine mediaStateUpdate mesajları gönderir:

  • play
  • pause
  • stalled (arabelleğe alınıyor)
  • seeking
  • seeked
  • ended
  • durationchange
  • timeupdate, periyodik olarak.
  • volumechange (sessize alma durumu dahil).