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

«کیت توسعه نرم‌افزار IMA برای Android» شامل کیت توسعه نرم‌افزار «اندازه‌گیری باز» (OM)، یک استاندارد صنعتی توسعه‌یافته توسط دفتر تبلیغات تعاملی (IAB) برای فعال کردن دیدپذیری طرف سوم و اندازه‌گیری درستی‌سنجی است. هنگام استفاده از IMA SDK برای Android، OM SDK گنجانده‌شده به‌طور خودکار برچسب <AdVerifications> را در برچسب‌های آگهی VAST تجزیه می‌کند و داده‌های رؤیت‌پذیری را بااستفاده از OMID API به فروشندگان اندازه‌گیری مشخص‌شده ارسال می‌کند. «کیت توسعه نرم‌افزار IMA» از کیت توسعه نرم‌افزار OM نسخه ۱.۶، افزونه‌های «درستی‌سنجی آگهی GAM» در VAST 2+، و گره «درستی‌سنجی آگهی» در VAST 4+ پشتیبانی می‌کند.برای بهره‌مندی از «اندازه‌گیری باز»، نکات زیر را درنظر داشته باشید:

• برای استفاده از «اندازه‌گیری باز»، باید نسخه ۳.۱۱.۰ یا بالاتر از کیت توسعه نرم‌افزار IMA برای Android را داشته باشید. بااین‌حال، نمونه موجود در این راهنما برای جدیدترین نسخه کیت توسعه نرم‌افزار طراحی شده است و شامل میاناهای برنامه‌سازی کاربردی معرفی‌شده در نسخه ۳.۱۶.۵ است.

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

• از پوشاندن AdDisplayContainer با هرگونه رونهاد (شفاف یا مات) خودداری کنید، زیرا این موارد توسط «کیت توسعه نرم‌افزار OM» به‌عنوان موانع علامت‌گذاری می‌شوند و قابلیت مشاهده را کاهش می‌دهند.

پیش‌نیازها

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

آزمایش

برای آزمایش «اندازه‌گیری باز» بااستفاده از «کیت توسعه نرم‌افزار IMA»، از نسخه‌ای از IMA که از «کیت توسعه نرم‌افزار OM» پشتیبانی می‌کند، همراه با برچسب آگهی آزمایشی استفاده کنید.

باید <AdVerifications> را در پاسخ VAST خود ببینید.

ثبت موانع رونهاد کنترل‌های ویدیو

کنترل‌های ویدیو مانند دکمه‌های توقف موقت یا نوارهای پیشرفت، اطلاعات و کنش‌های ضروری برای بازپخش را در اختیار کاربران قرار می‌دهند. در تلفن همراه، ضربه‌های غیردقیق و انتظارات کاربر باعث شده است که ارائه کنترل‌های بزرگ و لمس‌پسند روی عنصر رسانه به یک رویه معمول تبدیل شود. این کنترل‌ها معمولاً با ضربه کاربر ظاهر و ناپدید می‌شوند و در اکثر زمان پخش قابل مشاهده نیستند.

برای نمونه‌ای از رونهاد کردن کنترل‌های ویدیو، تصویر زیر را در کنترل‌های پردازنده برنامه YouTube ببینید:

هنگام استفاده از IMA SDK، اکثر ناشران این کنترل‌ها را با افزودن یک نمای بالای ظرف نمایش آگهی که عمدتاً شفاف است، پیاده‌سازی می‌کنند. معمولاً، کنترل‌ها عناصر فرزند این نما هستند که به‌طور کامل پخش‌کننده ویدیو زیرین را می‌پوشانند. این رونهاد شفاف برای ضبط رویدادهای تک‌ضرب و سپس پرداز کردن کنترل‌ها برای کاربران هنگام تک‌ضرب استفاده می‌شود.

وقتی رؤیت‌پذیری آگهی بااستفاده از «کیت توسعه نرم‌افزار اندازه‌گیری باز» محاسبه می‌شود، همه بازدیدهای روپوشانی عنصر رسانه به‌عنوان موانع درنظر گرفته می‌شوند و نرخ رؤیت‌پذیری را کاهش می‌دهند. در مواردی که رونهاد ضربه شفاف بالای کل محتوی نمایش آگهی قرار می‌گیرد، ممکن است فضای آگهی کاملاً غیرقابل‌مشاهده اعلام شود.

کیت توسعه نرم‌افزار Open Measurement تمهیداتی را برای کنترل‌های ویدیو فراهم می‌کند تا به‌عنوان موانع «دوستانه» که برای تجربه کاربر ضروری هستند درنظر گرفته شوند. پس‌از ثبت شدن به‌عنوان دوستانه، این کنترل‌ها از اندازه‌گیری رؤیت‌پذیری آگهی کنار گذاشته می‌شوند.

با پشتیبانی IAB و MRC، کیت توسعه نرم‌افزار IMA یک API برای ثبت این رونهادها با کیت توسعه نرم‌افزار Open Measurement معرفی می‌کند. این کنترل‌ها باید کاملاً شفاف باشند روپوش‌ها یا دکمه‌های کوچک. هر نمای دیگری که به کنترل‌های ویدیو مربوط نیست نباید ثبت شود.

کد نمونه زیر نحوه ثبت کردن رونهادهای کنترل‌های ویدیو را در ظرف نمایش آگهی نشان می‌دهد:

private void registerFriendlyObstructions(
    AdDisplayContainer adDisplayContainer, View transparentTapOverlay, View pauseButton) {
  ImaSdkFactory imaSdkFactory = ImaSdkFactory.getInstance();
  // Make sure to register all friendly obstructions before ad playback starts.
  FriendlyObstruction overlayObstruction =
      imaSdkFactory.createFriendlyObstruction(
          transparentTapOverlay,
          FriendlyObstructionPurpose.NOT_VISIBLE,
          "This overlay is transparent");
  FriendlyObstruction pauseButtonObstruction =
      imaSdkFactory.createFriendlyObstruction(
          pauseButton,
          FriendlyObstructionPurpose.VIDEO_CONTROLS,
          "This is the video player pause button");

  adDisplayContainer.registerFriendlyObstruction(overlayObstruction);
  adDisplayContainer.registerFriendlyObstruction(pauseButtonObstruction);
}
OpenMeasurementSnippets.java

وقتی کارتان با آن‌ها تمام شد، این موانع را می‌توانید با فراخوانی روش زیر بردارید:

private void unregisterFriendlyObstructions(AdDisplayContainer adDisplayContainer) {
  adDisplayContainer.unregisterAllFriendlyObstructions();
}
OpenMeasurementSnippets.java