تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
NonceLoader
classpublic
تسمح مكتبة الوصول الآلي للناشرين بجمع الإشارات التي يمكن
استخدامها لفتح الطلب في AdX.
على الناشرين إنشاء NonceLoader عند تحميل الصفحة لتقليل
وقت الاستجابة. لكلّ مصدر (لعرض الإعلانات أثناء التشغيل) أو طلب إعلان فردي، اتصل
بوظائف الإعداد ذات الصلة حسب الحاجة، ثمّ اتصل بـ loadNonceManager. يمكن للناشرين
بعد ذلك استدعاء NonceManager.getNonce() للحصول على السلسلة التي يجب
إضافتها إلى طلبات الإعلانات كقيمة لمَعلمة عنوان URL "&paln". على الناشرين
بعد ذلك استدعاء NonceManager.sendAdClick() و
NonceManager.sendAdImpression() حسب الاقتضاء.
الشركة المصنِّعة
NonceLoader
new
NonceLoader(consentSettings, googleAdManagerSettings)
طريقة وضع التصميم
المَعلمة
consentSettings
اختياري
الإعدادات ذات الصلة باللوائح التنظيمية والموافقة
googleAdManagerSettings
اختياري
إعدادات PAL التي تعكس الإعدادات التي
ضبطتها في واجهة مستخدم "مدير إعلانات Google"
يجب ألا تكون القيمة فارغة.
الطريقة
loadNonceManager
public
تُعرِض دالة loadNonceManager(request) وعدًا يحتوي على NonceManager غير صفري.
الطلب الذي يحتوي على معلومات عن المفتاح المؤقت الذي يتم طلبه
يجب ألا تكون القيمة فارغة.
المرتجعات
non-null Promise containing non-null NonceManager الوعد الذي سيتم حلّه بعد توفّر NonceManager مع
مفتاح تشفير عشوائي يحتوي على جميع معلومات عروض الأسعار المُسبَقة
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eNonceLoader is a programmatic access library that helps publishers gather signals to access AdX demand.\u003c/p\u003e\n"],["\u003cp\u003ePublishers need to create a NonceLoader instance upon page load and utilize its methods to generate and manage nonces for ad requests.\u003c/p\u003e\n"],["\u003cp\u003eNonces, obtained via NonceManager, enhance ad requests by carrying pre-bid information through the "&paln" URL parameter.\u003c/p\u003e\n"],["\u003cp\u003ePublishers are expected to use NonceManager methods to signal ad clicks and impressions for tracking purposes.\u003c/p\u003e\n"]]],["Publishers use the `NonceLoader` class to collect signals for unlocking AdX demand. Upon page load, a `NonceLoader` is created. For each stream or ad request, setters are configured, followed by `loadNonceManager` with a `NonceRequest`. This returns a `NonceManager` which provides a nonce string via `getNonce()`. This string is added to ad requests as the \"\\&paln\" URL parameter. Finally, `sendAdClick()` and `sendAdImpression()` are called on the `NonceManager`. The `NonceLoader` is initialized with optional `consentSettings` and `googleAdManagerSettings`.\n"],null,["# Class: NonceLoader\n\nNonceLoader\n===========\n\nclass public\n\nThe programmatic access library allows publishers to collect signals that can\nbe used to unlock AdX demand.\nPublishers should create a NonceLoader on page load in order to reduce\nlatency. For each stream (for DAI) or individual ad request, call the\nrelevant setters as needed followed by a call to loadNonceManager. Publishers\ncan then call NonceManager.getNonce() in order to get the string that should\nbe added to ad requests as the value to the \"\\&paln\" URL parameter. Publishers\nshould then call NonceManager.sendAdClick() and\nNonceManager.sendAdImpression() as appropriate.\n\nConstructor\n-----------\n\n### NonceLoader\n\nnew\nNonceLoader(consentSettings, googleAdManagerSettings)\n\nConstructor.\n\n| #### Parameter ||\n|-------------------------|---------------------------------------------------------------------------------------------------------------------|\n| consentSettings | Optional Settings related to regulations and consent. |\n| googleAdManagerSettings | Optional PAL settings that reflect the settings you configured in the Google Ad Manager UI. Value must not be null. |\n\nMethod\n------\n\n### loadNonceManager\n\npublic\n\nloadNonceManager(request) returns Promise containing non-null [NonceManager](/ad-manager/pal/html5/reference/js/NonceManager)\n\n| #### Parameter ||\n|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| request | [NonceRequest](/ad-manager/pal/html5/reference/js/NonceRequest) The request containing information about the nonce being requested. Value must not be null. |\n\nReturns\n\n: `non-null Promise containing non-null `[NonceManager](/ad-manager/pal/html5/reference/js/NonceManager) The promise that will be resolved once the NonceManager with an\n encrypted nonce containing all pre-bid information is available."]]
