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

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

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

يجب أن يشغِّل الناشرون:

• خدمات Google Play 15.0.0 أو إصدار أحدث للرقم 3 من MRAID
• خدمات Google Play 7.8 أو إصدار أحدث للإصدار 2 من MRAID

كريمات تمهيدية مفيدة

إذا لم تكن على دراية بـ MRAID، يمكنك الاطّلاع على مزيد من المعلومات في صفحة IAB MRAID. يمكنك أيضًا تنزيل مستند تعريفات الإصدار 3 من MRAID، الذي يقدم تفاصيل حول جميع المعلمات التي تمت مناقشتها أدناه، بالإضافة إلى مشاركة مدونة IAB حول الإصدار 3 من MRAID.

تفاصيل تنفيذ الإصدار 3 من MRAID (إصدار تجريبي)

إمكانية العرض - حدث تغيير التعرض

هذا الحدث متاح، وننصحك باستخدام أداة معالجة لحدث 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) وإصدار حزمة SDK.

قياس إمكانية الاستماع

تم إجراء حدث جديد (audioVolumeChange) لتحديد ما إذا كان من الممكن سماع الصوت ومتى يتغيّر مستوى الصوت.

يحتوي حدث audioVolumeChange على مَعلمة واحدة: volume_percentage. القيمة هي النسبة المئوية للحد الأقصى لمستوى تشغيل الصوت. وهو رقم نقطة عائمة بين 0.0 و100.0 (0.0 عندما لا يُسمح بتشغيل المحتوى) أو null إذا تعذّر تحديد مستوى الصوت.

يُرجى مراجعة مواصفات الإصدار 3 من MRAID للاطّلاع على عيّنة من الاستخدام.

mraid.getLocation()

وبما أنّ السمة mraid.getLocation() غير متاحة، يتم عرض القيمة -1 دائمًا.

mraid.unload()

يمكن استدعاء هذه الطريقة في أي وقت، وتتفاعل حزمة تطوير البرامج (SDK) من خلال إغلاق الإعلان، وتوزيع الموارد، ثم إزالة WebView أو استبداله بمستند آخر أو بإعلان جديد.

عندما يستدعي تصميم الإعلان unload()، تستجيب الطبقة الأصلية على النحو التالي لأنواع تصميمات الإعلانات المختلفة:

النوع	سلوك Unload()
بانر	أنشئ طلب إعلان جديدًا باستخدام معلمات الطلب نفسها المستخدمة في الإعلان الحالي.
الإعلانات البينية	إغلاق الإعلان البيني

VPAID (تعريف واجهة إعلان مشغِّل الفيديو)

لا تتوافق حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" مع VPAID. يكون ناتج mraid.supports('vpaid') خطأ false.

mraid.useCustomClose()

قد لا يكون العنصر mraid.useCustomClose() متاحًا، وذلك اعتمادًا على شكل الإعلان ونوعه.

تفاصيل تنفيذ الإصدار 2 من MRAID

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.storePicture()

لكي يتوافق التطبيق مع mraid.storePicture()، يجب أن يتضمن التطبيق إذن android.permission.WRITE_EXTERNAL_STORAGE.