IMA'da Open Measurement'ı etkinleştirme

Android için IMA SDK'sı, üçüncü taraf görüntülenebilirlik ve doğrulama ölçümünü etkinleştirmek üzere Interactive Advertising Bureau (IAB) tarafından geliştirilen bir sektör standardı olan Open Measurement (OM) SDK'sını içerir. Android için IMA SDK'sı kullanılırken dahil edilen OM SDK, VAST reklam etiketlerindeki <AdVerifications> etiketini otomatik olarak ayrıştırır ve OMID API aracılığıyla görünürlük verilerini belirtilen ölçüm tedarikçilerine gönderir.IMA SDK, OM SDK v1.4'ü, VAST 2+ üzerindeki GAM AdVerifications uzantılarını ve VAST 4+ üzerindeki AdVerifications düğümünü destekler.Açık Ölçüm'den yararlanmak için aşağıdaki noktaları göz önünde bulundurun:

  • Open Measurement'ı kullanmak için Android için IMA SDK'nın 3.11.0 veya sonraki bir sürümüne sahip olmanız gerekir. Ancak bu kılavuzdaki örnek, SDK'nın en yeni sürümü için tasarlanmıştır ve 3.16.5 sürümünde kullanıma sunulan API'leri içerir.

  • VAST 4.1 veya sonraki bir sürüm kullanılıyorsa reklamlar, VAST 4.1 spesifikasyonuna göre VAST'larında <AdVerifications> olarak trafik oluşturacak şekilde yapılandırılmalıdır. Aksi takdirde <Extension type="AdVerifications"> kullanılmalıdır.

  • OM SDK tarafından engel olarak işaretlenecekleri ve görüntülenebilirliği azaltacakları için AdDisplayContainer öğesini herhangi bir yer paylaşımıyla (şeffaf veya opak) kapatmaktan kaçının.

Ön koşullar

Test

IMA SDK'yı kullanarak Open Measurement'ı test etmek için yukarıdaki SDK'nın gerekli sürümlerinden birini ve bir test reklam etiketi kullanın.

VAST yanıtınızda <AdVerifications> döndürülmelidir.

Video kontrolü yer paylaşımı engellerini kaydetme

Duraklatma düğmeleri veya ilerleme çubukları gibi video kontrolleri, kullanıcılara oynatma ile ilgili temel bilgiler ve işlemler sunar. Mobil cihazlarda, dokunma işlemlerinin hassas olmaması ve kullanıcı beklentileri nedeniyle, medya öğesi üzerinde büyük ve dokunmaya uygun kontroller oluşturmak yaygın bir uygulama haline geldi. Bu kontroller genellikle kullanıcı dokunduğunda görünür ve kaybolur. Oynatma süresinin büyük bir bölümünde görünmez.

YouTube uygulaması tarafından oluşturulan video kontrolleriyle ilgili bir örneği aşağıda bulabilirsiniz:

IMA SDK'sını kullanırken çoğu yayıncı, bu kontrolleri reklam görüntüleme kapsayıcısının üzerine çoğunlukla şeffaf bir görünüm ekleyerek uygular. Genellikle kontroller, temel alınan video oynatıcıyı tamamen kapatan bu görünümün alt öğeleridir. Bu şeffaf yer paylaşımı, dokunma etkinliklerini yakalamak ve ardından dokunulduğunda kontrolleri kullanıcılara göstermek için kullanılır.

Open Measurement SDK'sı aracılığıyla reklam görüntülenebilirliği hesaplanırken medya öğesini kaplayan tüm görünümler engel olarak kabul edilir ve görüntülenebilirlik oranını düşürür. Şeffaf bir dokunma yer paylaşımı, reklamın görüntülendiği kapsayıcının tamamının üzerinde yer alıyorsa envanterin tamamen görüntülenemez olarak bildirilmesi mümkündür.

Open Measurement SDK, video kontrollerinin kullanıcı deneyimi için gerekli olan "kullanıcı dostu" engeller olarak kabul edilmesini sağlar. Bu kontroller, dostça olarak kaydedildikten sonra reklamın görünürlüğü ölçümünden hariç tutulur.

IAB ve MRC desteğiyle IMA SDK, bu yer paylaşımlarını Open Measurement SDK'ya kaydetmek için bir API sunar. Bu kontroller tamamen şeffaf yer paylaşımları veya küçük düğmeler olmalıdır. Video kontrolleriyle ilgili olmayan diğer görüntülemeler kaydedilmemelidir.

DO register KAYDOLMAYIN
  • Kullanıcı dokunmalarını yakalamak için şeffaf yer paylaşımı
  • Geçici düğmeler
    • Duraklat
    • Oynat
    • Tam ekran
    • Yayınlama/AirPlay
    • Daralt
    • İlerleme/Arama
    • Oynatmayla ilgili diğer işlemler
  • Filigranlar
  • Pop-up'lar
  • İletişim kutuları
  • Geçici olmayan düğmeler
  • Diğer gizleyici görünümler

Aşağıdaki örnek kod, video denetimleri yer paylaşımlarının reklam görüntüleme kapsayıcısına nasıl kaydedileceğini gösterir: 

myTransparentTapOverlay = (ViewGroup) rootView.findViewById(R.id.overlay);
myPauseButton = (ImageButton) rootView.findViewById(R.id.pauseButton);
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the
// elements you want to register as video controls overlays.
// Make sure to register before ad playback starts.
overlayObstruction = ImaSdkFactory.createFriendlyObstruction(
  myTransparentTapOverlay,
  FriendlyObstructionPurpose.NOT_VISIBLE,
  "This overlay is transparent"
);
pauseButtonObstruction = ImaSdkFactory.createFriendlyObstruction(
  myPauseButton,
  FriendlyObstructionPurpose.VIDEO_CONTROLS,
  "This is the video player pause button"
);

displayContainer.registerFriendlyObstruction(overlayObstruction);
displayContainer.registerFriendlyObstruction(pauseButtonObstruction);

İşiniz bittiğinde aşağıdaki yöntemi çağırarak bu engelleri kaldırabilirsiniz: 

displayContainer.unregisterAllFriendlyObstructions();