باز کردن اندازه‌گیری

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

IMA SDK از OM SDK v1.4 پشتیبانی می کند.

پیش نیازها

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

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

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

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

  • FULL : اسکریپت تأیید دسترسی مستقیم به صفحه خلاق و ناشر دارد.

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

  • DOMAIN : اسکریپت تأیید در جعبه ایمنی است و نمی تواند به صفحه خلاق یا ناشر دسترسی پیدا کند. با این حال، اسکریپت به گونه ای بارگذاری می شود که می تواند مستقیماً تأیید کند که در کدام دامنه ناشر قرار دارد.

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

برخی از ارائه دهندگان قابلیت مشاهده ممکن است از همه حالت های دسترسی پشتیبانی نکنند. برای بررسی اینکه کدام حالت ها پشتیبانی می شوند، با ارائه دهندگان قابلیت مشاهده خود تماس بگیرید.

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

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

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

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

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

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

  2. OmidAccessMode را برای شریک قابلیت مشاهده خود روی FULL تنظیم کنید.