Google Mobile Ads SDK'sı, MRAID 2. sürüm için mevcut desteğe dayalı olarak MRAID 3. sürüm için beta desteği sunarak reklamverenlerin Ad Manager yayıncılarına MRAID 3. sürüm reklam öğeleri yayınlamasına olanak tanır. Bu kılavuz, MRAID v3 spesifikasyonunda net olmayan ve yoruma açık olan MRAID uygulama ayrıntılarını netleştirir. Hedef kitlesi MRAID v3 reklam öğesi yazarlarıdır.
Ön koşullar
Yayıncılar şunları kullanıyor olmalıdır:
Faydalı temel bilgiler
MRAID hakkında bilginiz yoksa IAB MRAID sayfasından daha fazla bilgi edinebilirsiniz. Ayrıca, aşağıda ele alınan tüm parametrelerle ilgili ayrıntıları içeren MRAID v3 Tanımları belgesini ve MRAID v3 ile ilgili IAB blog yayınını indirebilirsiniz.
MRAID v3 (beta) uygulama ayrıntıları
Görüntülenebilirlik - exposureChange etkinliği
Bu etkinlik desteklenmektedir ve desteği sonlandırılan viewableChange etkinliği yerine yeni exposureChange etkinliği için bir dinleyici kullanmanızı öneririz.
mraid.isViewable() yöntemi de kullanımdan kaldırılmıştır. Ancak bu desteği sonlandırılmış yöntemler, geriye dönük uyumluluğu korumak için desteklenmeye devam eder.
exposureChange etkinlik tanımı, reklam görünümü her değiştiğinde gönderilir. SDK'da çok fazla etkinlik oluşturulmasını önlemek için bir yoklama mekanizması vardır.
İlk durum, reklam bir dinleyici kaydettikten sonra 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ığı şekilde başlatma protokolüne uygundur.
MRAID_ENV nesnesinde SDK; IDFA, limitAdTracking, uygulama kimliği veya COPPA'yı (isteğe bağlıdır) göndermez. MRAID_ENV nesnesinde MRAID sürümü, SDK adı ve SDK sürümü dahil olmak üzere gerekli tüm değişkenleri sağlar.
İşitilebilirlik ölçümü
Sesin duyulup duyulamadığını ve ses seviyesinin 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 düzeyinin yüzdesidir. 0.0 ile 100.0 arasında bir kayan nokta sayısıdır (oynatmaya izin verilmediğinde 0.0) veya ses seviyesi belirlenemiyorsa null değerini alır.
Örnek kullanım için MRAID v3 spesifikasyonuna bakın.
mraid.getLocation()
mraid.getLocation() desteklenmediğinden her zaman -1 döndürür.
mraid.unload()
Bu yöntem herhangi bir zamanda çağrılabilir ve SDK, reklamı kapatarak, kaynakların ayırmasını kaldırarak ve ardından web görünümünü kaldırarak veya başka bir doküman ya da yeni bir reklamla değiştirerek yanıt verir.
Reklam öğesi unload() yöntemini çağırdığında yerel katman, farklı reklam öğesi türleri için aşağıdaki gibi yanıt verir:
| Tür | unload() Davranışı |
|---|---|
| Banner | Mevcut reklamla aynı istek parametrelerine sahip yeni bir reklam isteği gönderin. |
| Geçiş reklamı | Geçiş reklamını kapatın. |
VPAID (Video Oynatıcı Reklam Arayüzü Tanımı)
Google Mobile Ads SDK'sı VPAID'yi desteklemez. mraid.supports('vpaid')
false değerini 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 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üyle değiştirilir. Bu durum, yeniden boyutlandırılan reklam orijinal reklam alanını kaplamıyorsa fark edilir.
Yeniden boyutlandırılan reklamlar, orijinal banner çerçevesine de uymaz. Banner, kaydırılabilir bir görünüme yerleştirilirse yeniden boyutlandırılan reklam banner ile birlikte kaydırılmaz.
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öndürülür ve mraid.setResizeProperties() geçerli parametrelerle tekrar çağrılana kadar sonraki tüm mraid.resize() çağrıları 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 reklamın boyutunu belirlemek için mraid.getScreenSize() kullanın.
mraid.setOrientationProperties()
mraid.setOrientationProperties(), allowOrientationChange özelliği true olarak ayarlanmış şekilde çağrıldığında forceOrientation özelliğinin ayarlanması herhangi bir işlem yapmaz.
Yönü zorunlu kılmak isteyen reklam öğeleri, allowOrientationChange değerini false olarak ayarlamalıdır.
mraid.isViewable()
Bir görünüm, normalde görünür olan bir reklamı kapatı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() çağrısı yapıldığında ekranın boyutu döndürülür.
mraid.storePicture()
Bir uygulamanın mraid.storePicture() özelliğini desteklemesi için android.permission.WRITE_EXTERNAL_STORAGE iznini içermesi gerekir.