تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
NonceRequest
classpublic
يُستخدَم NonceRequest لتخزين معلومات حول طلب الحصول على رقم عشوائي.
الشركة المصنِّعة
NonceRequest
new
NonceRequest()
الأدوات
NonceRequestInterface
الخصائص
adWillAutoPlay
(قيمة فارغة أو قيمة منطقية)
اضبط القيمة على "صحيح" إذا كان سيتم تشغيل الإعلان تلقائيًا بدون انتظار تفاعل المستخدم. اضبط القيمة على false إذا كان الإعلان سينتظر تفاعل المستخدم قبل تشغيله.
adWillPlayMuted
(قيمة فارغة أو قيمة منطقية)
اضبط القيمة على "صحيح" إذا كان سيتم تشغيل الإعلان أثناء كتم الصوت. اضبط القيمة على "false" إذا كان سيتم تشغيل الإعلان بدون كتم الصوت.
continuousPlayback
(قيمة فارغة أو قيمة منطقية)
اضبط القيمة على true إذا كان المشغّل ينوي تشغيل فيديوهات المحتوى بشكل متواصل
واحدًا تلو الآخر على غرار البث التلفزيوني أو قائمة تشغيل الفيديو. يجب ضبطها على "خطأ" في الحالات الأخرى.
descriptionUrl
يضبط هذا الحقل عنوان URL الخاص بوصف المحتوى الذي سيتم تشغيل الإعلان خلاله.
سيتم تجاهل أي سلسلة عنوان URL للوصف تتجاوز 500 حرف واستبعادها من الرقم العشوائي.
المَعلمة
descriptionUrl
سلسلة
المرتجعات
void
descriptionUrl
عنوان URL الخاص بوصف المحتوى الذي سيتم تشغيل الإعلان أثناء عرضه
المرتجعات
string
iconsSupported
قيمة منطقية
تحدّد هذه السمة ما إذا كان مشغّل الفيديو يتيح استخدام رموز VAST.
nonceLengthLimit
الرقم
الحد الأقصى لطول الرقم العشوائي الذي تم إنشاؤه سيتم رفض وعد loadNonceManager إذا كان الرقم العشوائي أطول من هذا الحد. القيمة التلقائية هي أكبر عدد صحيح ممكن. قد يؤدي اختيار حدّ أقصى أقصر إلى استبعاد العديد من خصائص الاستهداف من الرقم العشوائي.
playerType
تضبط هذه السمة نوع اللاعب الذي يوفّره الشريك. يجب استخدام هذا الحقل لتحديد اسم اللاعب الشريك. سيتم تجاهل أي سلسلة لنوع اللاعب تتجاوز 200 حرف واستبعادها من الرقم العشوائي.
المَعلمة
playerType
سلسلة
المرتجعات
void
playerType
تمثّل هذه السمة نوع المشغّل الذي يوفّره الشريك.
المرتجعات
string
playerVersion
تضبط هذه السمة إصدار المشغّل الذي يوفّره الشريك. يجب استخدام هذا الحقل لتحديد إصدار مشغّل الشريك. سيتم تجاهل أي سلسلة إصدار مشغّل تتجاوز 200 حرف واستبعادها من الرقم العشوائي.
المَعلمة
playerVersion
سلسلة
المرتجعات
void
playerVersion
إصدار المشغّل الذي قدّمه الشريك
المرتجعات
string
ppid
تضبط هذه السمة المعرّف المقدَّم من الناشر. سيتم تجاهل أي معرّف مقدّم من الناشر (PPID) يتجاوز 200 حرف واستبعاده من الرقم العشوائي.
المَعلمة
ppid
سلسلة
المرتجعات
void
ppid
المعرّف المقدَّم من الناشر
المرتجعات
string
sessionId
سلسلة
معرّف الجلسة هو معرّف عشوائي مؤقت. ويُستخدَم حصريًا لتحديد عدد مرات الظهور. يجب أن يكون معرّف الجلسة معرّفًا فريدًا عالميًا (UUID).
url
سلسلة
عنوان URL الذي سيتم استهداف الإعلانات به. ويكون هذا المعرّف هو نفسه المعرّف الخاص بالصفحة التي ستعرض الإعلانات بشكل تلقائي، ولكن يمكن ضبطه يدويًا.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe \u003ccode\u003eNonceRequest\u003c/code\u003e class stores information about a request for a nonce, which is used for ad targeting and verification.\u003c/p\u003e\n"],["\u003cp\u003eIt includes various properties like ad behavior, content description, player details, and user session information.\u003c/p\u003e\n"],["\u003cp\u003eThese properties influence the generation of the nonce and its use in ad serving.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can configure properties such as ad autoplay, mute state, and continuous playback behavior to tailor the nonce request.\u003c/p\u003e\n"],["\u003cp\u003eThe nonce length can be limited, although this might affect the inclusion of certain targeting properties.\u003c/p\u003e\n"]]],["The `NonceRequest` class stores information for a nonce request. Key properties include: `adWillAutoPlay` and `adWillPlayMuted` (booleans for ad behavior), `continuousPlayback` (boolean for video play), `descriptionUrl`, `playerType`, `playerVersion`, `ppid`, `sessionId`, and `url` (strings for content and player details, with length limits), `iconsSupported` (boolean for VAST support), `nonceLengthLimit`(number for nonce limit), and `videoHeight` and `videoWidth` (numbers for ad dimensions). It manages nonce generation and validation, using provided IDs, URLs and player specs.\n"],null,["# Class: NonceRequest\n\nNonceRequest\n============\n\nclass public\n\nThe NonceRequest is used to store information about the request for a nonce.\n\nConstructor\n-----------\n\n### NonceRequest\n\nnew\nNonceRequest()\n\nImplements\n: NonceRequestInterface\n\nProperties\n----------\n\n### adWillAutoPlay\n\n(null or boolean)\n\nSet to true if the ad will be auto played without waiting for user\ninteraction. Set to false if the ad will wait for user interaction before\nbeing played.\n\n### adWillPlayMuted\n\n(null or boolean)\n\nSet to true if the ad will be played while muted. Set to false if the ad\nwill play unmuted.\n\n### continuousPlayback\n\n(null or boolean)\n\nSet to true if the player intends to continuously play the content videos\none after another similar to TV broadcast or video playlist. Set to false\notherwise.\n\n### descriptionUrl\n\n\u003cbr /\u003e\n\nSets the description URL of the content during which the ad will be played.\nAny description URL string longer than 500 characters will be ignored and\nexcluded from the nonce.\n\n| #### Parameter ||\n|----------------|--------|\n| descriptionUrl | string |\n\nReturns\n\n: `void`\n\n### descriptionUrl\n\n\u003cbr /\u003e\n\nThe description URL of the content during which the ad will be played.\n\nReturns\n\n: `string`\n\n### iconsSupported\n\nboolean\n\nWhether VAST icons are supported by the video player.\n\n### nonceLengthLimit\n\nnumber\n\nThe length limit of the generated nonce. The loadNonceManager promise\nwill be rejected if the nonce is longer than this limit. Defaults to the\nlargest possible integer. Choosing a shorter length limit may cause\nvarious targeting properties to be excluded from the nonce.\n\n### playerType\n\n\u003cbr /\u003e\n\nSets the partner provided player type. This should be used to specify the\nname of the partner player. Any player type string longer than 200\ncharacters will be ignored and excluded from the nonce.\n\n| #### Parameter ||\n|------------|--------|\n| playerType | string |\n\nReturns\n\n: `void`\n\n### playerType\n\n\u003cbr /\u003e\n\nThe partner provided player type.\n\nReturns\n\n: `string`\n\n### playerVersion\n\n\u003cbr /\u003e\n\nSets the partner provided player version. This should be used to specify\nthe version of the partner player. Any player version string longer than\n200 characters will be ignored and excluded from the nonce.\n\n| #### Parameter ||\n|---------------|--------|\n| playerVersion | string |\n\nReturns\n\n: `void`\n\n### playerVersion\n\n\u003cbr /\u003e\n\nThe partner provided player version.\n\nReturns\n\n: `string`\n\n### ppid\n\n\u003cbr /\u003e\n\nSets the publisher provided ID. Any PPID longer than 200 characters will be\nignored and excluded from the nonce.\n\n| #### Parameter ||\n|------|--------|\n| ppid | string |\n\nReturns\n\n: `void`\n\n### ppid\n\n\u003cbr /\u003e\n\nThe publisher provided ID.\n\nReturns\n\n: `string`\n\n### sessionId\n\nstring\n\nThe session ID is a temporary random ID. It is used exclusively for\nfrequency capping. A session ID must be a UUID.\n\n### url\n\nstring\n\nThe URL to which the ads will be targeted. By default, this is the same\nas the page that will display the ads, but it may be manually set.\n\n### videoHeight\n\nnumber\n\nThe height of the ad video element.\n\n### videoWidth\n\nnumber\n\nThe width of the ad video element."]]
