Revenue Share & Reporting

As a platform partner, you earn a share of the revenue your supply sources (Publishers) generate. This page explains how revenue is calculated, what you receive, and how to access reporting.

Revenue model

Publisher revenue = clearing_price × (1 − praevis_exchange_margin)
Partner payout    = publisher_revenue × partner_revenue_share_rate

Your revenue share rate is set at contract stage. Contact [email protected] for your specific terms.

Example:

• Auction clears at $5.00 CPM
• Praevis exchange margin: 40% → publisher receives $3.00 CPM
• Partner revenue share: 70% of publisher revenue → partner payout: $2.10 CPM
• Publisher payout: $0.90 CPM (remaining after partner share)

Real-time dashboard

Log in to your partner dashboard → the metrics ribbon shows your aggregate revenue across all supply sources.

Filtering options:

• By supply source (click supply source row in breakdown table)
• By time period (1h, 6h, today, 24h, 7d, 30d)
• By region (FRA / NYC / LON toggle)

Revenue figures update every ~60 seconds (stream aggregator lag).

API reporting

Aggregate partner stats

GET /api/partner/stats?period=30d
X-API-Key: {YOUR_KEY}
X-User-Partner-ID: {PARTNER_UUID}

Response:

{
  "partner_id": "partner-uuid",
  "period": "30d",
  "impressions": 4820000,
  "revenue_cents": 714000,
  "publisher_count": 14,
  "dsp_count": 6,
  "fill_rate": 0.841,
  "top_publishers": [...],
  "top_dsps": [...]
}

Per-supply-source breakdown

GET /api/partner/publishers?period=30d
X-User-Partner-ID: {PARTNER_UUID}

Returns each supply source with their individual revenue, fill rate, and eCPM.

Invoicing

Invoice contents

Each invoice line item shows:

• Supply source name
• Impressions delivered
• Gross clearing price
• Exchange margin deducted
• Your revenue share
• Net payout to you

VAT

VAT is calculated using current rates per country (GET /api/vat-rates). Praevis is registered in Singapore (GST 9%). Invoices to EU entities include reverse-charge VAT where applicable. Contact [email protected] for VAT registration details.

Pulling invoices via API

GET /api/partner/invoices
X-User-Partner-ID: {PARTNER_UUID}

Returns a list of all invoices with PDF download links.

Reconciliation

Every auction is logged in PostgreSQL with 90-day retention. For reconciliation queries:

1. Email [email protected] with your partner ID and the period
2. We provide a CSV export with: auction ID, timestamp, supply source, clearing price, your share
3. Standard turnaround: 3 business days

Revenue accrual timing

Revenue accrues in real-time and is invoiced monthly. There is no minimum threshold — all revenue accrues regardless of amount.