HTML5 için Google Dinamik Reklam Ekleme (DAI) SDK'sı, Güvenli Etkileşimli Medya Arayüzü Tanımı (SIMID) 1.1 sürümünü destekler. Bu kılavuzda, DAI 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 DAI'ye gönderebileceği mesajlar listelenmiştir:
| Mesaj | Açıklama |
|---|---|
clickThru |
DAI SDK, DAI reklam etiketinde yapılandırılan tıklama izleme URL'lerine ping gönderir. DAI SDK, reklam öğesinin sağladığı özel URI veya gezinme seçeneklerini yoksayar. |
getMediaState |
currentTime, duration, volume, muted, paused ve fullscreen özellikleri de dahil olmak üzere medya oynatıcının mevcut durumunu döndürür. DAI, sunucu tarafında birleştirilmiş akışlar kullandığından currentSrc özelliği her zaman null değerini döndürür. |
log |
Sorun giderme için reklam öğesi günlük mesajlarını DAI SDK hata ayıklama konsolu günlüğüne yönlendirir. |
reportTracking |
DAI SDK, reklam öğesi için izleme URL'lerine ping isteğinde bulunur. |
requestPause |
DAI SDK'sının medya oynatıcıyı duraklatmasını ister. |
requestPlay |
DAI SDK'nın medya oynatıcıda oynatmaya devam etmesini ister. |
requestSkip |
DAI SDK'nın mevcut reklamı atlamasını isteyen istekler. Yalnızca VOD akışları için desteklenir. Reklam öğesi, canlı yayın için bu mesajı gönderirse reddedilir. |
Oyuncuya gönderilen, desteklenmeyen reklam öğesi mesajlarını inceleme
DAI SDK, aşağıdaki CreativeMessage türlerini işlemez:
fatalErrorrequestChangeAdDurationrequestFullscreenrequestExitFullscreenhandleSkipShownrequestFocusrequestNavigation: Her zaman reddedilir. Oynatıcı, reklam öğesinin gezinmeyi yönetmesini bekler.requestResize: Her zaman reddedilir. DAI SDK'sı, reklam öğesi yeniden boyutlandırmayı desteklemez.requestStop: Her zaman reddedilir. Bu tür, DAI'nin desteklemediği uzun süreli kullanım alanları içindir.requestChangeVolume: DAI SDK bu etkinliği başarıyla çözer ancak reklam öğesi için ses değişiklikleri yapmaz.
Oyuncudan reklam öğesine gönderilen mesajları anlama
Aşağıdaki tabloda, DAI SDK'nın SIMID reklam öğesine göndermeyi desteklediği mesajlar listelenmektedir:
| 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 DAI SDK'sının reklamı atladığını reklam öğesine bildirir. Yalnızca VOD akışları için desteklenir. |
Desteklenmeyen oynatıcıdan reklam öğesine mesajları inceleme
DAI SDK, aşağıdaki mesajları desteklemez veya reklam öğesine göndermez:
resizeappBackgroundedappForegroundedlog
Medya durumu güncellemelerini inceleme
DAI SDK, aşağıdaki etkinlikler için reklam öğesine mediaStateUpdate mesajları gönderir:
playpausestalled(arabelleğe alma)seekingseekedtimeupdate(periyodik olarak)volumechange(ses kullanma durumu dahil)
DAI SDK aşağıdaki etkinlikleri desteklemez ve etkinlikler gerçekleştiğinde medya durumu güncellemelerini göndermez:
endeddurationchangeerror