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

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

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

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

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

مقدّمات مفيدة

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

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

إمكانية العرض: حدث exposureChange

هذا الحدث مسموح به وننصحك باستخدام أداة معالجة للحدث الجديد exposureChange بدلاً من الحدثviewableChange الذي سيتم إيقافه نهائيًا. تم أيضًا إيقاف الطريقة mraid.isViewable() نهائيًا. ومع ذلك، ستبقى هذه الطرق المتوقّفة نهائيًا متوفرة للحفاظ على التوافق مع الإصدارات القديمة.

يتم إرسال تعريف الحدث exposureChange كلما حدثت تغييرات في عرض الإعلان. تتضمّن حزمة تطوير البرامج (SDK) آلية طلب المعلومات لتجنُّب إنشاء عدد كبير جدًا من الأحداث. يتم إرسال الحالة الأولية بشكل غير متزامن بعد أن يسجِّل الإعلان مستمعًا. تتضمّن دالة ردّ الاتصال المَعلمة exposed_percentage التي هي عدد بنقطة عائمة يتراوح بين 0.0 و100.0.

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

رصد 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 إذا تعذّر تحديد مستوى الصوت.

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

mraid.getLocation()

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

mraid.unload()

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

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

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

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

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

mraid.useCustomClose()

قد لا يكون mraid.useCustomClose() متوافقًا، وذلك استنادًا إلى التنسيق و نوع تصميم الإعلان.

تفاصيل تنفيذ MRAID v2

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.