Users with the Programmatic Publisher or Ad network role can view programmatic bid requests and responses with TAP > TAP Settings > Programmatic > Bid Request Tool. Use this tool when troubleshooting deals that aren’t generating revenue or campaigns that are not running as expected.
Also see:
The Bid Request Tool is a safe way to see bid requests and responses. It does not affect your bids, it only takes samples of bids for you to inspect.
You create samples with the Bid Request Tool. A sample captures bids that match criteria that you specify, such as Demand Partner, Station, and Deal ID. You can also specify how long the sample should be in effect and how many bids to collect. When the sample is complete, you can view and download the results.
Create a Sample
TAP starts collecting bids when you save the sample. A sample stops collecting bids when it reaches its TTL (time to live) or Number of results, which ever happens first.
You cannot pause, edit, or delete a sample. TAP automatically archives samples after 30 days.
For quick results, use the default TTL and Number of results. If a sample doesn’t capture bids, then create a new sample with a longer TTL.
Switch to the TAP organization to get bid request samples.
Go to TAP > TAP Settings > Programmatic > Bid Request Tool.
Select Create new sample.
To capture bid responses or requests, check or uncheck Bid response or Bid request. You must check at least one.
Choose a Demand Partner.
Optional: In Station, enter a station or podcast.
In Description, enter a useful summary for the sample.
Optional: Enter a Deal ID.
Optional: In TTL, enter how many hours you want to capture bids before the sample expires or completes. The default is 1 hour.
Optional: In Number of results, enter how many bid requests and responses you want to capture. The default is 1 result.
To start the sample, select Create new sample.
View or Download a Sample
The list of samples shows details about the sample, including its status.
Sample status | Description |
|---|---|
Pending | The sample is in progress. |
Expired | The sample did not collect any bids because there were no bids that matched the sample’s criteria. Try creating a new sample with a longer TTL. |
Completed | The sample has finished capturing bids that matched its criteria. You can view or download its results. |
You can see a completed sample’s results by selecting its options menu.
Download CSV: Generate and download a CSV file containing the captured bids.
View JSON: See the captured bids in JSON format.
For information on the fields in a sample’s results, see OpenRTB Implementation.