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