Mengaktifkan Pengukuran Terbuka

Pilih platform: HTML5 Android iOS

IMA SDK untuk iOS menyertakan Open Measurement (OM) SDK, standar industri yang dikembangkan oleh Interactive Advertising Bureau (IAB) untuk memungkinkan 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 menggunakan OMID API. IMA SDK mendukung OM SDK v1.6, ekstensi AdVerifications GAM 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 iOS versi 3.9.0 atau yang lebih tinggi.

  • Iklan harus dikonfigurasi untuk memproses <AdVerifications> dalam 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 hal ini akan ditandai sebagai penghalang oleh OM SDK dan mengurangi visibilitas.

Prasyarat

Pengujian

Untuk menguji Open Measurement menggunakan IMA SDK, gunakan versi IMA yang mendukung OM SDK, beserta tag iklan pengujian.

Anda akan melihat <AdVerifications> ditampilkan dalam respons VAST.

Mendaftarkan penghalang overlay kontrol video

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

Untuk contoh kontrol video overlay, lihat gambar berikut tentang kontrol rendering aplikasi YouTube:

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 SDK pengukuran Open Measurement dihitung, semua tampilan yang menempatkan elemen media 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 "yang tidak mengganggu" dan penting bagi pengalaman pengguna. Setelah didaftarkan sebagai visibilitas yang diizinkan, kontrol ini akan dikecualikan dari pengukuran visibilitas iklan.

Dengan dukungan IAB dan MRC, IMA SDK memperkenalkan API untuk mendaftarkan overlay ini ke 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 DO JANGAN mendaftar
  • Overlay transparan untuk menangkap ketukan pengguna
  • Tombol sementara
    • Jeda
    • Putar
    • Layar penuh
    • Transmisi/AirPlay
    • Ciutkan
    • Progres/Mencari
    • Tindakan relevan pemutaran lainnya
  • Watermark
  • Pop-up
  • Dialog
  • Tombol non-transien
  • Tampilan lain yang menghalangi

Kode contoh 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)];
// Replace myTransparentTapOverlay and myPauseButton with your own elements
// that function as video control 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:

Objective-C 

- (void)unregisterObstructionsForContainer:(IMAAdDisplayContainer *)displayContainer {
    // This removes all previously registered friendly obstructions from the container.
    [displayContainer unregisterAllFriendlyObstructions];
}

Swift 

func unregisterObstructions(displayContainer: IMAAdDisplayContainer) {
  // This removes all previously registered friendly obstructions from the container.
  displayContainer.unregisterAllFriendlyObstructions()
}