کیت توسعه نرم‌افزاری تبلیغات موبایل گوگل (Google Mobile Ads SDK) اکنون از نسخه بتای MRAID نسخه ۳ پشتیبانی می‌کند که بر اساس پشتیبانی موجود از نسخه ۲ MRAID ساخته شده است و به تبلیغ‌کنندگان امکان می‌دهد تا محتوای خلاقانه MRAID نسخه ۳ را به ناشران Ad Manager ارائه دهند. این راهنما جزئیات پیاده‌سازی MRAID را که در مشخصات MRAID نسخه ۳ نامشخص و قابل تفسیر بودند، روشن می‌کند. مخاطب مورد نظر آن نویسندگان خلاق MRAID نسخه ۳ هستند.
پیش‌نیازها
ناشران باید در حال اجرا باشند:
- سرویس‌های گوگل پلی ۱۵.۰.۰ یا بالاتر برای MRAID نسخه ۳
- سرویس‌های گوگل پلی ۷.۸ یا بالاتر برای MRAID نسخه ۲
پرایمرهای مفید
اگر با MRAID آشنا نیستید، می‌توانید در صفحه MRAID مربوط به IAB اطلاعات بیشتری کسب کنید. همچنین می‌توانید سند تعاریف MRAID نسخه ۳ را دانلود کنید که جزئیات مربوط به تمام پارامترهای مورد بحث در زیر و همچنین پست وبلاگ IAB در مورد MRAID نسخه ۳ را ارائه می‌دهد.
جزئیات پیاده‌سازی MRAID نسخه ۳ (بتا)
قابلیت مشاهده - رویداد ExposureChange
این رویداد پشتیبانی می‌شود و ما توصیه می‌کنیم برای رویداد جدید exposureChange به جای رویداد منسوخ‌شده viewableChange از یک شنونده (listener) استفاده کنید. متد mraid.isViewable() نیز منسوخ شده است. با این حال، این متدهای منسوخ‌شده همچنان برای حفظ سازگاری با نسخه‌های قبلی پشتیبانی می‌شوند.
تعریف رویداد exposureChange هر زمان که نمای تبلیغ تغییر کند، ارسال می‌شود. SDK دارای یک مکانیزم نظرسنجی برای جلوگیری از تولید رویدادهای زیاد است. وضعیت اولیه پس از اینکه تبلیغ یک شنونده ثبت می‌کند، به صورت غیرهمزمان ارسال می‌شود. فراخوانی شامل پارامتر exposed_percentage است که یک عدد اعشاری بین 0.0 و 100.0 است.
برای استفاده از نمونه به مشخصات MRAID v3 مراجعه کنید.
تشخیص و مقداردهی اولیه MRAID و ویژگی‌های MRAID_ENV
این SDK با پروتکل مقداردهی اولیه مطابق با مشخصات MRAID v3 مطابقت دارد.
در شیء MRAID_ENV ، SDK IDFA ، limitAdTracking ، App ID یا COPPA (که اختیاری هستند) را ارسال نمی‌کند. این SDK تمام متغیرهای مورد نیاز در شیء MRAID_ENV ، از جمله نسخه MRAID، نام SDK و نسخه SDK را ارائه می‌دهد.
اندازه‌گیری شنوایی
یک رویداد جدید ( audioVolumeChange ) معرفی شده است تا مشخص کند که آیا صدا قابل شنیدن است و چه زمانی میزان صدا تغییر می‌کند.
رویداد audioVolumeChange یک پارامتر واحد دارد: volume_percentage . مقدار، درصد حداکثر صدای پخش صدا است. این یک عدد اعشاری بین 0.0 و 100.0 است ( 0.0 وقتی پخش مجاز نیست) یا اگر صدا قابل تعیین نباشد، null .
برای استفاده از نمونه به مشخصات MRAID v3 مراجعه کنید.
mraid.getLocation()
از آنجا که mraid.getLocation() پشتیبانی نمی‌شود، همیشه -1 را برمی‌گرداند.
بارگیری مجدد ()mraid
این متد را می‌توان در هر زمانی فراخوانی کرد و SDK با رد تبلیغ، آزادسازی منابع و سپس حذف نمای وب یا جایگزینی آن با یک سند دیگر یا یک تبلیغ جدید، واکنش نشان می‌دهد.
وقتی تابع unload() برای خلاقیت فراخوانی می‌شود، لایه بومی برای انواع خلاقیت‌های مختلف به صورت زیر پاسخ می‌دهد:
| نوع | رفتار ()unload |
|---|---|
| بنر | یک درخواست تبلیغ جدید با همان پارامترهای درخواست تبلیغ فعلی ایجاد کنید. |
| بینابینی | فضای بینابینی را ببندید. |
VPAID (تعریف رابط تبلیغاتی پخش کننده ویدیو)
کیت توسعه نرم‌افزاری تبلیغات موبایل گوگل (SDK) از VPAID پشتیبانی نمی‌کند. mraid.supports('vpaid') مقدار false برمی‌گرداند.
تابع ()mraid.useCustomClose
بسته به قالب و نوع داده‌ی خلاقانه، ممکن است تابع mraid.useCustomClose() پشتیبانی نشود.
جزئیات پیاده‌سازی MRAID نسخه ۲
دریافت نسخه ()mraid
mraid.getVersion() تا زمانی که فایل اجرایی بارگذاری نشده باشد، 2.0 برنمی‌گرداند. در حالی که mraid.getState() loading برمی‌گرداند، نسخه MRAID را بررسی نکنید.
تغییر اندازه ()mraid
وقتی تابع mraid.resize() فراخوانی می‌شود، بنر اصلی با تصویر اسکرین‌شات بنر جایگزین می‌شود. این موضوع زمانی قابل توجه است که تبلیغ تغییر اندازه داده شده، فضای تبلیغ اصلی را پوشش ندهد.
تبلیغات تغییر اندازه داده شده همچنین از قاب بنر اصلی پیروی نمی‌کنند. اگر بنری در نمای پیمایش قرار گیرد، تبلیغ تغییر اندازه داده شده با بنر پیمایش نمی‌شود.
mraid.setResizeProperties()
تمام فراخوانی‌های تابع mraid.setResizeProperties() باید شامل لیست کاملی از ویژگی‌های مورد نیاز باشند. اگر ویژگی‌های تغییر اندازه نامعتبر باشند، به مقادیر پیش‌فرض خود بازگردانده می‌شوند و تمام فراخوانی‌های بعدی تابع mraid.resize() تا زمانی که تابع mraid.setResizeProperties() دوباره با پارامترهای معتبر فراخوانی نشود، با شکست مواجه خواهند شد.
تابع ()mraid.getMaxSize
mraid.getMaxSize() فقط باید برای تعیین حداکثر اندازه برای تبلیغات تغییر اندازه داده شده استفاده شود. برای تعیین اندازه یک تبلیغ قابل گسترش، mraid.getScreenSize() استفاده کنید.
mraid.setOrientationProperties()
هنگام فراخوانی تابع mraid.setOrientationProperties() با تنظیم ویژگی allowOrientationChange روی true ، تنظیم ویژگی forceOrientation هیچ کاری انجام نمی‌دهد. طراحانی که می‌خواهند جهت‌گیری را اجباری کنند، باید allowOrientationChange روی false تنظیم کنند.
mraid.isViewable()
اگر یک نما، یک تبلیغ قابل مشاهده را پوشش دهد، mraid.isViewable() همچنان true برمی‌گرداند. محتوای برنامه نباید تبلیغات قابل مشاهده را پوشش دهد.
تابع ()mraid.getCurrentPosition
در حالی که یک تبلیغ دو تکه‌ایِ قابل بسط در حالت بسط‌یافته قرار دارد، فراخوانی تابع mraid.getCurrentPosition() روی تکه اول، اندازه صفحه نمایش را برمی‌گرداند.
تابع ()mraid.storePicture
برای اینکه یک برنامه از mraid.storePicture() پشتیبانی کند، باید مجوز android.permission.WRITE_EXTERNAL_STORAGE را در خود جای داده باشد.