الفئة: AdsRequest

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

طلب الإعلانات

new AdsRequest()

عمليات التنفيذ
google.ima.AdsRequestInterface

أماكن إقامة

adTagUrl

سلسلة

تحدِّد عنوان URL لعلامة الإعلان المطلوبة من خادم الإعلانات. لمعرفة تفاصيل حول إنشاء عنوان URL لعلامة الإعلان، يُرجى الاطّلاع على إنشاء علامة فيديو رئيسية يدويًا.

هذه المعلّمة مطلوبة.

استجابة الإعلانات

(مستند فارغ أو سلسلة أو مستند غير فارغ)

تحدّد مستند نموذج عرض إعلانات الفيديو 2.0 المطلوب استخدامه كاستجابة للإعلانات بدلاً من تقديم طلب من خلال عنوان URL لعلامة الإعلان. ويمكن أن يكون ذلك مفيدًا لتصحيح الأخطاء وغيرها من الحالات التي تتوفّر فيها استجابة نموذج عرض إعلانات فيديو (VAST) حاليًا.

هذه المعلَمة اختيارية.

contentDuration

(فارغة أو رقم)

تحدّد هذه السمة مدة المحتوى بالثواني لعرض المحتوى. وتُستخدم في حالتَين: 1) استهداف إعلان AdX و2) تحديد الوقت المناسب لتحميل إعلان VMAP مسبقًا.

هذه المعلّمة اختيارية.

كلمات رئيسية متضمّنة في المحتوى

(مصفوفة سلسلة فارغة أو غير فارغة من القيم)

لتحديد الكلمات الرئيسية المستخدَمة لوصف المحتوى الذي سيتم عرضه. يُستخدم في طلبات AdX.

هذه المعلّمة اختيارية.

عنوان المحتوى

(فارغة أو سلسلة)

تحدِّد هذه السمة عنوان المحتوى الذي سيتم عرضه. يُستخدم في طلبات AdX.

هذه المعلّمة اختيارية.

فرض غير خطي كامل

منطقية

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

الطول الخطي

عدد

يحدّد ارتفاع المنطقة المستطيلة التي يتم عرض الإعلان الخطي خلالها. يتم استخدام هذه القيمة كأحد معايير اختيار الإعلانات. لا يلزم أن تتطابق هذه القيمة مع ارتفاع الإعلان الفعلي.

هذه المعلّمة مطلوبة.

AdAdSlotWidth

عدد

يحدّد عرض المنطقة المستطيلة التي يتم عرض الإعلان الخطي خلالها. يتم استخدام هذه القيمة كأحد معايير اختيار الإعلانات. لا يلزم أن تتطابق هذه القيمة مع عرض الإعلان.

هذه المعلّمة مطلوبة.

بث مباشر مسبقًا

عدد

تحدّد هذه السياسة الحد الأقصى لوقت الانتظار بالثواني بعد طلب AdsAds قبل طلب عنوان URL لعلامة الإعلان. ويمكن استخدام هذه السمة لترتيب الطلبات خلال فعالية البث المباشر بهدف الحدّ من الزيادة في عدد الطلبات.

ارتفاع غير خطي في AdSlot

عدد

يحدّد ارتفاع المنطقة المستطيلة التي يتم عرض إعلان غير خطي ضمنها. ويتم استخدام هذه القيمة كأحد معايير اختيار الإعلانات. لا يلزم أن تتطابق هذه القيمة مع ارتفاع الإعلان الفعلي.

هذه المعلّمة مطلوبة.

خط عرض غير خطي

عدد

يحدّد عرض المنطقة المستطيلة التي يتم فيها عرض إعلان غير خطي. ويتم استخدام هذه القيمة كأحد معايير اختيار الإعلانات. لا يلزم أن تتطابق هذه القيمة مع عرض الإعلان.

هذه المعلّمة مطلوبة.

قواعد OomAccessMode

عنصر غير فارغ مع خصائص السلسلة

عنصر إعدادات ربط مورِّدي إثبات الملكية بأوضاع الوصول إلى OMID. يجب أن تكون المفاتيح قيمًا في google.ima.OmidVerificationResource، ويجب أن تكون القيم في قيم google.ima.OmidAccessMode.

تتم مطابقة عناوين URL للنص البرمجي لإثبات الملكية داخليًا مع التعبيرات العادية التي قدّمها المورّدون لحلّها على مفتاح OmidVerificationSeller. بعد ذلك، تبحث إعلانات الوسائط التفاعلية عن وضع الوصول للمورّد باستخدام هذا الكائن.

بالنسبة إلى عناوين URL للنصوص البرمجية التي لا يتم حلها إلى مورّد معروف، أو إذا لم يتم تقديم OmidVerificationreseller الذي تم حله في هذا الكائن، ستستخدم IMA وضع الوصول المقدَّم لـ OmidVerificationreseller وفي حال عدم توفّر OmidVerificationSupplier، وإلا سيتم استخدام وضع الوصول "محدود".

عنوان URL للصفحة

(فارغة أو سلسلة)

يحدّد عنوان URL الكامل للصفحة التي سيتم تضمينها في طلب الإعلان على Google لأغراض الاستهداف. يجب أن يكون عنوان URL صالحًا. وفي حال تحديد القيمة، سيتم استخدام هذه القيمة لوحدة ماكرو [PAGEURL].

هذه المعلّمة اختيارية.

مهلة التحميل

عدد

تجاوز المهلة المحدّدة التلقائية لتحميل نموذج عرض إعلانات الفيديو بالمللي ثانية لبرنامج تضمين واحد. المهلة التلقائية هي 5000 ملّي ثانية.

هذه المعلّمة اختيارية.

الطُرق

ضبط AdAdAutoPlay

setAdWiAutoPlay(autoPlay) بإرجاع

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

المَعلمة

تشغيل تلقائي

منطقية

لتحديد ما إذا كان سيتم تشغيل المحتوى والإعلان تلقائيًا أو ما إذا كان سيتم بدء الإجراء من خلال إجراء للمستخدم.

المرتجعات

void 

ضبط AdAdPlayPlays

تُعرَض الدالة setAdIsPlayكتم الصوت(تم كتم الصوت) باطلة

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

المَعلمة

تم كتم الصوت

منطقية

ما إذا كان سيتم تشغيل الإعلان بدون صوت.

المرتجعات

void 

ضبط التشغيل المستمر

set{2/} continnuousPlayback(إرجاع التشغيل) مفعّل

لإعلام حزمة تطوير البرامج (SDK) بما إذا كان المشغّل ينوي تشغيل فيديوهات المحتوى باستمرار واحدًا تلو الآخر مثل بث التلفزيون. لن يؤثّر تغيير هذا الإعداد في تشغيل الإعلانات، ولكنه سيرسل الإشارة المناسبة في طلب الإعلان هذا للسماح للمشترين بتقديم عروض أسعار لنوع المساحة المتوفّرة للإعلانات.

المَعلمة

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

منطقية

ما إذا تم تشغيل فيديو المحتوى واحدًا تلو الآخر باستمرار؟

المرتجعات

void