Open Measurement di IMA SDK

IMA SDK untuk Android 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 Android, OM SDK yang disertakan akan otomatis mengurai tag <AdVerifications> dalam tag iklan VAST dan mengirimkan data visibilitas ke vendor pengukuran yang ditentukan melalui OMID API.IMA SDK mendukung OM SDK v1.4, ekstensi AdVerifikasi GAM di VAST 2+, dan node AdVerifys pada VAST 4+.Untuk memanfaatkan Open Measurement, ingat beberapa poin berikut:

  • Untuk menggunakan Open Measurement, Anda harus memiliki IMA SDK untuk iOS versi3.11.0 atau yang lebih baru. Namun, contoh dalam panduan ini dirancang untuk SDK versi terbaru dan menyertakan API yang diperkenalkan di versi 3.16.5.

  • Iklan harus dikonfigurasi untuk memproses <AdVerifications> di VAST-nya sesuai 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 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, bersama dengan tag iklan percobaan.

Anda akan melihat <AdVerifications> ditampilkan di respons VAST.

Daftarkan penghalang overlay kontrol video

Kontrol video seperti tombol jeda atau status progres memberikan informasi dan tindakan pemutaran yang penting bagi pengguna. Di perangkat seluler, ketukan yang tidak akurat dan ekspektasi pengguna telah menjadikannya praktik yang umum untuk merender kontrol besar yang mudah disentuh pada elemen media. Kontrol ini biasanya makin jelas dan memudar saat pengguna diketuk 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 menutupi pemutar video yang mendasarinya. Overlay transparan ini digunakan untuk merekam peristiwa ketuk, lalu merender kontrol kepada pengguna saat diketuk.

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

Open Measurement SDK membuat penyediaan untuk kontrol video agar dianggap sebagai penghalang yang "cocok" dan penting untuk pengalaman pengguna. Setelah terdaftar sebagai ramah, kontrol ini akan dikecualikan dari pengukuran visibilitas iklan.

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

LAKUKAN pendaftaran JANGAN mendaftar
  • Overlay transparan untuk merekam ketukan pengguna
  • Tombol sementara
    • Jeda
    • Putar
    • Layar penuh
    • Pemeran/AirPlay
    • Ciutkan
    • Progres/Cari
    • Tindakan lain yang relevan terkait pemutaran
  • Watermark
  • Pop-up
  • Dialog
  • Tombol non-sementara
  • Tampilan menghalangi lainnya

Kode contoh berikut menunjukkan cara mendaftarkan overlay kontrol video di penampung tampilan iklan: 

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

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

displayContainer.unregisterAllFriendlyObstructions();