Pengukuran Terbuka

IMA SDK untuk HTML5 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 HTML5, 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. Anda dapat menetapkan aturan mode akses secara opsional untuk setiap permintaan guna mengontrol konten yang dapat diakses oleh skrip verifikasi.

IMA SDK mendukung OM SDK v1.4.

Prasyarat

  • Jika menggunakan VAST 4.1 atau yang lebih baru, iklan harus dikonfigurasi untuk memberikan verifikasi menggunakan <AdVerifications>. Jika menggunakan versi VAST sebelumnya, iklan harus menggunakan <Extension type="AdVerifications">.

  • Jika iklan Anda ditransmisikan melalui Ad Manager, konfigurasikan penyedia data visibilitas untuk jaringan Ad Manager dan tetapkan penyedia data visibilitas tersebut ke item baris Anda. Untuk informasi selengkapnya, lihat Mengonfigurasi penyedia data visibilitas untuk jaringan Ad Manager.

Mode akses

OM SDK mendukung skrip verifikasi yang berjalan dalam empat mode akses berbeda yang mengontrol seberapa banyak skrip verifikasi dapat diakses:

  • FULL: Skrip verifikasi memiliki akses langsung ke materi iklan dan halaman penayang.

  • CREATIVE: Skrip verifikasi dan materi iklan di-sandbox dari halaman penayang. Namun, skrip memiliki akses langsung ke materi iklan.

  • DOMAIN: Skrip verifikasi di-sandbox dan tidak dapat mengakses halaman materi iklan atau penayang. Namun, skrip dimuat sedemikian rupa sehingga dapat langsung mengonfirmasi domain penayang tempatnya berada.

  • LIMITED: Skrip verifikasi di-sandbox dan tidak dapat mengakses halaman iklan atau penayang, dan tidak dapat langsung mengonfirmasi domain penayang tempatnya berada.

Beberapa penyedia visibilitas mungkin tidak mendukung semua mode akses. Hubungi penyedia visibilitas Anda untuk memverifikasi mode yang didukung.

Menetapkan aturan mode akses untuk permintaan

Aturan mode akses harus ditetapkan pada tingkat AdsRequest. Untuk menetapkan mode akses yang berbeda bagi penyedia skrip verifikasi yang berbeda, teruskan kamus yang memetakan setiap OmidVerificationVendor ke salah satu mode akses yang tercantum di atas. Kolom OmidVerificationVendor.OTHER digunakan untuk menetapkan mode akses default untuk semua vendor yang tidak secara eksplisit disertakan dalam kamus. Jika tidak ada aturan mode akses yang ditentukan, skrip verifikasi akan berjalan dalam mode akses LIMITED untuk vendor.

Lihat contoh berikut yang menetapkan GOOGLE ke google.ima.OmidAccessMode.FULL. Semua penyedia lainnya, termasuk yang tercantum dalam OmidVerificationVendor, akan ditetapkan secara default sesuai dengan cara penetapan OmidVerificationVendor.OTHER.

request.omidAccessModeRules = {};
request.omidAccessModeRules[google.ima.OmidVerificationVendor.GOOGLE]
    = google.ima.OmidAccessMode.FULL;
request.omidAccessModeRules[google.ima.OmidVerificationVendor.OTHER]
    = google.ima.OmidAccessMode.DOMAIN;

Untuk menerapkan mode akses CREATIVE, Anda harus mengikuti kedua langkah berikut:

  1. Buat sandbox pemutar video Anda di iframe aman, yang terisolasi dari seluruh situs Anda.

  2. Tetapkan OmidAccessMode untuk partner visibilitas Anda ke FULL.