Open Measurement'ı etkinleştirme

Platform seçin: HTML5 Android iOS

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 kullanılırken, dahil edilen OM SDK, VAST reklam etiketlerindeki <AdVerifications> etiketini otomatik olarak ayrıştırır ve OMID API'yi kullanarak 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.Open Measurement'tan 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 üzeri 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.

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

Ön koşullar

Test

IMA SDK'yı kullanarak Open Measurement'ı test etmek için OM SDK'yı destekleyen bir IMA sürümü ve 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. Ayrıca, oynatma süresinin büyük bir bölümünde görünmez.

Video kontrollerini yerleştirme örneği için YouTube uygulamasında oluşturma kontrolleriyle ilgili aşağıdaki resme bakın:

Açık ölçüm katmanı örneği resmi

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 olan 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 kullanılarak reklam görüntülenebilirliği hesaplandığında, medya öğesinin üzerindeki 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 görüntüleme kapsayıcısı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, kullanıcı dostu 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
    • Cast/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 kodda, video denetimleri yer paylaşımlarının reklam görüntüleme kapsayıcısına nasıl kaydedileceği gösterilmektedir: 

private void registerFriendlyObstructions(
    AdDisplayContainer adDisplayContainer, View transparentTapOverlay, View pauseButton) {
  ImaSdkFactory imaSdkFactory = ImaSdkFactory.getInstance();
  // Make sure to register all friendly obstructions before ad playback starts.
  FriendlyObstruction overlayObstruction =
      imaSdkFactory.createFriendlyObstruction(
          transparentTapOverlay,
          FriendlyObstructionPurpose.NOT_VISIBLE,
          "This overlay is transparent");
  FriendlyObstruction pauseButtonObstruction =
      imaSdkFactory.createFriendlyObstruction(
          pauseButton,
          FriendlyObstructionPurpose.VIDEO_CONTROLS,
          "This is the video player pause button");

  adDisplayContainer.registerFriendlyObstruction(overlayObstruction);
  adDisplayContainer.registerFriendlyObstruction(pauseButtonObstruction);
}

OpenMeasurementSnippets.java

Bu engelleri kaldırmak için aşağıdaki yöntemi çağırabilirsiniz: 

private void unregisterFriendlyObstructions(AdDisplayContainer adDisplayContainer) {
  adDisplayContainer.unregisterAllFriendlyObstructions();
}
OpenMeasurementSnippets.java