IMA SDK'da Open Measurement

iOS 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. iOS 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 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 iOS için IMA SDK'sının 3.9.0 veya sonraki bir sürümüne sahip olmanız gerekir.

  • Reklamlar, VAST 4.1 ve sonraki sürümleri kullanılıyorsa VAST'larında <AdVerifications> öğesini VAST 4.1 spesifikasyonuna göre sunacak ş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 önemli oynatma bilgileri ve işlemleri sağlar. 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ı dokunulduğunda kararır ve kaybolur ve oynatma süresinin büyük kısmında 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ı, bu denetimleri reklam görüntüleme kapsayıcısının üst kısmına çoğunlukla şeffaf bir görünüm ekleyerek uygular. Genellikle kontroller, temel 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 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.

DO kaydı Kaydetmeyin
  • Kullanıcı dokunmalarını yakalamak 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 kodda, video denetimleri yer paylaşımlarının reklam görüntüleme kapsayıcısına nasıl kaydedileceği gösterilmektedir: 

UIView *myTransparentTapOverlay = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 300, 250)];
UIButton *myPauseButton = [[UIButton alloc] initWithFrame:CGRectMake(0, 0, 50, 10)];
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the elements
// you want to register as video controls overlays.
// Make sure to register before ad playback starts.
IMAFriendlyObstruction *overlayObstruction =
      [[IMAFriendlyObstruction alloc] initWithView:myTransparentTapOverlay
                                           purpose:IMAFriendlyObstructionPurposeNotVisible
                                    detailedReason:@"This overlay is transparent"];
IMAFriendlyObstruction *pauseButtonObstruction =
      [[IMAFriendlyObstruction alloc] initWithView:myPauseButton
                                           purpose:IMAFriendlyObstructionPurposeMediaControls
                                    detailedReason:@"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];