Google Mobile Ads SDK'sı artık MRAID v2'nin mevcut desteği üzerine kurulu MRAID v3 için beta desteğine sahip. Bu sayede reklamverenler, Ad Manager yayıncılarına MRAID v3 reklam öğeleri yayınlayabiliyor. Bu kılavuz, MRAID v3 spesifikasyonunda belirsiz olan ve farklı yorumlanabilen 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 şunları kullanmalı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ümler
Faydalı başlangıç kılavuzları
MRAID'e aşina değilseniz IAB MRAID sayfasından daha fazla bilgi edinebilirsiniz. Ayrıca, aşağıda bahsedilen 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. 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 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 algılama 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ıdır) 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 düzeyinin ne zaman değiştiğini belirlemek için yeni bir etkinlik (audioVolumeChange) kullanıma sunulur.
audioVolumeChange etkinliğinin tek bir parametresi vardır: volume_percentage.
Değer, maksimum ses çalma hacminin 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 düzeyi belirlenemezse null'dir.
Ö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ı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 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ü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ırma görünümüne yerleştirilen banner'lar yeniden boyutlandırıldığında, yeniden boyutlandırılan reklam banner'la birlikte kaydırılmaz.
mraid.setResizeProperties()
mraid.setResizeProperties() ile ilgili 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() 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 döndürülür
true. 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()'ı desteklemesi için android.permission.WRITE_EXTERNAL_STORAGE iznini içermesi gerekir.