Open Measurement di IMA DAI SDK

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 mengurai tag <AdVerifications> dalam tag iklan VAST dan mengirim data visibilitas ke vendor pengukuran yang ditentukan melalui OMID API. IMA SDK mendukung OM SDK v1.4, ekstensi AdVerifications GAM di VAST 2+, dan node AdVerifications di VAST 4+. Untuk memanfaatkan Pengukuran Terbuka, perhatikan poin berikut:

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

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

  • Jangan menutupi AdDisplayContainer dengan overlay (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 yang diperlukan SDK di atas, bersama dengan tag iklan percobaan.

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

Mendaftarkan halangan overlay kontrol video

Kontrol video seperti tombol jeda atau status progres memberikan informasi dan tindakan pemutaran yang penting kepada pengguna. Pada perangkat seluler, ketukan yang tidak akurat dan penggunaan telah menjadi praktik umum untuk merender gambar besar, mengontrol elemen media. Kontrol ini biasanya memudar dan muncul saat pengguna mengetuk dan tidak terlihat selama sebagian besar waktu pemutaran.

Berikut adalah contoh kontrol video yang dirender oleh aplikasi YouTube:

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

Saat visibilitas iklan melalui Open Measurement SDK dihitung, semua penayangan menempatkan elemen media dianggap sebagai penghalang dan mengurangi dan rasio visibilitas. Jika overlay ketuk transparan berada di atas keseluruhan penampung tampilan iklan, inventaris dapat dideklarasikan benar-benar tidak terlihat.

Open Measurement SDK membuat penyediaan untuk kontrol video yang perlu dipertimbangkan "ramah" gangguan yang penting bagi pengalaman pengguna. Setelah terdaftar sebagai iklan yang tidak mengganggu, kontrol ini akan dikecualikan dari pengukuran visibilitas iklan.

Dengan dukungan IAB dan MRC, IMA SDK memperkenalkan API untuk mendaftarkan overlay 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.

Pendaftaran DO JANGAN mendaftar
  • Overlay transparan untuk menangkap ketukan pengguna
  • Tombol sementara
    • Jeda
    • Putar
    • Layar penuh
    • Transmisikan/AirPlay
    • Ciutkan
    • Progres/Cari
    • Tindakan lainnya yang relevan untuk pemutaran
  • Watermark
  • Pop-up
  • Dialog
  • Tombol non-sementara
  • Tampilan lain yang mengaburkan

Kode contoh berikut menunjukkan cara mendaftarkan overlay kontrol video di 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, hambatan ini dapat dihapus dengan memanggil metode berikut:

[displayContainer unregisterAllFriendlyObstructions];