Developer GuideDemand SourcesGetting Started

Getting Started — Demand Partners

Connect your bidding infrastructure to Praevis and start buying CTV, mobile, and web inventory across our supply network.

Praevis supports two demand integration modes:

ModeHow it worksBest for
Traditional RTBWe send bid requests to your endpoint; you respond with bidsdemand sources with existing bidder infrastructure
DelegateYour bidding strategy runs inside Praevis infrastructure (JSON rules, <1ms)demand sources without a bidder, or latency-sensitive buyers

Traditional RTB — getting started

Create a demand source account

  1. Log in to exchange.praevis.com
  2. Go to Demand → Add DSP
  3. Enter your demand source name and bidder endpoint URL (must respond in <150ms)
  4. Select Traditional RTB mode

Register your endpoint

Your endpoint must:

  • Accept POST requests with Content-Type: application/json
  • Parse OpenRTB 2.5 bid request JSON
  • Return a valid bid response within 150ms (hard timeout)
  • Return HTTP 204 with empty body for no-bid

Subscribe to inventory pools

Go to Demand → your demand source → Pools. Select which publisher pools you want to receive bid requests from. Demand sources only receive requests from pools they’ve subscribed to.

Test in sandbox

Enable the sandbox flag on your demand source and use the sandbox endpoint to receive test bid requests before going live. → Sandbox guide for demand sources

Go live

Disable sandbox mode. You’ll start receiving live bid requests within seconds of saving.


Delegate — getting started

Create a demand source account

  1. Go to Demand → Add DSP
  2. Select Delegate mode
  3. No endpoint URL required — bidding logic runs inside Praevis

Create your bidding strategy

Paste your strategy JSON in the Strategy tab. Start with the template:

{
  "version": "1.0",
  "dsp_id": "your-dsp-uuid",
  "campaigns": [
    {
      "id": "campaign-001",
      "name": "Default Campaign",
      "active": true,
      "priority": 1
    }
  ],
  "rules": [
    {
      "name": "Default Bid",
      "conditions": {},
      "bid": {
        "base_cpm": 2.50,
        "max_cpm": 5.00,
        "min_cpm": 0.50
      },
      "priority": 1
    }
  ],
  "default_bid": 1.00
}

Test in sandbox

Use Demand → your demand source → Test in Sandbox to fire a test auction against your strategy.

Go live

Save and enable the demand source. Strategy takes effect within 30 seconds.

→ Full Delegate strategy guide


Pre-go-live checklist

Traditional RTB:

  • Endpoint returns HTTP 200 with valid bid response JSON in <150ms
  • Endpoint returns HTTP 204 (empty) for no-bid
  • Bid CPM is above the floor price for at least one pool
  • Geographic targeting matches the supply network
  • Win rate > 0% in sandbox testing

Delegate:

  • Strategy JSON validates (no syntax errors — check in dashboard editor)
  • At least one rule matches test auction conditions in sandbox
  • Daily budget set (optional but recommended)
  • Strategy tested in sandbox and returns bids

Support

Questions? Reach us at [email protected] or visit exchange.praevis.com. Enterprise demand sources can request a guided onboarding session.