تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

الفئة: AdDisplayContainer

google.ima.AdDisplayContainer

الفئة static

تمثل هذه الفئة حاوية لعرض الإعلانات. ستعمل حزمة تطوير البرامج (SDK) تلقائيًا على إنشاء بُنى داخل معلّمة حاوية العنصر لنقل إعلانات الفيديو والإعلانات التي تظهر على سطح الفيديو.

عندما يتم إنشاء نسخة افتراضية من هذه الفئة، فإنه ينشئ إطار IFRAME في ContainerElement ويحمّل حِزمة SDK الأساسية. يجب الاحتفاظ بإطار IFRAME هذا حتى تعمل حزمة SDK على نحو سليم. بعد تشغيل كل الإعلانات وعدم الحاجة إلى استخدام حزمة تطوير البرامج (SDK)، استخدِم طريقة destroy() لإلغاء تحميل حزمة SDK.

يجب أن تكون معلّمةContainerElement عنصرًا يشكّل جزءًا من DOM. من الضروري تحديد موضع الحاويةElement بشكل صحيح لكي يتم عرض الإعلانات بشكل صحيح. من المستحسن وضعه أعلى مشغّل الفيديو وحجمه ليغطي مشغّل الفيديو بالكامل. ارجع إلى وثائق حزمة تطوير البرامج (SDK) للحصول على تفاصيل عن عمليات التنفيذ المقترَحة.

ملاحظة: من الضروري دائمًا استدعاء طريقة initialize() في الرمز الذي تم استدعاؤه مباشرةً من خلال إجراء من جانب المستخدم (مثل نقرة أو نقرة).

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

حاوية 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) قبل إنشاء 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().