Node Technical Requirements

This section describes the prerequisites for correctly integrating and activating the Pubstack Node server-side solution within your Prebid.js wrapper

Prebid.js Requirements

To use Pubstack Node, you must implement a Prebid.js wrapper on your website and enable server-to-server (S2S) communication via the Prebid Server adapter.

✅ Minimum version required

 Prebid.js v9.0.0+
Older versions are not guaranteed to support the latest S2S features or be compatible with the Pubstack server.

CMP

Add Pubstack vendor ID (1408) to your CMP.

ONLY If you are using TCF Control module*

Add the following configuration to your TCF Control module (Until Prebid.js 9.0 this was known as the “GDPR Enforcement” module):

    pbjs.setConfig({
        gvlMapping: {
            pubstack_server: 1408
        }
    });

    📦 Required module

    Prebid Server Adapter
    Install the Prebid Server Adapter module "prebidServerBidAdapter" – Download here
    (module documentation: Prebid S2S Guide)
    Capture_decran_2025-04-17_a_15.35.30

    Pubstack Server Configuration

    To communicate with the Pubstack-managed Prebid Server instance, configure the S2S settings using pbjs.setConfig.

      "s2sConfig": {
    "accountId": "YOUR_SITE_ID",
    "enabled": true,
    "adapter": "prebidServer",
    "bidders": ["pubstack_server"],
    "endpoint": "https://prebid-server.pbstck.com/openrtb2/auction",
    "syncEndpoint": "https://prebid-server.pbstck.com/cookie_sync",
    }

    🔒 Note: accountId corresponds to your Pubstack Site ID, which is unique to each site and provided by Pubstack (available in your “Sites & Stacks” section).

    🔒 pubstack_server cannot be changed

    Ad units setup

    Each ad unit must include a configuration for the pubstack_server bidder, using the exact ad unit name as declared on the Pubstack platform.

    bids: [
    {
    bidder: 'pubstack_server',
    params: {
    adUnitName: 'adunit-1' // Must match the ad unit name in Node
    }
    }
    // Add your other bidders here
    ]

    All this information can be found and prefilled with the appropriate IDs by navigating to Sites & Stacks > YourWebsite > Connect to Pubstack.

    🔒 pubstack_server cannot be changed

    Stack setup

    Configure and deploy your stack to your website : https://app.pubstack.io/pbs/sites

    Capture d’écran 2025-06-02 à 11.55.25

    When configure, it should look like this :

    Capture d’écran 2025-06-02 à 11.58.46

    GAM setup - ONLY for clients using sendallbids=true*

    Only if you're using dedicated line items for each bidder (sendAllBids=true), please ensure you include a set of line items for hb_bidder=pubstack_server. If not, no changes are needed.

    Pubstack Analytics tag

    To monitor client-side data, you have to add the Analytics tag to the page header. The SITE-ID can be retrieved in the Pubstack interface here:

    <script async src="https://boot.pbstck.com/v1/tag/[SITE-ID]"></script>

    ⚠️ If a Prebid variable other than "pbjs" is used, please inform your Customer Success Manager or the Pubstack support team : helpdesk@pubstack.io 

    Pubstack Analytics tag is required for you to monitor Node's performance within our UI. This step is explained in a dedicated article : https://help.pubstack.io/how-to-implement-the-pubstack-tag.