تبلیغات رسانه های غنی موبایل

Google Mobile Ads SDK اکنون دارای پشتیبانی بتا برای MRAID نسخه 3 است که بر اساس پشتیبانی موجود از MRAID v2 ساخته شده است و به تبلیغ‌کنندگان امکان می‌دهد تا خلاقیت‌های MRAID v3 را به ناشران Ad Manager ارائه دهند. این راهنما جزئیات پیاده‌سازی MRAID را که در مشخصات MRAID v3 نامشخص و قابل تفسیر بودند، روشن می‌کند. مخاطبان مورد نظر آن نویسندگان خلاق MRAID v3 هستند.

پیش نیازها

ناشران باید در حال اجرا باشند:

• Google Mobile Ads SDK برای iOS نسخه 7.30.0 یا بالاتر برای MRAID نسخه 3
• Google Mobile Ads SDK برای iOS نسخه 7.4.0 یا بالاتر برای MRAID نسخه 2

پرایمرهای مفید

اگر با MRAID آشنایی ندارید، می توانید در صفحه IAB MRAID اطلاعات بیشتری کسب کنید. همچنین می‌توانید سند تعاریف MRAID v3 را دانلود کنید، که جزئیاتی در مورد تمام پارامترهای مورد بحث در زیر و همچنین پست وبلاگ IAB در MRAID v3 ارائه می‌دهد.

جزئیات پیاده سازی MRAID نسخه 3 (بتا).

قابلیت مشاهده - رویداد exposureChange

این رویداد پشتیبانی می‌شود و توصیه می‌کنیم از شنونده برای رویداد exposureChange جدید به جای رویداد viewableChange منسوخ شده استفاده کنید. متد mraid.isViewable() نیز منسوخ شده است. با این حال، این روش‌های منسوخ همچنان برای حفظ سازگاری با گذشته پشتیبانی می‌شوند.

هر زمان که نمای تبلیغ تغییر کند، تعریف رویداد exposureChange ارسال می‌شود. SDK دارای مکانیزم نظرسنجی برای جلوگیری از ایجاد رویدادهای بیش از حد است. حالت اولیه به صورت ناهمزمان پس از ثبت یک شنونده توسط آگهی ارسال می شود. فراخوان شامل پارامتر exposed_percentage است که یک عدد ممیز شناور بین 0.0 و 100.0 است.

برای استفاده از نمونه به مشخصات MRAID v3 مراجعه کنید.

شناسایی و مقداردهی اولیه MRAID و ویژگی های MRAID_ENV

SDK مطابق با پروتکل اولیه سازی است که در مشخصات MRAID v3 تعریف شده است.

در شی MRAID_ENV ، SDK IDFA ، limitAdTracking ، شناسه برنامه یا COPPA (که اختیاری هستند) را ارسال نمی کند. تمام متغیرهای مورد نیاز در شی MRAID_ENV ، از جمله نسخه MRAID، نام SDK و نسخه SDK را فراهم می کند.

اندازه گیری شنوایی

یک رویداد جدید ( audioVolumeChange ) معرفی می‌شود تا تشخیص دهد آیا صدا می‌تواند شنیده شود و چه زمانی میزان صدا تغییر می‌کند.

رویداد audioVolumeChange یک پارامتر دارد: volume_percentage . مقدار درصد حداکثر حجم پخش صدا است. این یک عدد ممیز شناور بین 0.0 و 100.0 ( 0.0 وقتی پخش مجاز نیست) یا اگر حجم صدا قابل تعیین نباشد، null .

برای استفاده از نمونه به مشخصات MRAID v3 مراجعه کنید.

mraid.getLocation()

از آنجا که mraid.getLocation() پشتیبانی نمی شود، همیشه -1 برمی گرداند.

mraid.unload()

این روش را می‌توان در هر زمانی فراخوانی کرد و SDK با رد کردن آگهی، تخصیص منابع، و سپس حذف webview یا جایگزینی آن با سند دیگر یا یک تبلیغ جدید واکنش نشان می‌دهد.

هنگامی که خلاق unload() فرا می خواند، لایه بومی برای انواع مختلف خلاقیت به صورت زیر پاسخ می دهد:

تایپ کنید	رفتار unload()
بنر	یک درخواست آگهی جدید با همان پارامترهای درخواست تبلیغ فعلی ایجاد کنید.
بینابینی	بینابینی را ببندید.

VPAID (تعریف رابط تبلیغاتی پخش کننده ویدیو)

Google Mobile Ads SDK از VPAID پشتیبانی نمی کند. mraid.supports('vpaid') false را برمی گرداند.

mraid.useCustomClose()

بسته به فرمت و نوع خلاقیت ( mraid.useCustomClose() ممکن است پشتیبانی نشود.

جزئیات پیاده سازی MRAID v2

mraid.getVersion()

mraid.getVersion() 2.0 برنمی گرداند تا زمانی که خلاقیت بارگیری شود. در حالی که mraid.getState() در حال loading است، نسخه MRAID را بررسی نکنید.

mraid.resize()

هنگامی که 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()

اگر یک view تبلیغاتی را پوشش دهد که در غیر این صورت قابل مشاهده باشد، mraid.isViewable() همچنان true را برمی گرداند. محتوای برنامه نباید تبلیغات قابل مشاهده را پوشش دهد.

mraid.getCurrentPosition()

در حالی که یک تبلیغ قابل گسترش دو تکه در حالت بسط است، فراخوانی به mraid.getCurrentPosition() در اولین قطعه، اندازه صفحه را برمی گرداند.

mraid.supports()

با شروع در SDK نسخه 7.11.0، mraid.supports("storePicture") و mraid.supports("calendar") همیشه false برمی‌گردانند. طبق مشخصات MRAID v2، خلاقان باید بتوانند در مواردی که این روش‌ها در دسترس نیستند، رسیدگی کنند.

mraid.storePicture()

توجه: با شروع در SDK نسخه 7.11.0، mraid.storePicture() در دسترس نیست. برای جزئیات بیشتر به mraid.supports() مراجعه کنید.

هنگامی که یک خلاقیت MRAID با mraid.storePicture() تماس می گیرد، برنامه به طور خودکار اجازه ذخیره یک تصویر را درخواست می کند.