IMA DAI SDK'sında 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 sürümünüzün olması gerekir 3.11.0 veya daha büyük bir kitleye ulaşmayı amaçlıyoruz. 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.

  • AdDisplayContainer bölümünü yer paylaşımlarıyla kapatmayın (şeffaf veya opak) oluşturabilirsiniz. Çünkü bunlar, OM tarafından engellenecek öğeler olarak işaretlenecektir. SDK'lar ve görüntülenebilirliği azaltır.

Ön koşullar

Test

IMA SDK'yı kullanarak Open Measurement'ı test etmek için Bir test reklam etiketiyle birlikte yukarıdaki SDK.

VAST yanıtınızda döndürülen <AdVerifications> değerini görmeniz gerekir.

Video denetimlerini kaydetme yer paylaşımı engelleri

Duraklatma düğmeleri veya ilerleme çubukları gibi video kontrolleri önemli oynatma sağlar bilgi ve eylemleri sunabilir. 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 görünür ve kaybolur ve oynatma süresinin büyük bir bölümünde görünmez.

Aşağıda, YouTube uygulaması tarafından oluşturulan video kontrol düğmelerine örnek verilmiştir:

IMA SDK'yı kullanırken çoğu yayıncı, Çoğunlukla şeffaf olan reklam görüntüleme kapsayıcısının üst kısmındaki görünümdür. 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 için kullanılır ve daha sonra, dokunulduğunda kontrolleri kullanıcılara sunmalıdı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ı kapsarsa envanter, tamamen görünmez olması gerekir.

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 KAYDETMEYİN
  • Kullanıcı dokunmalarını yakalamak için şeffaf yer paylaşımı
  • Geçici düğmeler
    • Duraklat
    • Oynat
    • Tam ekran
    • Yayınla/AirPlay
    • Daralt
    • İlerleme/Arama
    • Oynatma ile ilgili diğer işlemler
  • Filigranlar
  • Pop-up'lar
  • İletişim kutuları
  • Geçici olmayan düğmeler
  • İzleyiciyi gizleyen diğer görünümler

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

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);

Onlarla işiniz bittiğinde, bu engelleri kaldırmak için aşağıdaki yöntem: 

displayContainer.unregisterAllFriendlyObstructions();