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:
requestChangeVolumerequestFullscreenrequestExitFullscreen
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:
playpausestalled(arabelleğe alınıyor)seekingseekedendeddurationchangetimeupdate, periyodik olarak.volumechange(sessize alma durumu dahil).