Google Mobile Ads SDK'sı artık mevcut MRAID v2 desteği üzerine kurulmuş MRAID v3 için beta desteğine sahiptir. Böylece, reklamverenlerin Ad Manager yayıncılarına MRAID v3 reklam öğeleri sunabilmesi sağlanır. Bu kılavuzda, MRAID v3 spesifikasyonunda net olmayan ve yorumlanmaya açık MRAID uygulama ayrıntıları açıklanmaktadır. Hedef kitlesi MRAID v3 reklam öğesi yazarlarıdır.
Ön koşullar
Yayıncılar şunları yayınlamalıdır:
- MRAID v3 için Google Play hizmetleri 15.0.0 veya üzeri
- MRAID v2 için Google Play hizmetleri 7.8 veya sonraki sürümleri
Faydalı bilgiler
MRAID hakkında bilgi sahibi değilseniz IAB MRAID sayfasından daha fazla bilgi edinebilirsiniz. Aşağıda açıklanan tüm parametrelerle ilgili ayrıntıların sunulduğu MRAID v3 Tanımları belgesini ve MRAID v3'teki IAB blog yayınını da indirebilirsiniz.
MRAID v3 (beta) uygulama ayrıntıları
Görüntülenebilirlik - pozlamaChange etkinliği
Bu etkinlik desteklenir ve yeni exposureChange etkinliği için kullanımdan kaldırılan viewableChange etkinliği yerine bir işleyici kullanılmasını öneririz.
mraid.isViewable() yöntemi de kullanımdan kaldırılmıştır. Ancak kullanımdan kaldırılan bu yöntemler, geriye dönük uyumluluğun korunması için desteklenmeye devam etmektedir.
exposureChange etkinlik tanımı, reklam görünümü her değiştiğinde gönderilir. SDK, çok fazla etkinlik oluşturulmasını önleyen bir yoklama mekanizmasına sahiptir.
Reklam bir işleyici kaydedildikten sonra başlangıç durumu, eşzamansız olarak gönderilir.
Geri çağırma, 0.0 ile 100.0 arasında bir kayan nokta sayısı olan exposed_percentage parametresini içerir.
Örnek kullanımı için MRAID v3 spesifikasyonuna bakın.
MRAID algılama ve başlatma ile MRAID_ENV özellikleri
SDK, MRAID v3 spesifikasyonunda tanımlandığı gibi başlatma protokolüne uygundur.
SDK, MRAID_ENV nesnesinde IDFA, limitAdTracking, Uygulama Kimliği veya COPPA'yı (isteğe bağlıdır) göndermez. MRAID sürümü, SDK adı ve SDK sürümü dahil olmak üzere MRAID_ENV nesnesinde gereken tüm değişkenleri sağlar.
Sesli izlenme ölçümü
Sesin duyulup duyulmadığını ve ses düzeyinin ne zaman değiştiğini belirlemek için yeni bir etkinlik (audioVolumeChange) kullanıma sunuldu.
audioVolumeChange etkinliğinin tek bir parametresi vardır: volume_percentage.
Değer, maksimum ses çalma ses düzeyinin yüzdesidir. 0.0 ile 100.0 arasında (oynatma işlemine izin verilmediğinde 0.0) veya ses düzeyi belirlenemiyorsa null arasında bir kayan nokta sayısıdır.
Örnek kullanımı için MRAID v3 spesifikasyonuna bakın.
mraid.getLocation()
mraid.getLocation() desteklenmediğinden her zaman -1 değerini döndürür.
mraid.unload()
Bu yöntem herhangi bir zamanda çağrılabilir ve SDK, reklamı kapatarak, kaynakları dağıtarak ve ardından web görünümünü kaldırarak ya da başka bir belgeyle veya yeni bir reklamla değiştirerek tepki verir.
Reklam öğesi unload() çağırdığında, yerel katman farklı reklam öğesi türlerine aşağıdaki gibi yanıt verir:
| Tür | unload() Davranışı |
|---|---|
| Banner | Mevcut reklamla aynı istek parametrelerine sahip yeni bir reklam isteği oluşturun. |
| Geçiş reklamı | Geçiş reklamını kapatın. |
VPAID (Video Oynatıcı Reklam Arayüzü Tanımı)
Google Mobile Ads SDK'sı VPAID'i desteklemez. mraid.supports('vpaid') işlevi yanlış döndürür.
mraid.useCustomClose()
Biçime ve reklam öğesi türüne bağlı olarak mraid.useCustomClose() desteklenmeyebilir.
MRAID v2 uygulama ayrıntıları
mraid.getVersion()
mraid.getVersion(), reklam öğesi yüklenene kadar 2.0 değerini döndürmez. mraid.getState(), loading değerini döndürürken MRAID sürümünü kontrol etmeyin.
mraid.resize()
mraid.resize() çağrıldığında, orijinal banner banner'ın ekran görüntüsü
ile değiştirilir. Bu durum, yeniden boyutlandırılan reklam orijinal reklam alanını kaplamadığında fark edilir.
Yeniden boyutlandırılan reklamlar da orijinal banner çerçevesini izlemez. Bir banner, kaydırma görünümüne yerleştirilirse yeniden boyutlandırılan reklam, banner ile birlikte kaymaz.
mraid.setResizeProperties()
mraid.setResizeProperties() için yapılan tüm çağrılar, gerekli özelliklerin tam listesini içermelidir. Yeniden boyutlandırma özellikleri geçersizse varsayılan değerlerine geri döner ve sonraki tüm mraid.resize() çağrıları, mraid.setResizeProperties() geçerli parametrelerle tekrar çağrılana kadar başarısız olur.
mraid.getMaxSize()
mraid.getMaxSize(), yalnızca yeniden boyutlandırılan reklamların maksimum boyutunu belirlemek için kullanılmalıdır. Genişletilebilir bir reklamın boyutunu belirlemek için mraid.getScreenSize() parametresini kullanın.
mraid.setOrientationProperties()
allowOrientationChange özelliği true değerine ayarlanmış olarak mraid.setOrientationProperties() çağrılırken forceOrientation özelliğinin ayarlanması hiçbir şey yapmaz.
Yönü zorunlu kılmak isteyen reklam öğeleri, allowOrientationChange değerini false olarak ayarlamalıdır.
mraid.isViewable()
Görüntüleme, başka bir şekilde görünür bir reklamı kapsıyorsa mraid.isViewable() yine de true değerini döndürür. Uygulama içeriği, görünür reklamları kapatmamalıdır.
mraid.getCurrentPosition()
İki parçalı genişletilebilir reklam genişletilmiş durumdayken, ilk parçada mraid.getCurrentPosition() öğesine yapılan bir çağrı ekranın boyutunu döndürür.
mraid.storePicture()
Bir uygulamanın mraid.storePicture() özelliğini desteklemesi için android.permission.WRITE_EXTERNAL_STORAGE iznini içermesi gerekir.