Skip to main content

Overview

Configuring Prebid.js for Curation enables your cohort signals to flow to SSP curation marketplaces including Monetize, Index Exchange Marketplaces, and Pubmatic. This allows Permutive to package your audience signals into multi-publisher curated deals.
Prerequisites:
  • Prebid.js v9.5.0 or later installed on your website
  • Permutive Web SDK deployed and operational
  • Standard or Custom Cohorts enabled for Curation
  • Signed Curation Order Form

Steps

1

Verify Prebid RTD Module Installation

Ensure your Prebid.js build includes the Permutive RTD (Real-Time Data) module. This module reads cohort data from local storage and passes it to configured SSPs.The module must be included in your Prebid.js build. Refer to the Prebid integration documentation for detailed setup instructions.
2

Configure Bid Adapters for SSPs

Verify that the required SSP bid adapters are included in your Prebid.js build and properly configured:
  • Monetize: appnexus or msft bid adapter
  • Index Exchange: ix bid adapter
  • Pubmatic: pubmatic bid adapter
These adapters must be present in your Prebid.js build to send bid requests containing curation signals to the respective SSPs.
3

Configure RTD Module Settings

Add the Permutive RTD configuration to your Prebid.js setup:
pbjs.setConfig({
  realTimeData: {
    auctionDelay: 200,
    dataProviders: [{
      name: 'permutive',
      waitForIt: true
    }]
  }
});
Critical settings:
  • waitForIt: true ensures the auction waits for cohort data to be ready
  • auctionDelay: 200 sets a 200ms maximum wait time (adjust as needed)
4

Configure GDPR Consent (If Applicable)

If operating in GDPR regions, add Permutive as a vendor exception in your consent management configuration:
pbjs.setConfig({
  consentManagement: {
    gdpr: {
      cmpApi: 'iab',
      timeout: 8000,
      allowAuctionWithoutConsent: true,
      defaultGdprScope: true,
      rules: [{
        purpose: 'storage',
        enforcePurpose: true,
        enforceVendor: true,
        vendorExceptions: ["permutive"]
      }]
    }
  }
});
This ensures the RTD module can access cohort data stored locally by the Permutive SDK.
Troubleshooting Tips:
  • Prebid.js version 9.5.0 or later is required for correct ORTB2 targeting
  • If cohorts aren’t appearing in bid requests, verify local storage keys starting with _p contain data
  • Contact Permutive Technical Services if setup appears correct but signals are not flowing

Next Steps