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.

📦 Required module

Prebid Server Adapter
(module documentation: Prebid S2S Guide)

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).

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 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.