Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Push Price Priority Line Items to your publisher adserver (for instance GAM for those using Google’s adserver) using the defined price granularity and setup specific for that adserver.

    1. This Python project does a good job for users semi-familiar with the Ad Manager API and Python

    2. Use the key-values 'sharethrough' per the bidder parameters documentation from Prebid.

  2. Configure the ad units for which you want the sharethrough bidder to return bid responses. Sharethrough supports banner , native and video impression requests .
    [**native remains unsupported in PrebidJS, but available through PBS (Go and Java]).. See the Prebid documentation for adunit configuration. It provides definitions for all the supported fields and examples for various types of ads.
    The important fields are:

    1. code: Associates the ad unit configuration with an ad slot on the page.

    2. mediaTypes: The type of ads to serve. E.g. banner, video, native, etc.

    3. bids: Bidder specific parameters.

      1. You must define the sharethrough bidder and associate this ad unit with a PubMaestro placement key using pkey

    4. ortb2Imp: Optional parameters supported by OpenRTB. For example, you could configure a floor price, block advertiser domains or block IAB categories.

    5. Example:

      Code Block
      languagejs
      <script>
        var adUnits = [
          {
            code: 'my-html-div-tag-id',
            mediaTypes: {
              banner: {
                sizes: [[300,250]]
              }
            },
            bids: [
              {
                bidder: "sharethrough",
                params: {
                  pkey: 'pkey1',
                }
              }
            ]
          },
        ]
      
        pbjs.que.push(function() {
          pbjs.addAdUnits(adUnits);
        });
      </script>
  3. Request bids and render the winning ads

    1. Call pbjs.requestBids to request bids for all ad units. This is typically called when the page loads or when an ad slot comes into view.

    2. The bidsBackHandler parameter is a callback function to call once the bid responses are received to render the winning ads.

      Code Block
      <script>
        pbjs.que.push(function() {
          pbjs.requestBids({
            bidsBackHandler: renderAllAdUnits, // Your rendering logic here
          });
        });
      </script>
    3. Examples:

      1. Without an ad server: https://docs.prebid.org/dev-docs/examples/no-adserver.html

      2. With an ad server: https://docs.prebid.org/dev-docs/examples/basic-example.html

  4. Update your ads.txt file to include Sharethrough.

  5. Sharethrough should immediately start competing in your header bidding auctions.

...