فعال کردن اندازه‌گیری باز

پلاتفرم را انتخاب کنید: HTML5 Android iOS

کیت توسعه نرم‌افزار IMA برای HTML5 شامل کیت توسعه نرم‌افزار Open Measurement (OM) است، یک استاندارد صنعتی که توسط Interactive Advertising Bureau (IAB) توسعه یافته است تا امکان اندازه‌گیری قابلیت مشاهده و درستی‌سنجی طرف سوم را فراهم کند. هنگام استفاده از IMA SDK برای HTML5، OM SDK موجود به‌طور خودکار برچسب <AdVerifications> را در برچسب‌های آگهی VAST تجزیه می‌کند و داده‌های رؤیت‌پذیری را بااستفاده از OMID API به فروشندگان اندازه‌گیری مشخص‌شده ارسال می‌کند. می‌توانید به‌طور اختیاری برای هر درخواست، قوانین حالت دسترسی تنظیم کنید تا محتوایی را که اسکریپت درستی‌سنجی می‌تواند به آن دسترسی داشته باشد کنترل کنید.

کیت توسعه نرم‌افزار IMA از کیت توسعه نرم‌افزار OM نسخه ۱.۶ پشتیبانی می‌کند.

پیش‌نیازها

  • اگر از VAST نسخه ۴.۱ یا بالاتر استفاده می‌کنید، آگهی‌ها باید برای ارائه درستی‌سنجی بااستفاده از <AdVerifications> پیکربندی شوند. اگر از نسخه‌های قبلی VAST استفاده می‌کنید، آگهی‌ها باید از <Extension type="AdVerifications"> استفاده کنند.

  • اگر آگهی‌هایتان ازطریق Ad Manager ترافیک دریافت می‌کنند، ارائه‌دهنده رؤیت‌پذیری را برای شبکه Ad Manager خود پیکربندی کنید و آن ارائه‌دهنده رؤیت‌پذیری را به ردیف خود اختصاص دهید. برای اطلاعات بیشتر، پیکربندی ارائه‌دهنده رؤیت‌پذیری برای شبکه Ad Manager را ببینید.

حالت‌های دسترسی

OM SDK از اجرای اسکریپت‌های درستی‌سنجی در چهار حالت دسترسی مختلف پشتیبانی می‌کند که میزان دسترسی اسکریپت درستی‌سنجی را کنترل می‌کند:

  • FULL: اسکریپت درستی‌سنجی دسترسی مستقیم به طرح‌آگهی و صفحه ناشر دارد.

  • CREATIVE: اسکریپت درستی‌سنجی و طرح آگهی از صفحه ناشر در جعبه امن قرار داده شده‌اند. بااین‌حال، اسکریپت دسترسی مستقیم به طرح آگهی دارد.

  • LIMITED: اسکریپت درستی‌سنجی در جعبه امن قرار دارد و نمی‌تواند به طرح‌آگهی یا صفحه ناشر دسترسی داشته باشد، و نمی‌تواند مستقیماً تأیید کند که در کدام دامنه ناشر قرار دارد.

برخی‌از ارائه‌دهندگان قابلیت مشاهده ممکن است از همه حالت‌های دسترسی پشتیبانی نکنند. با ارائه‌دهندگان قابلیت مشاهده تماس بگیرید تا ببینید کدام حالت‌ها پشتیبانی می‌شود. قبلاً، IMA از حالت دسترسی DOMAIN پشتیبانی می‌کرد که اکنون به‌طور پیش‌فرض به حالت LIMITED تغییر کرده است.

تنظیم قوانین حالت دسترسی برای درخواست

قوانین حالت دسترسی باید در سطح AdsRequest تنظیم شود. برای تنظیم حالت‌های دسترسی مختلف برای ارائه‌دهندگان اسکریپت درستی‌سنجی مختلف، واژه‌نامه‌ای را ارسال کنید که هر OmidVerificationVendor را به یکی از حالت‌های دسترسی فهرست‌شده در بالا نگاشت کند. از فیلد OmidVerificationVendor.OTHER برای تنظیم حالت دسترسی پیش‌فرض برای همه فروشندگانی که به‌طور صریح در واژه‌نامه گنجانده نشده‌اند استفاده می‌شود. اگر هیچ قانون حالت دسترسی مشخص نشده باشد، اسکریپت‌های درستی‌سنجی در حالت دسترسی LIMITED برای فروشندگان اجرا می‌شود.

مثال زیر را ببینید که GOOGLE را روی google.ima.OmidAccessMode.FULL تنظیم می‌کند. همه ارائه‌دهندگان دیگر، ازجمله ارائه‌دهندگانی که در OmidVerificationVendor فهرست شده‌اند، به‌طور پیش‌فرض از تنظیمات OmidVerificationVendor.OTHER استفاده می‌کنند.

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

برای پیاده‌سازی حالت دسترسی CREATIVE، باید هر دو مرحله زیر را دنبال کنید:

  1. پخش‌کننده ویدیو را در یک iframe امن، جدا از بقیه سایت خود، در محیط آزمایشی قرار دهید.

  2. OmidAccessMode را برای شریک رؤیت‌پذیری‌تان روی FULL تنظیم کنید.