الفئة: AdsManager

google.ima.AdsManager

الفئة static

توفر واجهة برمجة التطبيقات العامة الخارجية للناشر وتتصل بالمثيل الداخلي لمدير الإعلانات.

الطُرق

تصغير

تصغير(

تصغير الإعلان الحالي. لا يسمح هذا بحزمة HTML5 SDK.

تكوين AdsManager

تكوينAdsManager(content, adsRenderingSettings)

تُحدِّد المعلّمات المطلوبة للحصول على مرجع إلى AdManager من حدث AdsManagerLoaded.

المعلمة
محتوى	الكائن العنصر الذي يشغّل محتوى الناشر. يجب ألا تكون القيمة فارغة.
إعدادات العرض في الإعلانات	اختياري إعدادات عرض الإعلانات إعدادات اختيارية للتحكّم في عرض الإعلانات قد تكون القيمة فارغة.

إتلافه

_()

إزالة مواد عرض الإعلانات التي تم تحميلها في وقت التشغيل والتي يجب إزالتها بشكل سليم في وقت اكتمال الإعلان وإيقاف الإعلان وكل التتبُّع.

تجاهل AdBreak

تجاهل AdBreak()

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

توسيع

توسيع()

وسِّع الإعلان الحالي. لا يسمح هذا بحزمة HTML5 SDK.

البؤرة

للتركيز()

لوضع التركيز على زر التخطي، إن وجد. وفي حال عدم توفّرها، يتم التركيز على العناصر التفاعلية، بما في ذلك الرموز أو تصميمات الإعلانات التفاعلية.

getAdSkippableState

getAdSkippableState() تعرض القيمة المنطقية

لعرض true إذا كان من الممكن تخطي الإعلان حاليًا. عندما تتغيّر هذه القيمة، يؤدي AdsManager إلى تنشيط حدث AdEvent.SKIPPABLE_STATE_CHANGED.

المرتجعات

boolean صواب في حال كان الإعلان يمكن تخطيه حاليًا، خطأ في الحالات الأخرى.

getCuePoints

تعرض الدالة getCuePoints() مصفوفة من عدد

لعرض مصفوفة من الإزاحات بالثواني تشير إلى وقت تشغيل فاصل إعلاني مجدول. يتم تمثيل إعلان ما قبل التشغيل بالرقم 0، ويتم تمثيل ما بعد التشغيل بالرقم -1. تشير صفيف فارغ إلى أنّ الإعلان أو لوحة الإعلانات لا تتضمن أي جدول زمني ويمكن تشغيله في أي وقت.

المرتجعات

non-null Array of number قائمة بالفروق الزمنية بالثواني

getRemainingTime

تعرض الدالة getRemainingTime() الرقم

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

المرتجعات

number تعرض الوقت المتبقي للإعلان الحالي. وإذا لم يتم تحديد الوقت المتبقي للإعلان الحالي (على سبيل المثال، الإعلانات المخصّصة)، ستعرض القيمة -1.

مستوى الصوت

تعرض getVolume() رقمًا

الحصول على حجم الإعلان الحالي.

المرتجعات

number حجم الإعلان الحالي من 0 (مستبعد) إلى 1 (أعلى).

إدخال

init(width, height, viewMode, videoElement)

وعليك الاتصال به لتهيئة تجربة الإعلان في "مدير الإعلانات".

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

IsCustomClickTrackingمُستخدم

IsCustomClickTrackingUsed() تعرض القيمة المنطقية

لعرض true في حال استخدام عنصر مخصّص لتتبّع النقرات لتتبّع النقرات على الإعلان الحالي. لا يتم استخدام تتبُّع النقرات المخصّصة إلا عند توفير عنصر اختياري لتتبّع النقرات إلى AdDisplayContainer، واستخدام التشغيل المخصّص، والإعلان الحالي ليس إعلانًا على AdSense/AdX.

المرتجعات

boolean ما إذا كان سيتم استخدام تتبع النقرات المخصصة أم لا.

تم تشغيل التشغيل المخصص

تعرض قيمة CustomCustomUsed() قيمة منطقية

لعرض true في حال استخدام عنصر فيديو مخصّص لتشغيل الإعلان الحالي. تحدث عملية التشغيل المخصّصة عند توفير عنصر فيديو اختياري لـ AdDisplayContainer على المنصّات حيث يقدّم عنصر الفيديو المخصّص تجربة مشاهدة إعلانات أكثر سلاسة.

المرتجعات

boolean تحديد ما إذا كان سيتم استخدام التشغيل المخصّص

pause

الإيقاف المؤقت()

لإيقاف الإعلان الحالي الذي يتم تشغيله مؤقتًا. لن تكون هذه الوظيفة مفتوحة عند عرض تراكب ثابت أو إذا لم يتم تحميل الإعلان بعد أو إذا كان قد تم تشغيله.

تغيير الحجم

تغيير الحجم(العرض والارتفاع ووضع العرض)

لتغيير حجم الإعلان الحالي.

المعلمة
width	number عرض شريحة إعلانية جديد.
الطول	number ارتفاع شريحة إعلانية جديدة.
وضع العرض	وضع العرض وضع العرض الجديد. يجب ألا تكون القيمة فارغة.

مواصلة التنزيل

استئناف()

لاستئناف الإعلان الحالي الذي تم تحميله وإيقافه مؤقتًا. ولن تكون هذه الوظيفة متاحة عند عرض تراكب ثابت أو إذا لم يتم تحميل الإعلان بعد أو عند انتهاء تشغيله.

ضبط مستوى الصوت

setVolume(volume)

عيّن مستوى الصوت للإعلان الحالي.

المعلمة
الحجم	number مستوى الصوت المطلوب ضبطه، من 0 (تم كتم الصوت) إلى 1 (أعلى صوت).

التخطّي

التخطي()

لتخطي الإعلان الحالي عندما يكون AdsManager.getAdSkippableState() صحيحًا. ولا يتم استدعاء "تخطي" عند حدوث ذلك في ظل ظروف أخرى. بعد التخطّي، يؤدي AdsManager إلى تنشيط فعالية AdEvent.SKIPPED.

بدء

start()

ابدأ تشغيل الإعلانات.

على مطوّري البرامج الاتصال بـ AdDisplayContainer.initialize() أولاً.

توقُّف

stop()

إيقاف تشغيل الإعلانات. سيؤدي استدعاء هذا إلى إعادة الناشر إلى المحتوى.

تحديث AdsRenderingSettings

updateAdsRenderingSettings(adsRenderingSettings)

يعمل على تحديث إعدادات عرض الإعلانات. ويجب استخدامها تحديدًا في حالات استخدام VMAP بين الفواصل الإعلانية عندما تحتاج إعدادات عرض الإعلانات، مثل معدل البت، إلى تحديث.

المعلمة
إعدادات العرض في الإعلانات	إعدادات عرض الإعلانات إعدادات عرض الإعلانات المعدَّلة يجب ألا تكون القيمة فارغة.