Back to Bidders

Outbrain

Features

Bidder Code outbrain Prebid.org Member yes
Media Types display, native GDPR TCF Support yes
User IDs none USP/CCPA Support yes
Supply Chain Support no COPPA Support yes
Demand Chain Support no Safeframes OK yes
Supports Deals check with bidder Prebid.js Adapter yes
IAB GVL ID 164 Prebid Server Adapter yes
Floors Module Support no

"Send All Bids" Ad Server Keys

These are the bidder-specific keys that would be targeted within GAM in a Send-All-Bids scenario. GAM truncates keys to 20 characters.
hb_pb_outbrain hb_bidder_outbrain hb_adid_outbrain
hb_size_outbrain hb_source_outbrain hb_format_outbrain
hb_cache_host_outbra hb_cache_id_outbrain hb_uuid_outbrain
hb_cache_path_outbra hb_deal_outbrain

Registration

The Outbrain Adapter requires setup before beginning. Please contact us at prebid.org@outbrain.com.

Configuration

Prebid.js

The Outbrain adapter does not work without setting the correct bidder and usersync URLs. You will receive the URLs when contacting us.

pbjs.setConfig({
    outbrain: {
      bidderUrl: 'http://bidder-url.com',
      usersyncUrl: 'http://usersync-url.com'
    }
});

Prebid server

Similar to the Prebid.js configuration described above, our prebid server adapter requires you to configure the bidder and usersync URLs. You will receive the URLs when contacting us.

Please note that you need to replace the <PREBID_SERVER_EXTERNAL_URL> part with the actual external URL of the prebid server host.

adapters:
  outbrain:
    endpoint: http://bidder-url.com
    syncurl: http://usersync-url.com?gdpr={{.GDPR}}&gdpr_consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&cb=<PREBID_SERVER_EXTERNAL_URL>%2Fsetuid%3Fbidder%3Doutbrain%26uid%3D__ZUID__

Bid Params

Name Scope Description Example Type
publisher.id required The publisher account ID '2706' string
publisher.name optional The publisher name 'Publisher Name' string
publisher.domain optional The publisher domain 'publisher.com' string
tagid optional Identifier for specific ad placement or ad tag 'tag-id' string
bcat optional Blocked advertiser categories using the IAB content categories ['IAB1-1'] string array
badv optional Block list of advertisers by their domains ['example.com'] string array

Native example

var adUnits = [
    code: '/19968336/prebid_native_example_1',
    mediaTypes: {
        native: {
            image: {
                required: false,
                sizes: [100, 50]
            },
            title: {
                required: false,
                len: 140
            },
            sponsoredBy: {
                required: false
            },
            clickUrl: {
                required: false
            },
            body: {
                required: false
            },
            icon: {
                required: false,
                sizes: [50, 50]
            }
        }
    },
    bids: [{
        bidder: 'outbrain',
        params: {
            publisher: {
              id: '2706',
              name: 'Publishers Name',
              domain: 'publisher.com'
            },
            tagid: 'tag-id',
            bcat: ['IAB1-1'],
            badv: ['example.com']
        }
    }]
];

var adUnits = [
    code: '/19968336/prebid_display_example_1',
    mediaTypes: {
      banner: {
        sizes: [[300, 250]]
      } 
    },
    bids: [{
        bidder: 'outbrain',
        params: {
            publisher: {
              id: '2706',
              name: 'Publishers Name',
              domain: 'publisher.com'
            },
            tagid: 'tag-id',
            bcat: ['IAB1-1'],
            badv: ['example.com']
        }
    }]
];

Back to Bidders