IMA SDK'da Open Measurement

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

  • Open Measurement'ı kullanmak için Android için IMA SDK'sının 3.11.0 veya sonraki bir sürümüne sahip olmanız gerekir. Ancak bu kılavuzda yer alan ö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'lerinde <AdVerifications> trafiği olacak şekilde yapılandırılmalıdır. Aksi takdirde <Extension type="AdVerifications"> kullanılmalıdır.

  • OM SDK'sı tarafından engel olarak işaretlenip görüntülenebilirliği azaltacağından AdDisplayContainer'ü herhangi bir yer paylaşımıyla (şeffaf veya opak) kapatmayın.

Ön koşullar

Test

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

VAST yanıtınızda <AdVerifications> döndürüldüğünü görürsünüz.

Video kontrolleri yer paylaşımı engellerini kaydetme

Duraklatma düğmeleri veya ilerleme çubukları gibi video kontrolleri, kullanıcılara oynatmayla ilgili önemli bilgiler ve işlemler sunar. Mobil cihazlarda, yanlış dokunuşlar ve kullanıcı beklentileri, medya öğesi üzerinde büyük ve dokunmaya uygun kontroller oluşturmayı yaygın bir uygulama haline getirdi. Bu kontroller genellikle kullanıcının dokunmasıyla yavaş yavaş görünür ve oynatma süresinin büyük bir kısmında görünmez.

YouTube uygulaması tarafından oluşturulan video kontrollerinin bir örneğini aşağıda bulabilirsiniz:

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

Open Measurement SDK'sı aracılığıyla reklam görüntülenebilirliği hesaplanırken, medya öğesinin üzerine binen tüm görüntüler engel olarak kabul edilir ve görüntülenebilirlik oranını düşürür. Şeffaf bir dokunma yer paylaşımının reklam görüntüleme kapsayıcısının tamamının üzerinde yer aldığı durumlarda envanterin tamamen görüntülenemez olarak tanımlanması mümkündür.

Open Measurement SDK'sı, video denetimlerinin kullanıcı deneyimi için gerekli olan "dost" engeller olarak değerlendirilmesi için gerekli düzenlemeleri yapar. Dost olarak kaydedilen bu kontroller, reklam görüntülenebilirliği ölçümünden hariç tutulur.

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

KAYDET Kaydetmeyin
  • Kullanıcıların dokunmalarını sağlamak için şeffaf yer paylaşımı
  • Geçici düğmeler
    • Duraklat
    • Oynat
    • Tam ekran
    • Yayınla/AirPlay
    • Daralt
    • İlerleme/Ara
    • Oynatma ile ilgili diğer işlemler
  • Filigranlar
  • Pop-up'lar
  • İletişim kutuları
  • Geçici olmayan düğmeler
  • Görüntüleri gizleyen diğer görünümler

Aşağıdaki örnek kod, reklam görüntüleme kapsayıcısında video kontrolü yer paylaşımlarının 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 engellemeleri kaldırabilirsiniz: 

displayContainer.unregisterAllFriendlyObstructions();