Your First Auction

Get an auction running in 5 minutes.

1. Get Your Endpoint

Every publisher gets a dedicated RTB endpoint:

https://rtb.praevis.com/

Or a partner-specific subdomain:

https://rtb-partner.praevis.com/
https://rtb-partner2.praevis.com/

2. Send a Bid Request

Send an OpenRTB 2.6 POST request:

curl -X POST https://rtb.praevis.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "id": "test-001",
    "imp": [{"id": "1", "banner": {"w": 300, "h": 250}, "bidfloor": 0.50}],
    "site": {"id": "YOUR_PUBLISHER_ID", "domain": "example.com"},
    "device": {"ip": "82.132.225.1", "ua": "Mozilla/5.0", "geo": {"country": "GBR"}}
  }'

3. Response

Win (200): OpenRTB JSON with seatbid[].bid[] containing adm, nurl, burl, and price.

No bid (204): No DSPs bid above the floor. Empty response.

Blocked (403): Defender blocked the request (fraud, invalid floor, etc.).

4. Impression Tracking

When the ad renders, fire the nurl URL from the bid response. This confirms the impression and triggers revenue counting.

The response also includes a 1x1 tracking pixel in the adm markup as a backup.

5. Check the Dashboard

Log into broker.praevis.com. The dashboard shows your auctions, wins, and revenue in real-time. Data updates every 3 minutes.

Alternative: Universal Ad Endpoint

For simpler integrations, use the GET endpoint:

GET /ad?publisher_id={id}&format=banner&w=300&h=250

Returns HTML (banner), VAST XML (video), or JSON (native) depending on format. No OpenRTB knowledge needed.