Mengaktifkan Pengukuran Terbuka

Pilih platform: HTML5 Android iOS

IMA SDK untuk Android mencakup 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 menggunakan OMID API. IMA SDK mendukung OM SDK v1.6, ekstensi GAM AdVerifications di VAST 2+, dan node AdVerifications di VAST 4+.Untuk memanfaatkan Pengukuran Terbuka, perhatikan poin-poin berikut:

  • Untuk menggunakan Pengukuran Terbuka, Anda harus memiliki IMA SDK untuk Android versi 3.11.0 atau yang lebih baru. Namun, contoh dalam panduan ini dirancang untuk IMA SDK versi terbaru dan menyertakan API yang diperkenalkan di versi 3.16.5.

  • 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 IMA versi yang mendukung OM SDK, beserta tag iklan pengujian.

Anda akan melihat <AdVerifications> yang ditampilkan dalam respons VAST.

Mendaftarkan penghalang overlay kontrol video

Kontrol video seperti tombol jeda atau progres bar 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 untuk sebagian besar waktu pemutaran.

Untuk contoh overlay kontrol video, lihat gambar berikut di aplikasi YouTube yang merender kontrol:

Contoh gambar overlay pengukuran terbuka

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 menangkap peristiwa ketuk, lalu merender kontrol kepada pengguna saat diketuk.

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

Open Measurement SDK menyediakan ketentuan agar kontrol video dianggap sebagai penghalang "ramah" yang 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 yang sepenuhnya transparan atau tombol kecil. Tampilan lain yang tidak terkait dengan kontrol video tidak boleh didaftarkan.

DAFTAR JANGAN DAFTAR
  • Overlay transparan untuk menangkap ketukan pengguna
  • Tombol sementara
    • Jeda
    • Putar
    • Layar penuh
    • Transmisi/AirPlay
    • Ciutkan
    • Progres/Cari
    • Tindakan relevan pemutaran lainnya
  • Watermark
  • Pop-up
  • Dialog
  • Tombol non-transient
  • Tampilan penghalang lainnya

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

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

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

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