קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
NonceRequest
classpublic
ה-NonceRequest משמש לאחסון מידע על הבקשה לערך חד-פעמי.
יצרן
NonceRequest
new
NonceRequest()
ציוד
NonceRequestInterface
מאפיינים
adWillAutoPlay
(null או ערך בוליאני)
הערך צריך להיות true אם המודעה תופעל אוטומטית בלי לחכות לאינטראקציה של המשתמש. הערך שמוגדר הוא false אם המודעה תמתין לאינטראקציה של המשתמש לפני ההפעלה.
adWillPlayMuted
(null או ערך בוליאני)
הערך צריך להיות true אם המודעה תופעל כשההשתקה פועלת. מגדירים את הערך false אם המודעה תופעל ללא השתקה.
continuousPlayback
(null או ערך בוליאני)
הערך צריך להיות true אם נדרשת הפעלה רציפה של סרטוני התוכן, אחד אחרי השני, בדומה לשידור בטלוויזיה או לפלייליסט של סרטונים. אחרת, הערך הוא False.
descriptionUrl
בעמודה הזאת מוגדרת כתובת ה-URL של תיאור התוכן שבמהלכו המודעה תופעל.
מחרוזות של כתובות URL לתיאור שאורכן יותר מ-500 תווים יקבלו התעלמות ולא ייכללו בערך ה-nonce.
פרמטר
descriptionUrl
מחרוזת
החזרות
void
descriptionUrl
כתובת ה-URL של תיאור התוכן שבמהלכו המודעה תוצג.
החזרות
string
iconsSupported
בוליאני
האם נגן הווידאו תומך בסמלי VAST.
nonceLengthLimit
number
מגבלת האורך של ה-nonce שנוצר. ההבטחה loadNonceManager תידחה אם ה-nonce ארוך יותר מהמגבלה הזו. ברירת המחדל היא
המספר השלם הגדול ביותר האפשרי. בחירה במגבלת אורך קצרה יותר עלולה לגרום להחרגה של מאפייני טירגוט שונים מה-nonce.
playerType
הגדרת סוג הנגן שסופק על ידי השותף. המאפיין הזה משמש לציון השם של נגן השותף. מחרוזות מסוג player שאורכן גדול מ-200 תווים יקבלו ערך ריק ויוחרגו מה-nonce.
פרמטר
playerType
מחרוזת
החזרות
void
playerType
סוג הנגן שסופק על ידי השותף.
החזרות
string
playerVersion
ההגדרה הזו קובעת את גרסת הנגן שסופקה על ידי השותף. התג הזה משמש לציון הגרסה של נגן השותף. מחרוזות של גרסת נגן שארוכות מ-200 תווים יתעלמו מהן ויוחרגו מהערך החד-פעמי.
פרמטר
playerVersion
מחרוזת
החזרות
void
playerVersion
גרסת הנגן שסופקה על ידי השותף.
החזרות
string
ppid
הגדרת המזהה שניתן על ידי בעל התוכן הדיגיטלי. המערכת תתעלם מכל PPID שאורכו יותר מ-200 תווים, והוא לא ייכלל בערך ה-nonce.
פרמטר
ppid
מחרוזת
החזרות
void
ppid
המזהה שסופק על ידי בעל התוכן הדיגיטלי.
החזרות
string
sessionId
מחרוזת
מזהה הסשן הוא מזהה רנדומלי זמני. הוא משמש אך ורק למכסת תדירות. מזהה סשן חייב להיות UUID.
כתובת אתר
מחרוזת
כתובת ה-URL שאליה יטירגטו המודעות. כברירת מחדל, זהה
לדף שבו יוצגו המודעות, אבל אפשר להגדיר אותו באופן ידני.
[null,null,["עדכון אחרון: 2025-08-21 (שעון UTC)."],[[["\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."]]
