الفئة: NonceRequest

NonceRequest

class   public

يُستخدَم NonceRequest لتخزين معلومات حول طلب الحصول على رقم عشوائي.

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

NonceRequest

new NonceRequest()

الأدوات

CtvNonceRequestInterface

الخصائص

adWillAutoPlay

(قيمة فارغة أو قيمة منطقية)

اضبط القيمة على "صحيح" إذا كان سيتم تشغيل الإعلان تلقائيًا بدون انتظار تفاعل المستخدم. اضبط القيمة على "false" إذا كان الإعلان سينتظر تفاعل المستخدم قبل تشغيله.

adWillPlayMuted

(قيمة فارغة أو قيمة منطقية)

اضبط القيمة على "صحيح" إذا كان سيتم تشغيل الإعلان أثناء كتم الصوت. اضبط القيمة على "false" إذا كان سيتم تشغيل الإعلان بدون كتم الصوت.

continuousPlayback

(قيمة فارغة أو قيمة منطقية)

اضبِط القيمة على true إذا كان المشغّل ينوي تشغيل فيديوهات المحتوى بشكل متواصل واحدًا تلو الآخر على غرار البث التلفزيوني أو قائمة تشغيل الفيديو. يجب ضبطها على "خطأ" في الحالات الأخرى.

descriptionUrl

يضبط هذا الحقل عنوان URL الخاص بوصف المحتوى الذي سيتم عرض الإعلان خلاله. سيتم تجاهل أي سلسلة عنوان URL للوصف تتجاوز 500 حرف واستبعادها من الرقم العشوائي.

المَعلمة
descriptionUrl	سلسلة

المرتجعات

void 

descriptionUrl

عنوان URL الخاص بوصف المحتوى الذي سيتم تشغيل الإعلان خلاله

المرتجعات

string 

iconsSupported

قيمة منطقية

تحدّد هذه السمة ما إذا كان مشغّل الفيديو يتيح استخدام رموز VAST.

nonceLengthLimit

الرقم

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

omidPartnerName

تضبط هذه السمة اسم الشريك الذي يدمج قياس OMID. تتجاهل PAL أي سلسلة نصية لاسم شريك تتجاوز 200 حرف وتستبعدها من الرقم العشوائي.

يجب أن يتطابق اسم الشريك مع الاسم المقدَّم إلى حزمة OM SDK لجلسة الإعلان. لمزيد من التفاصيل، يُرجى الاطّلاع على دليل إعداد OM SDK.

يجب ضبط كل من omidPartnerName وomidPartnerVersion لتضمين قيمة omid_p= بنجاح في رقم الاستخدام لمرة واحدة.

المَعلمة
omidPartnerName	سلسلة

المرتجعات

void 

omidPartnerName

اسم الشريك الذي يدمج قياس OMID

المرتجعات

string 

omidPartnerVersion

تمثّل هذه السمة إصدار الشريك الذي يدمج قياس OMID. سيتم تجاهل أي سلسلة إصدار خاصة بشريك تتضمّن أكثر من 200 حرف واستبعادها من الرقم العشوائي.

يجب أن يتطابق هذا المعرّف مع السلسلة المقدَّمة إلى حزمة OM SDK لجلسة الإعلان.

لتضمين قيمة omid_p= بنجاح في رقم الاستخدام لمرة واحدة، يجب ضبط كل من omidPartnerVersion وomidPartnerName.

المَعلمة
omidPartnerVersion	سلسلة

المرتجعات

void 

omidPartnerVersion

تمثّل هذه السمة إصدار الشريك الذي يدمج قياس OMID.

المرتجعات

string 

playerType

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

المَعلمة
playerType	سلسلة

المرتجعات

void 

playerType

تمثّل هذه السمة نوع المشغّل الذي يوفّره الشريك.

المرتجعات

string 

playerVersion

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

المَعلمة
playerVersion	سلسلة

المرتجعات

void 

playerVersion

إصدار المشغّل الذي قدّمه الشريك

المرتجعات

string 

ppid

تضبط هذه السمة المعرّف المقدَّم من الناشر. سيتم تجاهل أي معرّف مقدّم من الناشر (PPID) يتجاوز 200 حرف واستبعاده من الرقم العشوائي.

المَعلمة
ppid	سلسلة

المرتجعات

void 

ppid

المعرّف المقدَّم من الناشر

المرتجعات

string 

sessionId

سلسلة

معرّف الجلسة هو معرّف عشوائي مؤقت. ويُستخدَم هذا المعرّف حصريًا للحدّ من عدد مرّات الظهور على أجهزة التلفزيون المتّصلة (أجهزة التلفزيون الذكية ووحدات تحكّم الألعاب وأجهزة الاستقبال الرقمية). يجب أن يكون معرّف الجلسة معرّفًا فريدًا عالميًا (UUID).

supportedApiFrameworks

مصفوفة أرقام غير فارغة

مصفوفة من أُطر عمل واجهات برمجة التطبيقات المتوافقة يتم تحديد هذه القيم في قائمة "أُطر عمل واجهة برمجة التطبيقات" ضمن AdCOM 1.0. على سبيل المثال: يشير [2, 7, 9] إلى أنّ مشغّل الفيديو هذا يتوافق مع VPAID 2.0 وOMID 1.0 وSIMID 1.1.

url

سلسلة

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

videoHeight

الرقم

ارتفاع عنصر فيديو الإعلان

videoWidth

الرقم

عرض عنصر فيديو الإعلان