Skip to content

Client Side Prebid Integration ​

Using the Missena Header Bidding Adapter ​

The following guide is developed for integration with official Prebid (pbjs). If using another wrapper, please reach out to your account manager at Missena. If you have a specific Prebid global name, you should replace pbjs from the code with your Prebid global name.

IMPORTANT

Minimum required Prebid.js version: 9.51

Available Placements ​

Missena offers several placement placements to optimize your ad delivery:

1. Header Placement ​

A top-of-page placement that provides a seamless advertising experience. Uses a 1x1 banner configuration with specific header placement parameters.

Two types of footer placements are available:

  • Static Footer: A fixed footer placement using a 1x1 banner configuration
  • Dynamic Footer: A more flexible footer placement supporting multiple sizes (1x1 and 300x250) and various demand types including display, native, and video

3. Prestitial Placement ​

A full-screen advertisement that appears before the main content loads. Uses a 1x1 banner configuration with specific prestitial placement parameters.

4. Postitial Placement ​

A full-screen advertisement that appears after the main content loads. Uses a 1x1 banner configuration with specific postitial placement parameters.

5. In-Feed Placement ​

An in-content placement that appears between content elements. Uses a 1x1 banner configuration with specific infeed placement parameters.

6. In-Feed Small Placement ​

A compact variant of the in-feed placement. Uses a 1x1 banner configuration with specific infeed.s placement parameters.

7. Sample Mode ​

For testing purposes, you can enable sample mode to ensure ad delivery. This is useful during development and integration testing.

For detailed implementation instructions for each placement, please visit our Ad Placements documentation.

User Sync Configuration ​

Missena's Prebid adapter uses iframe-based user syncing to synchronize user IDs with demand partners. This is required for optimal match rates and bid performance.

Add the following userSync configuration to your Prebid setup:

javascript
pbjs.setConfig({
  userSync: {
    syncEnabled: true,
    filterSettings: {
      iframe: {
        bidders: ["missena"],
        filter: "include",
      },
      image: {
        bidders: "*",
        filter: "include",
      },
    },
  },
});

IMPORTANT

If iframe syncing is not enabled for the missena bidder, user sync will not fire, which will reduce match rates and bid performance.

Bid params ​

NameScopeDescriptionExampleType
apiKeyrequiredMissena's publisher token'PA-34745704'string
placementoptionalPlacement Type, default: 'sticky''sticky'string
settingsoptionalAn object containing extra settings for the Missena adapter{ settingName: 'value' }object
strictSizesoptionalForce size to exactly matchtrueboolean

Available Placement Values ​

The placement parameter accepts the following values:

  • sticky - Default sticky placement
  • header - Header placement
  • footer - Static footer placement
  • prestitial - Full-screen ad before content loads
  • postitial - Full-screen ad after content loads
  • infeed - In-feed placement within content
  • infeed.s - Small in-feed placement

General Requirements ​

For all integrations:

  • Valid Missena API key (obtain from your account manager)
  • Properly configured Prebid.js setup (version 9.51 or higher)
  • SafeFrame should be disabled for prebid creatives
  • Correct GPT placement codes
  • User sync must be enabled with iframe support for the missena bidder

Please refer to the specific placement documentation for detailed implementation instructions.