Back to Bidders

Sharethrough

Features

Bidder Code sharethrough Prebid.org Member yes
Prebid.js Adapter yes Prebid Server Adapter yes
Media Types display, video, native Multi Format Support check with bidder
TCF-EU Support yes IAB GVL ID 80
GPP Support some (check with bidder) DSA Support check with bidder
USP/CCPA Support yes COPPA Support yes
Supply Chain Support yes Demand Chain Support check with bidder
Safeframes OK yes Supports Deals check with bidder
Floors Module Support yes First Party Data Support yes
User IDs all ORTB Blocking Support partial
Privacy Sandbox check with bidder Prebid Server App Support check with bidder

Before You Begin

The Sharethrough bidder adapter requires additional setup and approval from the Sharethrough Integrations team. Please reach out to your account manager for more information to start using it.

Bid Params

Name Scope Description Example Type
pkey required The placement key 'DfFKxpkRGPMS7A9f71CquBgZ' string
bcat optional (deprecated) Array of blocked IAB Categories ['IAB1-2', 'IAB1-3'] string[]
badv optional (deprecated) Array of blocked Advertisers by their domains ['ford.com', 'pepsi.com'] string[]

Note: Providing bcat and badv via Bid Params is deprecated, the First Party Data method should be preferred (see below). When both methods are provided (i.e. when badv and bcat are specified both as bid params and through the first party ortb2 method), first party data values will be used and bid param values will be ignored.

Configuration

Sample banner setup:

<script>
  var adUnits = [
    {
      code: "div-123",
      ortb2Imp: {
        ext: {
            gpid: "/1111/homepage-leftnav#div-123",
        }
      },
      mediaTypes: {
        banner: {
          sizes: [[250,250],[300,300]]
        }
      },
      bids: [
        {
          bidder: "sharethrough",
          params: {
            pkey: "pkey1",
            // you can set badv and bcat here too, but it is not recommended
            // see the "ORTB Blocking" section for a preferred alternate setup for
            // badv and bcat
          }
        }
      ]
    }
  ]

  pbjs.que.push(function() {
    pbjs.addAdUnits(adUnits);
  });
</script>

First Party Data

Publishers should use the ortb2 method of setting First Party Data. The following fields are supported:

  • ortb2.site.*
  • ortb2.user.*

For example:

pbjs.setConfig({
  ortb2: {
    site: {
      name: "example",
      cat: ["IAB2"],
      keywords: "power tools, drills",
      content: {
        userrating: "4"
      }
    },
    user: {
      yob: 1985,
      gender: "m",
      keywords: "a,b",
      ext: {
        data: {
          registered: true,
          interests: ["cars"]
        }
      }
    }
  }
});

ORTB Blocking

Sharethrough supports blocking advertiser domains (badv) and/or IAB Categories (bcat) via First Party Data.

For example:

pbjs.setConfig({
  ortb2: {
    bcat: ["IAB1", "IAB2-1"],
    badv: ["domain1.com", "domain2.com"],
  }
});

Additional Notes

Request and Response Attributes

  • TTL is 360 for display and native, 3600 for video (in milliseconds).
  • Safeframes are supported.
  • Advertiser domains are available in bid responses at meta.advertiserDomains
  • Bids are returned in net - that is, the bids returned reflect the bid amount with revenue sharing already taken into account. No adjustment is necessary.
  • Sharethrough is GDPR and COPPA compliant.

Supported Media Types

  • Banner
  • Native
  • Video (instream and outstream)

Default Ad Server Key Value

  • sharethrough

Prebid Module Support

For publishers using PBJS version 5 and above, current module support includes:

  • Price Floors
  • Supply Chain Object
  • User ID

"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_sharethrough hb_bidder_sharethrou hb_adid_sharethrough
hb_size_sharethrough hb_source_sharethrou hb_format_sharethrou
hb_cache_host_sharet hb_cache_id_sharethr hb_uuid_sharethrough
hb_cache_path_sharet hb_deal_sharethrough

Back to Bidders