Google Mobile Ads SDK'sı artık MRAID v2 için mevcut desteğin üzerine inşa edilmiş MRAID v3 beta desteğine sahiptir. Bu sayede reklamverenler, Ad Manager yayıncılarına MRAID v3 reklam öğeleri yayınlayabilir. Bu kılavuzda, MRAID v3 spesifikasyonunda net olmayan ve yoruma açık olan MRAID uygulama ayrıntıları açıklanmıştır. Kılavuzun hedef kitlesi, MRAID v3 reklam öğesi yazarlarıdır.
Ön koşullar
Yayıncılar aşağıdakileri yayınlamalıdır:
- MRAID v3 için Google Play Hizmetleri 15.0.0 veya üzeri sürümler
- MRAID v2 için Google Play Hizmetleri 7.8 veya üzeri sürümleri
Faydalı başlangıç kılavuzları
MRAID hakkında bilginiz yoksa IAB MRAID sayfasından daha fazla bilgi edinebilirsiniz. Aşağıda açıklanan tüm parametrelerle ilgili ayrıntıların yer aldığı MRAID v3 Tanımları belgesini ve MRAID v3 ile ilgili IAB 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 dinleyici kullanmanızı öneririz.
mraid.isViewable() yöntemi de kullanımdan kaldırılmıştır. Ancak geriye dönük uyumluluğu korumak için desteği sonlandırılan bu yöntemler desteklenmeye devam eder.
exposureChange etkinlik tanımı, reklam görüntüleme değiştiğinde gönderilir. SDK'da çok fazla etkinlik oluşmasını önlemek için bir anket mekanizması bulunur.
İlk durum, reklam bir dinleyici kaydettikten sonra asenkron 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 ve 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ıdır) göndermez. MRAID sürümü, SDK adı ve SDK sürümü dahil olmak üzere MRAID_ENV nesnesinde gerekli tüm değişkenleri sağlar.
Duyulabilirlik ö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 sunulmuştur.
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 seviyesi 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 döndürülür.
mraid.unload()
Bu yöntem herhangi bir zamanda çağrılabilir. SDK, reklamı kapatarak, kaynakların ayrılmasını sağlayarak ve ardından web görünümünü kaldırarak ya da başka bir doküman veya yeni bir reklamla değiştirerek tepki verir.
Reklam öğesi unload()'ü çağrdığı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 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'i desteklemez. mraid.supports('vpaid')
false döndürür.
mraid.useCustomClose()
mraid.useCustomClose(), biçime ve reklam öğesi türüne bağlı olarak desteklenmeyebilir.
MRAID v2 uygulama ayrıntıları
mraid.getVersion()
mraid.getVersion(), reklam öğesi yüklenene kadar 2.0 döndürmez. mraid.getState() loading 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ü resmiyle değiştirilir. Yeniden boyutlandırılmış reklam, orijinal reklam alanını kapsamıyorsa bu durum fark edilir.
Boyutu değiştirilen reklamlar da orijinal banner çerçevesini takip etmez. Bir banner kaydırmalı bir görünüme yerleştirilirse yeniden boyutlandırılmış reklam, banner ile birlikte kaydırma yapmaz.
mraid.setResizeProperties()
mraid.setResizeProperties() çağrılarının tümü, gerekli özelliklerin eksiksiz bir listesini içermelidir. Yeniden boyutlandırma özellikleri geçersizse varsayılan değerlerine geri ayarlanır ve mraid.setResizeProperties() geçerli parametrelerle tekrar çağrılana kadar mraid.resize()'e yapılan tüm sonraki çağrılar 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() değerini kullanın.
mraid.setOrientationProperties()
allowOrientationChange özelliği true olarak ayarlanmışken mraid.setOrientationProperties() çağrılırken forceOrientation özelliğinin ayarlanması hiçbir şey yapmaz.
Yönlendirmeyi zorlamak isteyen reklam öğeleri, allowOrientationChange değerini false olarak ayarlamalıdır.
mraid.isViewable()
Bir görüntüleme, görünür durumdaki bir reklamı kapsıyorsa mraid.isViewable() yine de true döndürülür. Uygulama içeriği, görünür reklamları kapsamamalıdır.
mraid.getCurrentPosition()
İki parçalı genişletilebilir bir 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()'ü desteklemesi için android.permission.WRITE_EXTERNAL_STORAGE iznini içermesi gerekir.