The Search Bids functionality on the Reporting > Real Time Bidding screen lets you find details about a bid by entering the bid ID. You can see information like the bid calculation, tags, eligible/ineligible targets, and more. 

This feature is available to admin users. This feature is included with Real Time Bidding, which is available only in the Enterprise subscription plan.

This article contains the following sections:

• Getting a Bid ID
• How to Search by Bid ID
• Bid ID Search Results
  • Bid Details
  • Bid Trace
  • Events
  • Tags
  • Ring Tree Events
• Search Bids by ID FAQ

Getting a Bid ID

Many times when you are researching a bid, you receive the bid ID from a publisher who is asking you to investigate. In that case, you can just take the bid ID the publisher provided and go to the next section.

Other times you might want to investigate bids in your account for your own reasons. For example, you want to understand why a bid was a specific amount or you might be researching an error that occurred. 

For bids that turn into calls, you can find the bid ID on the Reporting screen. Expand the call in the Call Details section of the Reporting screen and view the Tags tab to find the bid ID. 

If the bid did not turn into a call, you can still find the bid ID. Navigate to Reporting > Real Time Bidding and use the Export Bids feature. The CSV file you export contains a row for each bid and information in the following columns:

• Campaign: The campaign's name.
• Publisher: The publisher's name.
• Campaign ID: The campaign's unique identifier.
• Publisher ID: The publisher's unique identifier.
• Publisher Sub ID: The publisher's sub ID.
• Bid: The bid amount.
• Winning Bid: Contains True if this was the winning bid.
• Winning Bid - Call Accepted: Contains True if this was the winning bid and the call was accepted.
• Winning Bid - Call Rejected: Contains True if this was the winning bid and the call was rejected.
• Bid Date: The date and time of the bid.
• Expiration in Seconds: The number of seconds before the bid expired.
• Bid Expire Date: The date and time at which the bid expired.
• Bid DID: The DID associated with the bid, if applicable.
• Bid Rejected: Contains True if the bid was rejected.
• Reason for Rejection: A description of why the bid was rejected, including the error code.
• Bid Elapsed Ms: The number of milliseconds it took to process the bid and generate a response to send back to the publisher. 

How to Search by Bid ID

Use the following steps to search by bid ID to return details about the bid:

1. Navigate to Reporting > Real Time Bidding. Use the fields under the Search Bids heading.
   
2. Enter a bid ID in the Enter Bid ID field and click the magnifying glass button to start the search. 
   
   The result appears showing the bid trace, regardless of whether the bid was accepted or rejected. 

Bid ID Search Results

The following columns appear in the search results:

• Bid Status: Indicates whether the bid was Accepted or Rejected
• Date/Time: The date and time of the bid. The time appears in the time zone you selected in the field next to the search field.
• Winning Bid: Contains Yes if this was the winning bid that turned into a call. Contains No if  the publisher did not send the call.
• Campaign: The name of the campaign associated with this call. Click the name to open the campaign.
• Publisher: The name of the publisher associated with this call.
• Bid: The value of the bid.

Click the arrow to the left of the Bid Status value to open more details about the bid. 

The following sections cover the tabs that appear.

Bid Details

The Bid Details tab shows the primary RTB information.

This tab contains the following fields:

• Bid ID: The bid ID. This value matches the ID you used to search for this record.
• Timestamp: The date and time of the bid. The time appears in the time zone you selected in the field next to the search field.
• Campaign Name: The name of the campaign associated with this call. 
• Publisher Name: The name of the publisher associated with this call.
• Campaign ID: The unique identifier of the campaign associated with this call. 
• Publisher ID: The unique identifier of the publisher associated with this call.
• Publisher Sub ID: The Sub ID of the publisher associated with this call.
• Bid Amount: The value of the bid.
• Bid Expire In Seconds: The number of seconds before the bid expired.
• Bid Expire Dt: The date and time the bid expired. This value appears in the time zone you selected in the field next to the search field.
• Bid DID: The DID associated with the bid, if applicable.
• Bid Elapsed Ms: The number of milliseconds it took to process the bid and generate a response to send back to the publisher. 

Bid Trace

The Bid Trace tab shows the bid calculation process. If the bid has Adjustments, you can expand it to show which bid modifiers matched.

If you override the RTB campaign settings per publisher, the information of which fields were overridden for that specific bid appear in the Bid Trace tab > Publisher Overrides.

Events

The Events tab show routing plan information, target eligibility, and criteria status. Jornaya, Trusted Form, and Custom Scoring API details appear here as well.

Tags

The Tags tab shows all tags for the bid. If a publisher does not disclose the caller ID, the caller ID and related tags do not appear.

Ring Tree Events

The Ring Tree Events tab appears only if pass through is enabled and ring tree targets are in the routing plan. On this tab, you can see the ping requests and responses.

Search Bids by ID FAQ

What does this RTB error code mean?

See a complete list of error codes and their meaning in this article: RTB error codes.

What is pass through?

RTB pass through is a powerful feature that lets you ping ring trees and static targets in your routing plan during the RTB ping to get information like target acceptance and revenue. You can learn more about enabling pass through in the RTB Pass Through article.