الفئة: AdDisplayContainer

الشركة المصنِّعة

حاوية AdDisplay

new AdDisplayContainer(containerElement, videoElement, clickTrackingElement)

المعلمة

عنصر الحاوية

العنصر المراد عرض الإعلانات فيه. يجب إدراج العنصر في نموذج العناصر في المستند (DOM) قبل إنشاء AdDisplayContainer.

يجب ألا تكون القيمة فارغة.

عنصر الفيديو

اختياري

تحدّد العنصر البديل لتشغيل إعلان الفيديو. ننصحك دائمًا بتمرير مشغّل الفيديو للمحتوى.

يجب ألا تكون القيمة فارغة.

عنصر تتبّع النقرات

اختياري

تحدّد هذه العلامة العنصر البديل للنقر على إعلان الفيديو. اترك هذه القيمة خالية للسماح لأداة SDK بالتعامل مع النقرات. وحتى في حال توفّر هذه الحزمة، ستستخدِم حزمة تطوير البرامج (SDK) عنصر تتبُّع النقرات المخصّص فقط عند عرض تصميمات إعلانات غير AdSense/AdX في بيئات لا تتوافق مع عناصر واجهة المستخدم التي تظهر على سطح الفيديو (على سبيل المثال، iPhone أو الأجهزة التي تعمل بالإصدارات السابقة لنظام التشغيل Android 4.0). يجب عدم عرض عنصر تتبّع النقرات المخصّصة فوق مشغّل الفيديو مطلقًا لأنّه يمكن أن يعترض النقرات على عناصر واجهة المستخدم التي تعرضها حزمة تطوير البرامج (SDK). وتجدر الإشارة أيضًا إلى أنّ حزمة تطوير البرامج (SDK) لن تعدّل مستوى رؤية عنصر تتبّع النقرات المخصّص. وهذا يعني أنه في حال توفير عنصر مخصّص لتتبّع النقرات، يجب أن يتم عرضه بشكل صحيح عند تشغيل الإعلان الخطي. يمكنك الاطّلاع على ima.AdsManager.isCustomClickTrackingUsed عند تنشيط الحدث ima.AdEvent.Type.STARTED لتحديد ما إذا كان سيتم عرض عنصر تتبّع النقرات المخصّص أم لا. إذا كان ذلك مناسبًا لواجهة المستخدم، يجب إخفاء عنصر تتبّع النقرات عند تنشيط الحدث ima.AdEvent.Type.CONTENT_RESUME_REQUESTED.

يجب ألا تكون القيمة فارغة.

الطُرق

إتلافه

_()

مسح الحالة الداخلية وعناصر DOM التي تم إنشاؤها سابقًا. سيتم إلغاء تحميل أداة تطوير البرامج لإعلانات الوسائط التفاعلية، ولن يتم إجراء أي استدعاءات إضافية لأي واجهات برمجة تطبيقات.

تهيئة

تهيئة()

لإعداد عناصر الفيديو الداخلية للتشغيل. يجب استدعاء هذه الطريقة كنتيجة مباشرة لإجراء يتخذه المستخدم، بحيث يمكن للمتصفح وضع علامة على عنصر الفيديو كعنصر من بدء المستخدم.

ستتيح بعض المتصفّحات تشغيل الفيديو بدون تفاعل المستخدم إذا تم كتم صوت الفيديو. بالنسبة إلى هذا السلوك، استخدِم AdsRequest.setAdWillPlayMuted(true) واستدعِ هذه الطريقة قبل AdsManager.start().