تتيح حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الآن إصدارًا تجريبيًا من MRAID الإصدار 3، والذي يستند إلى الإصدار 2 من MRAID، ما يتيح للمعلِنين عرض تصاميم الإعلانات المتوافقة مع الإصدار 3 من MRAID للناشرين على "مدير إعلانات Google". يوضّح هذا الدليل تفاصيل تنفيذ MRAID التي كانت غير واضحة وقابلة للتفسير في مواصفات MRAID الإصدار 3. ويستهدف هذا الدليل مؤلفي مواد العرض الإبداعية المتوافقة مع MRAID الإصدار 3.
المتطلبات الأساسية
على الناشرين استخدام ما يلي:
مقدمات مفيدة
إذا لم تكن على دراية بـ MRAID، يمكنك الاطّلاع على مزيد من المعلومات في صفحة IAB MRAID. يمكنك أيضًا تنزيل مستند تعريفات MRAID الإصدار 3 الذي يقدّم تفاصيل حول جميع المَعلمات الموضّحة أدناه، بالإضافة إلى مشاركة مدوّنة IAB حول MRAID الإصدار 3.
تفاصيل تنفيذ MRAID الإصدار 3 (إصدار تجريبي)
إمكانية العرض - حدث exposureChange
هذا الحدث متوافق، وننصحك باستخدام أداة معالجة للحدث الجديد
exposureChange بدلاً من الحدث viewableChange المتوقّف نهائيًا.
تم أيضًا إيقاف الطريقة mraid.isViewable() نهائيًا. ومع ذلك، سيظلّ بإمكانك استخدام هذه الطرق المتوقّفة نهائيًا لضمان التوافق مع الأنظمة القديمة.
يتم إرسال تعريف الحدث exposureChange كلما تغيّر عرض الإعلان. تحتوي حزمة تطوير البرامج (SDK) على آلية استقصاء لتجنُّب إنشاء عدد كبير جدًا من الأحداث.
يتم إرسال الحالة الأولية بشكل غير متزامن بعد أن يسجّل الإعلان أداة معالجة.
يتضمّن ردّ الاتصال المَعلمة exposed_percentage، وهي رقم نقطة عائمة يتراوح بين 0.0 و100.0.
راجِع مواصفات الإصدار 3 من MRAID للاطّلاع على عيّنات الاستخدام.
رصد MRAID وتهيئة سمات MRAID_ENV
تتوافق حزمة تطوير البرامج (SDK) مع بروتوكول الإعداد على النحو المحدّد في مواصفات MRAID الإصدار 3.
في العنصر MRAID_ENV، لا ترسِل حزمة تطوير البرامج (SDK) القيم IDFA أو limitAdTracking أو معرّف التطبيق أو قانون حماية خصوصية الأطفال على الإنترنت (COPPA) (وهي قيم اختيارية). وتوفّر جميع المتغيّرات المطلوبة في العنصر MRAID_ENV، بما في ذلك إصدار MRAID واسم حزمة SDK وإصدارها.
قياس مستوى السمع
تم تقديم حدث جديد (audioVolumeChange) لتحديد ما إذا كان يمكن سماع الصوت ومتى يتغير مستوى الصوت.
يحتوي الحدث audioVolumeChange على مَعلمة واحدة: volume_percentage.
القيمة هي النسبة المئوية للحد الأقصى لمستوى تشغيل الصوت. وهو رقم نقطة عائمة يتراوح بين 0.0 و100.0 (0.0 عندما لا يُسمح بالتشغيل) أو null إذا تعذّر تحديد مستوى الصوت.
راجِع مواصفات الإصدار 3 من MRAID للاطّلاع على عيّنات الاستخدام.
mraid.getLocation()
بما أنّ mraid.getLocation() غير متاح، يتم عرض -1 دائمًا.
mraid.unload()
يمكن استدعاء هذه الطريقة في أي وقت، وتتفاعل حزمة تطوير البرامج (SDK) من خلال إغلاق الإعلان وإلغاء تخصيص الموارد، ثم إما إزالة عرض الويب أو استبداله بمستند آخر أو إعلان جديد.
عندما يطلب تصميم الإعلان unload()، تستجيب الطبقة الأصلية على النحو التالي
لأنواع تصاميم الإعلانات المختلفة:
| النوع | سلوك الدالة unload() |
|---|---|
| بانر | إرسال طلب عرض إعلان جديد باستخدام مَعلمات الطلب نفسها المستخدَمة في الإعلان الحالي |
| الإعلانات البينية | أغلِق الإعلان البيني. |
معيار دقّة واجهة عرض الإعلانات على مشغّل الفيديو (VPAID)
لا تتوافق حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" مع معيار VPAID. تعرض mraid.supports('vpaid') القيمة "خطأ".
mraid.useCustomClose()
قد لا يكون mraid.useCustomClose() متاحًا، وذلك حسب التنسيق ونوع التصميم.
تفاصيل تنفيذ MRAID الإصدار 2
mraid.getVersion()
لا تعرض الدالة mraid.getVersion() القيمة 2.0 إلى أن يتم تحميل تصميم الإعلان. لا تضع علامة في المربّع بجانب إصدار MRAID عندما تعرض الدالة mraid.getState() القيمة loading.
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.