google.
قد يكون الإعلان جزءًا من مجموعة من الإعلانات. يعرض هذا الكائن البيانات الوصفية المرتبطة بهذه المجموعة، مثل عدد الإعلانات في المجموعة وموضع الإعلان في المجموعة.
غالبًا ما تكون واجهة برمجة التطبيقات getTotalAds المضمّنة في هذا الكائن صحيحة، ولكن في بعض الحالات، تمثّل أفضل تخمين لحزمة تطوير البرامج (SDK). يمكنك الاطّلاع على مستندات هذه الطريقة للحصول على مزيد من المعلومات.
الطُرق
موضع الإعلان
تعرض السمة getAdPosition() عددًا
لعرض موضع الإعلان.
- المرتجعات
-
numberموضع الإعلان في المجموعة. وتكون القيمة المعروضة واحدة، على سبيل المثال، 1 من 2، 2 من 2، والمزيد.
إعلانات الملصقات الصغيرة
تعرض الدالة isIs ملصقات() قيمًا منطقية.
لعرض true إذا كان الإعلان عبارة عن إعلان ملصق صغير. إعلانات الملصقات الصغيرة هي إعلانات خطية قصيرة يمكن أن تشير للمستخدم عند دخول المستخدم إلى فاصل إعلاني أو الخروج منه.
- المرتجعات
-
booleanما إذا كان الإعلان عبارة عن إعلان ملصق صغير.
المدة القصوى
getMaxDuration() تعرض رقمًا
الحد الأقصى لمدة المجموعة بالثواني. بالنسبة إلى المدة غير المعروفة، يتم عرض -1.
- المرتجعات
-
numberالحد الأقصى لمدة الإعلانات في هذه المجموعة بالثواني.
مؤشر getPod
تعرض طريقة getPodIndex() الرقم
عرض DAI VOD والعميل: يعرض فهرس لوحة الإعلانات. لعرض لوحة إعلانات ما قبل التشغيل، يتمّ عرض 0. بالنسبة إلى الإعلانات أثناء التشغيل، يتم إرجاع 1 و2 و...، ن. بالنسبة إلى لوحة إعلانات ما بعد التشغيل، يتم إرجاع -1. القيمة التلقائية هي 0 إذا لم يكن هذا الإعلان جزءًا من لوحة أو إذا لم تكن هذه المجموعة جزءًا من قائمة تشغيل. بث مباشر من DAI: يعرض هذا الخيار دائمًا القيمة -1.
- المرتجعات
-
numberفهرس المجموعة الصغيرة في قائمة تشغيل الإعلانات.
getTimeOffset
تعرض الدالة getTimeOffset() عددًا.
لعرض إزاحة وقت المحتوى التي تمت جدولة لوحة الإعلانات الحالية فيها. بالنسبة إلى اللوحات في الفيديوهات المسجّلة التي تعرض إعلانات تم إدراجها ديناميكيًا، يتم عرض وقت البث.
بالنسبة إلى لوحة إعلانات ما قبل التشغيل، يتم عرض 0. بالنسبة إلى الإعلانات أثناء التشغيل، يتم عرض الوقت المجدوَل. بالنسبة إلى إعلان ما بعد التشغيل، يتم عرض القيمة -1.
الإعداد التلقائي هو 0 إذا لم يكن هذا الإعلان جزءًا من لوحة أو إذا لم تكن اللوحة جزءًا من قائمة تشغيل للإعلانات.
- المرتجعات
-
numberالإزاحة الزمنية للوحة الإعلانات الحالية.
getTotalAds
getTotalAds() رقم الإرجاع
إجمالي عدد الإعلانات المضمّنة في هذه المجموعة، بما في ذلك الملصقات الصغيرة. إعلانات الملصقات الصغيرة هي إعلانات خطية قصيرة يمكن أن تشير للمستخدم عند دخول المستخدم إلى فاصل إعلاني أو الخروج منه.
القيمة التلقائية هي 1 إذا لم يكن هذا الإعلان جزءًا من مجموعة.
في سيناريوهات معيّنة، لا تعرف حزمة تطوير البرامج (SDK) عدد الإعلانات المضمّنة في لوحة الإعلانات هذه. وتتضمن هذه السيناريوهات لوحات الإعلانات، وهي إعلانات متعددة ضمن علامة إعلان واحدة. في هذه السيناريوهات، قد يحتوي أول {0/} من أحداث AdAds مفعلة (AD_METADATA وLOADED وغيرها) على إجمالي عدد علامات الإعلانات من استجابة قائمة التشغيل. ونحن نوصي باستخدام حدث FIRST_QUARTILE باعتباره الحدث الذي يسحب فيه الناشرون المعلومات من هذا الكائن، كما يحدّث العناصر المرئية للمشغل، إن وجدت.
- المرتجعات
-
numberإجمالي عدد الإعلانات في المجموعة.