Mengaktifkan Pengukuran Terbuka

Interactive Media Ads (IMA) SDK untuk iOS.

IMA SDK untuk iOS menyertakan Open Measurement (OM) SDK, standar industri yang dikembangkan oleh Interactive Advertising Bureau (IAB) untuk mengaktifkan pengukuran visibilitas dan verifikasi pihak ketiga. Saat menggunakan IMA SDK untuk iOS, OM SDK yang disertakan akan otomatis mem-parsing tag <AdVerifications> dalam tag iklan VAST dan mengirimkan data keaktifan ke vendor pengukuran yang ditentukan melalui OMID API.IMA SDK mendukung OM SDK v1.4, ekstensi Verifikasi Iklan GAM di VAST 2+, dan node Verifikasi Iklan di VAST 4+.Untuk memanfaatkan Pengukuran Terbuka, perhatikan poin-poin berikut:

  • Untuk menggunakan Pengukuran Terbuka, Anda harus memiliki IMA SDK untuk iOS versi 3.9.0 atau yang lebih baru.

  • Iklan harus dikonfigurasi untuk menayangkan <AdVerifications> di VAST-nya sesuai dengan spesifikasi VAST 4.1 jika menggunakan VAST 4.1+; jika tidak, <Extension type="AdVerifications"> harus digunakan.

  • Jangan menutupi AdDisplayContainer dengan overlay apa pun (transparan atau buram), karena overlay ini akan ditandai sebagai penghalang oleh OM SDK dan mengurangi visibilitas.

Prasyarat

Pengujian

Untuk menguji Pengukuran Terbuka menggunakan IMA SDK, gunakan salah satu versi SDK yang diperlukan di atas, beserta tag iklan uji coba.

Anda akan melihat <AdVerifications> ditampilkan dalam respons VAST.

Mendaftarkan halangan overlay kontrol video

Kontrol video seperti tombol jeda atau status progres memberikan informasi dan tindakan pemutaran penting kepada pengguna. Di perangkat seluler, ketukan yang tidak akurat dan ekspektasi pengguna telah menjadikan praktik umum untuk merender kontrol besar yang mudah disentuh di atas elemen media. Kontrol ini biasanya muncul dan menghilang saat pengguna mengetuk dan tidak terlihat selama sebagian besar waktu pemutaran.

Di bawah ini adalah contoh kontrol video yang dirender oleh aplikasi YouTube:

Saat menggunakan IMA SDK, sebagian besar penayang menerapkan kontrol ini dengan menambahkan tampilan di atas penampung tampilan iklan yang sebagian besar transparan. Biasanya, kontrol adalah elemen turunan dari tampilan ini yang sepenuhnya menghalangi pemutar video di bawahnya. Overlay transparan ini digunakan untuk merekam peristiwa ketuk, lalu merender kontrol kepada pengguna saat diketuk.

Saat visibilitas iklan melalui Open Measurement SDK dihitung, semua tampilan yang menutupi elemen media dianggap sebagai penghalang dan mengurangi rasio visibilitas. Jika overlay ketuk transparan berada di atas seluruh penampung tampilan iklan, inventaris dapat dinyatakan sebagai tidak dapat dilihat sama sekali.

SDK Pengukuran Terbuka menyediakan kontrol video untuk dianggap sebagai hambatan "ramah" yang penting bagi pengalaman pengguna. Setelah didaftarkan sebagai ramah, kontrol ini dikecualikan dari pengukuran keterlihatan iklan.

Dengan dukungan IAB dan MRC, IMA SDK memperkenalkan API untuk mendaftarkan overlay ini dengan Open Measurement SDK. Kontrol ini harus berupa overlay yang sepenuhnya transparan atau tombol kecil. Tampilan lain yang tidak terkait dengan kontrol video tidak boleh didaftarkan.

Mendaftar DO JANGAN mendaftar
  • Overlay transparan untuk merekam ketukan pengguna
  • Tombol sementara
    • Jeda
    • Putar
    • Layar penuh
    • Transmisikan/AirPlay
    • Ciutkan
    • Progres/Cari
    • Tindakan lain yang relevan dengan pemutaran
  • Watermark
  • Pop-up
  • Dialog
  • Tombol tidak sementara
  • Lainnya yang menghalangi tampilan

Contoh kode berikut menunjukkan cara mendaftarkan overlay kontrol video pada penampung tampilan iklan:

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

Setelah selesai, penghalang ini dapat dihapus dengan memanggil metode berikut:

[displayContainer unregisterAllFriendlyObstructions];