Open Measurement را فعال کنید

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

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

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

پیش‌نیازها

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

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

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

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

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

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

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

برخی از ارائه‌دهندگان قابلیت مشاهده ممکن است از همه حالت‌های دسترسی پشتیبانی نکنند. برای تأیید اینکه کدام حالت‌ها پشتیبانی می‌شوند، با ارائه‌دهندگان قابلیت مشاهده خود تماس بگیرید. پیش از این، IMA از حالت دسترسی 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.LIMITED;

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

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

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

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

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

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

پیش‌نیازها

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

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

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

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

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

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

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

برخی از ارائه‌دهندگان قابلیت مشاهده ممکن است از همه حالت‌های دسترسی پشتیبانی نکنند. برای تأیید اینکه کدام حالت‌ها پشتیبانی می‌شوند، با ارائه‌دهندگان قابلیت مشاهده خود تماس بگیرید. پیش از این، IMA از حالت دسترسی 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.LIMITED;

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

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

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