Google Mobile Ads SDK'sı artık MRAID v2 için mevcut destek üzerine kurulu MRAID v3'ü beta olarak destekliyor. Bu sayede reklamverenler, Ad Manager yayıncılarına MRAID v3 reklam öğeleri sunabiliyor. 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 iOS 7.30.0 veya üzeri sürümlerdeki Google Mobile Ads SDK'sı
- MRAID v2 için iOS 7.4.0 veya üzeri sürümlerdeki Google Mobile Ads SDK'sı
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 edecektir.
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 belirlenemiyorsa 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() döndürülmez 2.0. 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 banner yerleştirilirse yeniden boyutlandırılan reklam banner ile 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 olacak 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.supports()
SDK sürümü 7.11.0'dan itibaren mraid.supports("storePicture") ve mraid.supports("calendar") her zaman false değerini döndürür. MRAID v2 spesifikasyonuna göre,
reklam öğeleri bu yöntemlerin kullanılamadığı durumu işleyebilmelidir.
mraid.storePicture()
Uygulama, MRAID reklam öğesi mraid.storePicture() işlevini çağırdığında otomatik olarak resim kaydetme izni ister.