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

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

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

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

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

مقدمات مفيدة

إذا لم تكن على دراية بـ 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 دائمًا. وفقًا لمواصفات الإصدار 2 من MRAID، يجب أن تكون تصاميم الإعلانات قادرة على التعامل مع الحالات التي لا تتوفّر فيها هذه الطرق.

mraid.storePicture()

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

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