SemantIQ Module

Overview

SemantIQ is a Real-Time Data (RTD) module published in the official Prebid.js repository. It retrieves contextual keywords from the SemantIQ service and populates ORTB site-level data before bid requests are sent.

How It Works

When included in a Prebid.js build, the module runs as part of the RTD pipeline:

1. On page load, it dispatches a page impression event to the SemantIQ collector service.
2. Before each auction, it fetches contextual keywords for the current page URL from the SemantIQ API.
3. Keywords are cached in session storage to avoid redundant requests on the same page.
4. The keywords are converted to ORTB format and merged into ortb2Fragments.global.site.keywords, making them available to all bidders in the auction.

Integration

Include rtdModule and semantiqRtdProvider in the Prebid.js build:

gulp build --modules='rtdModule,semantiqRtdProvider,...'

Then configure the module via pbjs.setConfig:

pbjs.setConfig({
  realTimeData: {
    dataProviders: [
      {
        name: 'semantiq',
        waitForIt: true,
        params: {
          companyId: 12345,
          timeout: 1000,
        },
      },
    ],
  },
});

Parameters

Name	Required	Description	Type	Default
companyId	No	Company ID obtained from Audienzz. Can be a single number or an array.	number | number[]	Audienzz default
timeout	No	Maximum time to wait for a response in milliseconds.	number	1000

Links

• Prebid.org documentation
• Module source code