Google Mobile Ads SDK'sı artık MRAID v2 desteği üzerine kurulu MRAID v3 için beta desteği sunuyor. Bu sayede reklamverenler, Ad Manager yayıncılarına MRAID v3 reklam öğeleri yayınlayabiliyor. Bu kılavuz, MRAID v3 spesifikasyonunda belirsiz olan ve yoruma açık bırakılan MRAID uygulama ayrıntılarını netleştirir. Kılavuzun hedef kitlesi, MRAID v3 reklam öğesi yazarlarıdır.
Ön koşullar
Yayıncılar:
Faydalı başlangıç kılavuzları
MRAID hakkında bilginiz yoksa IAB MRAID sayfasından daha fazla bilgi edinebilirsiniz. Ayrıca, aşağıda ele alınan tüm parametreler hakkında ayrıntılı bilgi veren MRAID v3 Tanımları belgesini ve IAB'nin MRAID v3 ile ilgili blog yayınını da indirebilirsiniz.
MRAID v3 (beta) uygulama ayrıntıları
Görüntülenebilirlik - exposureChange etkinliği
Bu etkinlik desteklenir ve kullanımdan kaldırılan viewableChange etkinliği yerine yeni exposureChange etkinliği için bir işleyici kullanmanızı öneririz.
mraid.isViewable() yöntemi de artık kullanılmıyor. Ancak geriye dönük uyumluluğu korumak için bu desteği sonlandırılan yöntemler desteklenmeye devam etmektedir.
Reklam görünümü her değiştiğinde exposureChange etkinlik tanımı gönderilir. SDK, çok fazla etkinlik oluşturulmasını önlemek için bir yoklama mekanizmasına sahiptir.
İlk durum, reklam bir dinleyici kaydettikten sonra eşzamansız olarak gönderilir.
Geri çağırma, exposed_percentage parametresini içerir. Bu parametre, 0.0 ile 100.0 arasında bir kayan nokta sayısıdır.
Örnek kullanım için MRAID v3 spesifikasyonuna bakın.
MRAID tespiti ve başlatma ile MRAID_ENV özellikleri
SDK, MRAID v3 spesifikasyonunda tanımlandığı şekilde başlatma protokolüne uygundur.
SDK, MRAID_ENV nesnesinde IDFA, limitAdTracking, uygulama kimliği veya COPPA'yı (isteğe bağlı) göndermez. MRAID sürümü, SDK adı ve SDK sürümü dahil olmak üzere MRAID_ENV nesnesindeki tüm gerekli değişkenleri sağlar.
Duyulabilirlik ölçümü
Sesin duyulup duyulmadığı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 ses düzeyinin yüzdesidir. Bu, 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'dir.
Örnek kullanım için MRAID v3 spesifikasyonuna bakın.
mraid.getLocation()
mraid.getLocation() desteklenmediği için her zaman -1 değerini döndürür.
mraid.unload()
Bu yöntem herhangi bir zamanda çağrılabilir. SDK, reklamı kapatarak, kaynakların tahsisini 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 tepki verir.
Reklam öğesi unload() çağrısı yaptığında, yerel katman farklı reklam öğesi türleri için aşağıdaki şekilde yanıt verir:
| Tür | unload() davranışı |
|---|---|
| Banner | Mevcut reklamla aynı istek parametrelerini kullanarak yeni bir reklam isteğinde bulunun. |
| 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()
Reklam öğesi yüklenene kadar mraid.getVersion() 2.0 döndürülmez. 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. Yeniden boyutlandırılan reklam, orijinal reklam alanını kapsamıyorsa bu durum fark edilebilir.
Yeniden boyutlandırılan reklamlar da orijinal banner çerçevesini takip etmez. Kaydırılabilir bir görünüme yerleştirilen banner, yeniden boyutlandırılan reklamla birlikte kaydırılmaz.
mraid.setResizeProperties()
mraid.setResizeProperties() ile yapılan tüm çağrılar, gerekli özelliklerin eksiksiz bir listesini içermelidir. Yeniden boyutlandırma özellikleri geçersizse varsayılan değerlerine geri ayarlanır ve mraid.resize() için yapılan tüm sonraki ç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ılmış reklamların maksimum boyutunu belirlemek için kullanılmalıdır. Genişletilebilir bir reklamın boyutunu belirlemek için mraid.getScreenSize() simgesini kullanın.
mraid.setOrientationProperties()
mraid.setOrientationProperties() işlevi allowOrientationChange özelliği true olarak ayarlanmış şekilde çağrıldığında forceOrientation özelliğinin ayarlanması herhangi bir işe yaramaz.
Yönü zorlamak isteyen reklam öğeleri allowOrientationChange değerini false olarak ayarlamalıdır.
mraid.isViewable()
Bir görünüm, aksi takdirde görünür olan bir reklamı kapsıyorsa mraid.isViewable() yine de true döndürülür. Uygulama içeriği, görünür reklamları kapatmamalıdır.
mraid.getCurrentPosition()
İki parçalı genişletilebilir bir reklam genişletilmiş durumdayken ilk parçadaki mraid.getCurrentPosition() işlevine yapılan ç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.