Buyer Relay API - Interactive Configuration

⚙️ Configuration

Buyer

Buyers using MediaAlpha's platform

Response Mapping

Bids Array Field

Bid Amount

Duration

Preset mapping for Excel Impact

Strategy

Behavior

Single Bid

If None Qualify

Call Duration Limits

Minimum Call Duration (seconds)

Reject calls shorter than this

Maximum Call Duration (seconds)

Reject calls longer than this

Bid Requirements

Use different minimums for short vs long calls

Minimum Bid Amount ($)

Reject bids below this amount

How it works: Different minimum bid for short vs long calls

Short Call Threshold (seconds)

Calls ≤ this value are "short"

Short Call Minimum Bid ($)

Minimum $ for short calls

Long Call Minimum Bid ($)

Minimum $ for long calls

🎯 Live Example

📖 Quick Reference (Click to Apply)

Selection Strategies

highest_payout

Pick highest $ amount (tie-breaker: shortest duration)

shortest_duration

Pick fastest call (tie-breaker: highest payout)

best_value

Pick best $/second ratio

Single Bid Behavior

always_accept DEFAULT

Single bid bypasses all filters

IF Excel returns 1 bid
THEN Return it (Ringba validates)

apply_filters

Enforce filters even on single bid

IF Excel returns 1 bid
AND Bid fails filters
THEN Return null

If No Bids Qualify (Multiple)

return_highest_payout DEFAULT

Return highest $ bid anyway (fallback)

IF Excel returns 2+ bids
AND ALL fail filters
THEN Return highest $ (better than nothing)

return_none

Return null (strict filtering)

IF Excel returns 2+ bids
AND ALL fail filters
THEN Return null