Stay organized with collections
Save and categorize content based on your preferences.
NonceLoader
classpublic
The programmatic access library allows publishers to collect signals that can
be used to unlock AdX demand.
Publishers should create a NonceLoader on page load in order to reduce
latency. For each stream (for DAI) or individual ad request, call the
relevant setters as needed followed by a call to loadNonceManager. Publishers
can then call NonceManager.getNonce() in order to get the string that should
be added to ad requests as the value to the "&paln" URL parameter. Publishers
should then call NonceManager.sendAdClick() and
NonceManager.sendAdImpression() as appropriate.
Constructor
NonceLoader
new
NonceLoader(consentSettings, googleAdManagerSettings)
Constructor.
Parameter
consentSettings
Optional
Settings related to regulations and consent.
googleAdManagerSettings
Optional
PAL settings that reflect the settings you
configured in the Google Ad Manager UI.
The request containing information about the nonce being
requested.
Value must not be null.
Returns
non-null Promise containing non-null NonceManager The promise that will be resolved once the NonceManager with an
encrypted nonce containing all pre-bid information is available.
[null,null,["Last updated 2025-08-20 UTC."],[[["\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."]]
