IMA SDK untuk HTML5 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 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 untuk setiap permintaan guna mengontrol
konten yang dapat diakses oleh skrip verifikasi.
IMA SDK mendukung OM SDK v1.6.
Prasyarat
Jika menggunakan VAST 4.1 atau yang lebih tinggi, iklan harus dikonfigurasi untuk memberikan verifikasi menggunakan
<AdVerifications>. Jika menggunakan versi VAST sebelumnya, iklan harus menggunakan<Extension type="AdVerifications">.Jika iklan Anda diproses melalui Ad Manager, konfigurasikan penyedia data visibilitas untuk jaringan Ad Manager dan tetapkan penyedia data visibilitas tersebut ke item baris Anda. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi penyedia data visibilitas untuk jaringan Ad Manager.
Mode akses
OM SDK mendukung menjalankan skrip verifikasi dalam empat mode akses berbeda yang mengontrol seberapa banyak skrip verifikasi dapat mengakses:
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.LIMITED: Skrip verifikasi di-sandbox dan tidak dapat mengakses halaman materi iklan atau penayang, serta tidak dapat mengonfirmasi secara langsung domain penayang tempat skrip tersebut berada.
Beberapa penyedia data visibilitas mungkin tidak mendukung semua mode akses. Hubungi
penyedia data visibilitas Anda untuk memverifikasi mode yang didukung. Sebelumnya, IMA
mendukung mode akses DOMAIN, yang kini ditetapkan secara default ke mode LIMITED.
Menetapkan aturan mode akses untuk permintaan
Aturan mode akses harus ditetapkan di levelAdsRequest. 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 bagi semua vendor yang tidak disertakan
secara eksplisit 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,
menggunakan setelan default OmidVerificationVendor.OTHER.
request.omidAccessModeRules = {};
request.omidAccessModeRules[google.ima.OmidVerificationVendor.GOOGLE]
= google.ima.OmidAccessMode.FULL;
request.omidAccessModeRules[google.ima.OmidVerificationVendor.OTHER]
= google.ima.OmidAccessMode.LIMITED;
Untuk menerapkan mode akses CREATIVE, Anda harus mengikuti kedua langkah berikut:
Lakukan sandbox pada pemutar video Anda dalam iframe yang aman, yang terisolasi dari bagian lain situs Anda.
Tetapkan
OmidAccessModeuntuk partner visibilitas Anda keFULL.