Private Marketplaces & Deal IDs

BidSwitch enables private deals between Buyers and Supplier by standardising Deal IDs used by all parties. This means that Buyers do not need to update deal information for each individual Supplier/publisher.

When setting up private deals, there are two methods which can be used to implement the arrangement between trading partners.

Buyer Controlled: Uploading Deal IDs
The Supplier does not route deals directly to the Buyer, but sends the bid requests to BidSwitch with the appropriate Deal IDs. The Buyer uploads this list of Deal IDs to BidSwitch and they are redirected automatically to the Buyer. See the Uploading Deal IDs instructions to use this method.
Supplier Controlled: Using Auto-deals
The Supplier routes deals directly to the Buyer by setting the pmp.deals.wseat field in the bid request, see the Deal Object Example section for an example. In this case, it is not necessary for the Buyer to upload a list of Deal IDs, because the Buyer wil automatically see the Deal IDs associated with these bid requests in their bidstream. See the Setting up Auto-Deals instructions for setting this up.

Note

BidSwitch does not aid in the creation, discovery, or execution of deals. Buyers must work with each publisher or supplier directly to create and discover deals.

Uploading Deal IDs

If a Buyer and Supplier create a private arrangement, once the Deal IDs are created the Buyer can upload this list to BidSwitch. Using this list, BidSwitch will automatically route the deals to that Buyer. The list must be in a plain text file, with each deal ID on a separate row. Use the following contents of an example-deal-ids.txt file to create your list.

deal-id-1
deal-id-2
deal-id-3

To upload a list of deal IDs, use the following steps:

  1. From the BidSwitch UI Supply Partners list, select the trading partner with which you wish to transact a private deal
  2. In the General Settings section, click the upload txt file button
  3. Upload your .txt file with the Deal IDs
  4. Save your changes

New deals can be added by uploading an updated .txt file with new and existing deal IDs.

Note

Only Buyers can upload the deal IDs file.

Setting up Auto-Deals

Suppliers can initiate auto-deals by specifying the Buyer ID in the bid request by using the pmp.deals.wseat field. See the Deal Object section for more details. By doing this, the deal is automatically routed to the target Buyer, and the deal IDs will be automatically appended to the Buyers List of deals file.

Note

  • Suppliers must contact BidSwitch Support to enable Auto-Deals on their account
  • If deals do not automatically appear in the list, new deals must be added into the respective Supplier bidstream configuration. All deal IDs should be listed and uploaded in the .txt file template provided.
  • In any Buyer/Supplier connection, if the Supplier supports auto-deal routing then the Buyer cannot set the list of private deals specified in the BidSwitch UI.

Using an example screenshot taken from the BidSwitch

  • On the left you can see a trading partnership with private deals
  • On the right, one with no private deals
../_images/pmp-deals-ui.png

Common Problems & Fixes

No Deal Sent

The Supplier is not sending the deal to BidSwitch.

The Supplier needs to start sending the deal to BidSwitch.

Buyer Not Targeted

The BidSwitch Buyer isn’t targeted in the deal because the Supplier has not populated the pmp.deals.wseat parameter in the bid request to enable an auto-deal, see the Bid Request v5.3 section for more details.

Remind the Supplier to use the Buyer ID in the bid request to solve this in the future. As a quick workaround, enter the deal ID into the Deal IDs text file, see Uploading Deal IDs.

No Response

The Buyer isn’t responding to the deal, or the Buyer is responding to the bid request but isn’t putting the deal in the bid response.

Examples about how to do this properly are in the Bid Request JSON Examples section. The solution is to respond according to the BidSwitch protocol.

Not Clearing Bid Floor

The Buyer is responding correctly, but never clears the floor price because the BidSwitch fee reduces the bid by X%.

For example, if the Deal price is $10 and BidSwitch fee 8%. The Supplier deal bidfloor will be $10 but the Buyer will need to bid $10.87 to clear the bidfloor once the BidSwitch % is deducted.

Bid higher to clear the floor and take the % bid fee into account, see the BidSwitch Trading Modes section for more details.

Not Clearing Bid Floor (Different Currencies)

The Buyer is responding properly but never clears the floor price because they are bidding on a bid being sent to BidSwitch in a foreign currency, and the Buyer is using BidSwitch‘s foreign exchange rate to convert the bid to another currency.

This can result in failing to bid above the floor price. The solution is to bid higher to take this foreign exchange fee into consideration. The current rate is always shown to Buyers in the BidSwitch UI.

Troubleshooting

If your private deals are not working properly, please contact the following parties in this order.

  1. The relevant publisher, Buyer, or Supplier
  2. BidSwitch tech support
  3. Your Account Manager, or BidSwitch contact

When in doubt, contact support@bidswitch.com with the following details.

  • The Deal ID(s) in question
  • The Buyer and Supplier involved
  • Bid & floor price of the deal (if known)
  • Any additional details

Private Deal Workflow

Deal Workflow
Process:
  1. Deal Creation

    The Buyer and Supplier work together to create a deal. Deals can be implemented automatically, and/or negotiated either directly between advertiser and publisher, or through demand and supply intermediaries (DSPs/SSPs).

  2. Deal ID Input

    The Buyer enters the Deal IDs into BidSwitch, using the BidSwitch UI. To do this, see the Uploading Deal IDs section.

  3. Bid Request

    The Supplier sends a bid request with the id and pmp.deals.wseat fields set to target the deal at the correct Buyer. See the Deal Object section, and the Private Deal Example section for more details.

  4. Bid Request

    BidSwitch sends the bid requests with matching Deal IDs to the appropriate Buyer.

  5. Bid Response

    The Buyer responds to the bid request with their bid. For more information, see the Private Deal Bid Response section.

  6. Deal Transacted

    If the response is correct, the deal goes through and the impression is shown to the end user.

Hint

When using Media Mode, a bid reduction fee occurs before the bid reaches the Supplier (The BidSwitch fee). Buyers must include the bid reduction amount on top of their initial bid price in order to reach the deal floor. For more information, see the BidSwitch Trading Modes section.