Skip to main content

Timeout Settings

Control how long to wait for partner bids before proceeding with the auction.


What is timeout?

Timeout is the maximum time (in milliseconds) to wait for demand partners to respond with bids.


Why timeout matters

TimeoutImpact
Too shortMiss bids, lower revenue
Too longSlow page, poor UX
Just rightBalance of revenue and speed

Partner qualityRecommended timeout
Fast partners800-1000ms
Standard1000-1500ms
Slow partners1500-2000ms

Starting point: 1500ms for most setups.


Where timeouts are configured

Global wrapper timeout

The auction-wide timeout is a wrapper config setting, not a demand-side one:

  1. Go to Wrapper → Configs
  2. Set the bid timeout (ms)
  3. Save, then ship a release from Wrapper → Releases

Per-slot timeouts

Ad slots can carry their own auction_timeout on the Auction tab (Inventory → Ad Slots → → Auction). Use this when a specific placement needs a tighter or looser budget than the wrapper default.

Bidder-side overrides are typically configured in Demand → Prebid on the bidder's config (if the adapter supports it), not at the wrapper level.


Setting timeouts

Wrapper-level

  1. Wrapper → Configs
  2. Adjust the bid-timeout value
  3. Save → Wrapper → Releases → Create Release

Using the AI Assistant

  • "Set wrapper bid timeout to 1200ms"
  • "Raise the auction timeout on the article_header slot to 1800ms"

Monitoring timeout impact

Check timeout rates

Go to Dashboard → Monetization and break down by bidder:

MetricHealthyNeeds attention
Timeout rate< 5%> 15%
Avg response time< timeoutNear timeout
Bids receivedConsistentDropping

Per-partner analysis

To find which bidders timeout frequently, use Dashboard → Monetization with a breakdown by bidder — Demand → Prebid is a card layout without sortable metric columns, so it's a navigation surface rather than an analytics surface.

Once you've identified a slow bidder, open its seat from Demand → Prebid to tune credentials, tag IDs, or the slot assignments.


Optimizing timeouts

Step 1: Measure current state

  • What's your average partner response time?
  • Which partners timeout frequently?
  • What's your page load impact?

Step 2: Test adjustments

Use experiments to test timeout changes:

  1. Create experiment
  2. Control: Current timeout
  3. Variation: New timeout
  4. Measure: Revenue and page speed

Step 3: Apply winners

Deploy the timeout that best balances revenue and speed.


Timeout strategies

Aggressive (speed-focused)

Global: 1000ms
Fast partners: 800ms
Slow partners: 1200ms

Best for: Speed-critical sites, mobile-first

Balanced

Global: 1500ms
Fast partners: 1000ms
Slow partners: 1800ms

Best for: Most publishers

Conservative (revenue-focused)

Global: 2000ms
All partners: 2000ms

Best for: High-CPM inventory where every bid matters


Troubleshooting

High timeout rates

CauseSolution
Timeout too shortIncrease timeout
Partner is slowConsider disabling or longer timeout
Network issuesCheck partner status

Page speed degraded

CauseSolution
Timeout too longReduce timeout
Too many partnersReduce partner count
Slow partnersDisable or optimize

Revenue dropped after timeout change

If you lowered timeout and revenue dropped:

  • You're missing valuable bids
  • Increase timeout or use partner-specific overrides
  • A/B test to find optimal value

Common questions

What happens to late bids?

Bids received after timeout are ignored for that auction. The partner can still compete in future auctions.

Should all partners have the same timeout?

Not necessarily. Fast partners can have shorter timeouts; slow but valuable partners may warrant longer timeouts.

How do I know the optimal timeout?

Test with experiments:

  1. Try different values (1000, 1200, 1500, 1800ms)
  2. Measure revenue and page speed impact
  3. Choose the best balance for your site

Next steps