«کیت توسعه نرم‌افزار آگهی‌های Google Mobile» اکنون از نسخه بتای MRAID v3 پشتیبانی می‌کند که براساس پشتیبانی موجود از MRAID v2 ساخته شده است و به تبلیغ‌کنندگان امکان می‌دهد طرح‌های آگهی MRAID v3 را به ناشران Ad Manager ارائه دهند. این راهنما جزئیات پیاده‌سازی MRAID را که در مشخصات MRAID نسخه ۳ نامشخص و قابل‌تفسیر بودند شفاف‌سازی می‌کند. مخاطبان هدف آن نویسندگان طرح‌آگهی MRAID نسخه ۳ هستند.
پیش‌نیازها
ناشران باید موارد زیر را اجرا کنند:
- «خدمات Google Play» نسخه ۱۵.۰.۰ یا بالاتر برای MRAID نسخه ۳
- «خدمات Google Play» نسخه ۷.۸ یا بالاتر برای MRAID نسخه ۲
کتاب‌های مقدماتی مفید
اگر با MRAID آشنا نیستید، می‌توانید در صفحه IAB MRAID اطلاعات بیشتری کسب کنید. همچنین می‌توانید سند تعاریف MRAID v3 را بارگیری کنید که جزئیات مربوط به همه پارامترهای موردبحث در زیر را ارائه می‌دهد، و همچنین پست وبلاگ IAB درباره MRAID v3 را بارگیری کنید.
جزئیات پیاده‌سازی MRAID v3 (نسخه بتا)
قابل‌مشاهده بودن - رویداد exposureChange
این رویداد پشتیبانی می‌شود و توصیه می‌کنیم به‌جای رویداد منسوخ‌شده viewableChange، از شنونده برای رویداد جدید exposureChange استفاده کنید.
روش mraid.isViewable() نیز منسوخ شده است. بااین‌حال، این روش‌های منسوخ‌شده
همچنان برای حفظ سازگاری با نسخه قدیمی پشتیبانی می‌شوند.
تعریف رویداد exposureChange هر زمان که نمای آگهی تغییر کند ارسال می‌شود. کیت توسعه نرم‌افزار سازوکار نظرسنجی دارد تا از تولید رویدادهای بسیار زیاد جلوگیری کند.
وضعیت اولیه پس‌از ثبت شنونده توسط آگهی به‌صورت ناهمگام ارسال می‌شود.
فراخوانی برگشتی شامل پارامتر exposed_percentage است که عدد ممیز شناور بین 0.0 و 100.0 است.
برای نمونه استفاده، به مشخصات MRAID v3 مراجعه کنید.
تشخیص و مقداردهی اولیه MRAID و مشخصه‌های MRAID_ENV
کیت توسعه نرم‌افزار با پروتکل مقداردهی اولیه که در مشخصات MRAID نسخه ۳ تعریف شده است مطابقت دارد.
در شیء MRAID_ENV، کیت توسعه نرم‌افزار IDFA، limitAdTracking،
شناسه برنامه، یا COPPA (که اختیاری هستند) را ارسال نمی‌کند. این رویداد همه متغیرهای لازم را
در شیء MRAID_ENV ارائه می‌دهد، ازجمله نسخه MRAID، نام کیت توسعه نرم‌افزار، و نسخه کیت توسعه نرم‌افزار.
سنجش شنیداری
رویداد جدیدی (audioVolumeChange) معرفی شده است تا مشخص شود که آیا صدا شنیده می‌شود و چه زمانی میزان صدا تغییر می‌کند.
رویداد audioVolumeChange یک پارامتر دارد: volume_percentage.
این مقدار درصد حداکثر میزان صدای بازپخش صوتی است. این مقدار یک عدد ممیز شناور بین 0.0 و 100.0 است (0.0 زمانی که بازپخش مجاز نیست) یا null اگر میزان صدا قابل تعیین نباشد.
برای نمونه استفاده، به مشخصات MRAID v3 مراجعه کنید.
mraid.getLocation()
چون mraid.getLocation() پشتیبانی نمی‌شود، همیشه -1 را برمی‌گرداند.
mraid.unload()
این روش را می‌توان در هرزمانی فراخوانی کرد و کیت توسعه نرم‌افزار با رد کردن آگهی، لغو تخصیص منابع، و سپس برداشتن نمای وب یا جایگزین کردن آن با سند دیگر یا آگهی جدید واکنش نشان می‌دهد.
وقتی طرح آگهی unload() را فراخوانی می‌کند، لایه بومی به‌صورت زیر برای انواع مختلف طرح آگهی پاسخ می‌دهد:
| نوع | رفتار ()unload |
|---|---|
| برنما | درخواست آگهی جدیدی با همان پارامترهای درخواست آگهی فعلی ایجاد کنید. |
| بینابینی | بستن بینابینی. |
VPAID (تعریف میانای آگهی پخش‌کننده ویدیو)
کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google از VPAID پشتیبانی نمی‌کند. mraid.supports('vpaid')
نادرست برمی‌گرداند.
mraid.useCustomClose()
mraid.useCustomClose() ممکن است بسته به قالب و نوع طرح آگهی پشتیبانی نشود.
جزئیات پیاده‌سازی MRAID v2
mraid.getVersion()
mraid.getVersion() تا زمانی که طرح‌آگهی بار نشود، 2.0 را برنمی‌گرداند. وقتی mraid.getState() مقدار loading را برمی‌گرداند، نسخه MRAID را بررسی نکنید.
mraid.resize()
وقتی 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 را داشته باشد.