Share via

Integrate web/mobile web with PSP

  • Article

Prebid Server Premium (PSP) supports four options for SSP customers to integrate web and mobile web inventory:

Monetize Ad Server customers do not need to change their current integration into Microsoft Advertising and can instead follow the PSP Setup Steps.

Prebid.js send top bid

Context

In general, Send Top Bid should be used by default if you do not have bidder-specific line items already set up in your ad server, or if you do not need all bids for reporting purposes. By using the Send Top Bid option, the winning bid response will indicate Microsoft Advertising as the winner with a buyer member ID as normal even if a separate SSP Demand Partner won through Prebid Server Premium. Your ad server will see Microsoft Advertising as the winner if this top bid wins the ad server auction. You can determine which SSP won, either Microsoft Advertising or another demand partner via Prebid Server Premium, by utilizing Microsoft Advertising's Prebid Server Premium Seller Analytics Report and standard Monetize Reporting and cross-referencing the other SSP Demand Partners' reporting.

Implementation

To set up Prebid.js with Send Top Bid:

  1. Integrate with a Prebid.js instance that uses the Microsoft Advertising (AppNexus) Prebid.js adapter.

    This should not require any changes to the "appnexus" adapter setup on page if already integrated through Microsoft Advertising this way.

  2. Call the Microsoft Advertising SSP client-side using the /ut/v3/prebid endpoint.

  3. If Demand Partners are already being called client-side, remove partners other than 'appnexus' (Microsoft Advertising) from the Prebid.js client-side instance.

  4. Configure those, and any additional SSP Demand Partners, in Monetize via Publishers > Prebid Server Premium > Demand Partner Configurations.

    For more information, see Add, Edit, or Delete a PSP Configuration.

Prebid.js send all bids

Context

Send All Bids should be used if Demand Partner-specific line items in the ad server are absolutely required. PSP will set key value targeting for the top CPM bid, along with the standard top bid key values (bidder, price, deal) for each included Demand Partner per ad unit.

Implementation

To set up Prebid.js with Send All Bids:

  1. Integrate with a Prebid.js instance that uses the Microsoft Advertising (AppNexus) Prebid.js adapter.

    This should not require any changes to the "appnexus" adapter setup on page if already integrated through Microsoft Advertising this way.

    Note

    When using Prebid.js 9.0 or higher, include the anPspParamsConverter module in every Prebid.js build for pages that use Monetize for PSP demand. This module converts client-side calls to the format required for server-side endpoints.

  2. Call the Microsoft Advertising SSP client-side using the /openrtb2/prebid endpoint

  3. Follow the Prebid GitHub example here.

    Important

    Prebid.js version 6.10 or higher is required.

Make the below changes to the s2sConfig:

  1. Set the accountId to your Microsoft Advertising Seller Member ID.

  2. Set enabled to true.

  3. Set defaultVendor to 'appnexuspsp'.

  4. Set allowUnknownBidderCodes to true.

  5. Include both includebidderkeys and includewinners in the extPrebid targeting object as shown in the following example:

    extPrebid = ([
   {
      "targeting":{
         "includebidderkeys":true,
         "includewinners":true
      }
   }
])

  6. Include 'appnexus' in bidders.

  7. Set the timeout value to the number of ms the browser should wait for a response from Microsoft Advertising.

    Note

    This value should be greater than your Microsoft Advertising (PSP) auction timeout. If the value is lower, there is a risk that the client-side timeout will hit before Microsoft Advertising responds with a bid, potentially preventing receipt of demand from Microsoft Advertising. For more information, see the Demand Partner Timeout section in Add or Edit PSP Global Settings.

See below for a s2sConfig example:

pbjs.setConfig({
   "s2sConfig":{
      "accountId":9325,
      "bidders":[
         "appnexus"
      ],
      "defaultVendor":"appnexuspsp",
      "enabled":true,
      "allowUnknownBidderCodes":true,
      "timeout":1000,
      "extPrebid":{
         "targeting":{
            "pricegranularity":"dense",
            "includebidderkeys":true,
            "includewinners":true
         }
      }
   }
})

When using Send All Bids, report on the key values in an external ad server, such as Google Ad Manager (GAM), by defining key values appropriately and setting them as reportable. GAM documentation can be found here.