إعلانات الوسائط التفاعلية المتقدّمة للأجهزة الجوّالة

تتيح حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الآن إصدارًا تجريبيًا من MRAID v3، وهو يستند إلى الإصدار 2 من MRAID، ما يتيح للمعلِنين عرض تصاميم إعلانات MRAID v3 للناشرين على "مدير إعلانات Google". يوضّح هذا الدليل تفاصيل تنفيذ MRAID التي كانت غير واضحة وقابلة للتفسير في مواصفات MRAID الإصدار 3. والجمهور المستهدف هو مؤلفو مواد العرض الإبداعية المتوافقة مع MRAID الإصدار 3.

المتطلبات الأساسية

يجب أن يعرض الناشرون:

• الإصدار 7.30.0 أو إصدار أحدث من "SDK لإعلانات Google على الأجهزة الجوّالة" لنظام التشغيل iOS من أجل MRAID الإصدار 3
• الإصدار 7.4.0 أو إصدار أحدث من "SDK لإعلانات Google على الأجهزة الجوّالة" لنظام التشغيل iOS من أجل MRAID الإصدار 2

مقدمات مفيدة

إذا لم تكن على دراية بـ 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.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.supports()

اعتبارًا من الإصدار 7.11.0 من حزمة SDK، تعرض الدالتان mraid.supports("storePicture") وmraid.supports("calendar") القيمة false دائمًا. وفقًا لمواصفات MRAID الإصدار 2، يجب أن تتمكّن تصاميم الإعلانات من التعامل مع الحالات التي تكون فيها هذه الطرق غير متاحة.

mraid.storePicture()

ملاحظة: بدءًا من الإصدار 7.11.0 من حزمة تطوير البرامج (SDK)، لن تتوفّر السمة mraid.storePicture(). يمكنك الاطّلاع على mraid.supports() لمزيد من التفاصيل.

يطلب التطبيق تلقائيًا الإذن بحفظ صورة عندما تطلب مادة عرض إبداعية بتنسيق MRAID mraid.storePicture().