# dianomiltd/prebid-server architecture

> Architecture diagram of the GitHub repository dianomiltd/prebid-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dianomiltd/prebid-server
- Repository: https://github.com/dianomiltd/prebid-server

## Overview

Prebid Server is a server-side header-bidding service. A publisher or client sends an OpenRTB auction request; the HTTP router dispatches it to auction handling, which prepares the request and delegates bidding to the exchange and bidder adapters. The exchange processes bids for the response. The repository also supports user sync, privacy controls, hooks, first-party data, stored requests/responses, currency conversion, caching, analytics, and metrics. Connections reflect the supplied excerpts, SOURCE INDEX references, or README; unsampled subsystem internals are not inferred.

Main entry points: [`endpoints/openrtb2/auction.go`](https://github.com/dianomiltd/prebid-server/blob/master/endpoints/openrtb2/auction.go) (Auction endpoint), [`exchange/exchange.go`](https://github.com/dianomiltd/prebid-server/blob/master/exchange/exchange.go) (Auction exchange), [`router/router.go`](https://github.com/dianomiltd/prebid-server/blob/master/router/router.go) (HTTP router), [`adapters/bidder.go`](https://github.com/dianomiltd/prebid-server/blob/master/adapters/bidder.go) (Bidder framework)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["HTTP runtime"]
  node_router["HTTP router<br/>[router.go]"]
  node_auction_endpoint["Auction endpoint<br/>[auction.go]"]
  node_server["HTTP server<br/>[server.go]"]
end

subgraph group_auction["Auction processing"]
  node_exchange["Auction exchange<br/>[exchange.go]"]
  node_request_model["OpenRTB extensions<br/>[request.go]"]
  node_first_party["First-party data"]
  node_hooks["Auction hooks<br/>[execution.go]"]
end

subgraph group_bidders["Bidder integrations"]
  node_adapter_framework["Bidder framework<br/>[bidder.go]"]
  node_bidder_adapters["Bidder adapters"]
end

subgraph group_platform["Platform services"]
  node_privacy["Privacy enforcement<br/>[enforcer.go]"]
  node_gdpr["GDPR support<br/>[impl.go]"]
  node_usersync["User sync<br/>[syncer.go]"]
  node_stored_requests["Stored requests<br/>[fetcher.go]"]
  node_stored_responses["Stored responses"]
  node_currency["Currency conversion<br/>[rate_converter.go]"]
  node_cache["Prebid cache client<br/>[client.go]"]
  node_analytics["Analytics events<br/>[core.go]"]
  node_metrics["Metrics<br/>[go_metrics.go]"]
end

node_publisher(("Publisher client"))
node_bidders_external(("Bidder services"))

node_publisher -->|"sends HTTP"| node_router
node_router -->|"routes auction"| node_auction_endpoint
node_server -->|"serves handler"| node_router
node_auction_endpoint -->|"starts auction"| node_exchange
node_auction_endpoint -.->|"parses request"| node_request_model
node_auction_endpoint -.->|"executes hooks"| node_hooks
node_auction_endpoint -.->|"resolves stored data"| node_stored_requests
node_auction_endpoint -.->|"applies policies"| node_privacy
node_auction_endpoint -.->|"uses conversion"| node_currency
node_exchange -->|"dispatches bids"| node_adapter_framework
node_adapter_framework -.->|"builds adapters"| node_bidder_adapters
node_bidder_adapters -.->|"requests bids"| node_bidders_external
node_exchange -->|"uses data"| node_first_party
node_exchange -->|"uses syncers"| node_usersync
node_exchange -->|"uses permissions"| node_gdpr
node_exchange -->|"uses stored bids"| node_stored_responses
node_exchange -.->|"caches results"| node_cache
node_auction_endpoint -.->|"emits events"| node_analytics
node_auction_endpoint -.->|"records metrics"| node_metrics
node_router -->|"builds syncers"| node_usersync

click node_router "https://github.com/dianomiltd/prebid-server/blob/master/router/router.go"
click node_auction_endpoint "https://github.com/dianomiltd/prebid-server/blob/master/endpoints/openrtb2/auction.go"
click node_server "https://github.com/dianomiltd/prebid-server/blob/master/server/server.go"
click node_exchange "https://github.com/dianomiltd/prebid-server/blob/master/exchange/exchange.go"
click node_request_model "https://github.com/dianomiltd/prebid-server/blob/master/openrtb_ext/request.go"
click node_first_party "https://github.com/dianomiltd/prebid-server/blob/master/firstpartydata/first_party_data.go"
click node_hooks "https://github.com/dianomiltd/prebid-server/blob/master/hooks/hookexecution/execution.go"
click node_adapter_framework "https://github.com/dianomiltd/prebid-server/blob/master/adapters/bidder.go"
click node_bidder_adapters "https://github.com/dianomiltd/prebid-server/tree/master/adapters"
click node_privacy "https://github.com/dianomiltd/prebid-server/blob/master/privacy/enforcer.go"
click node_gdpr "https://github.com/dianomiltd/prebid-server/blob/master/gdpr/impl.go"
click node_usersync "https://github.com/dianomiltd/prebid-server/blob/master/usersync/syncer.go"
click node_stored_requests "https://github.com/dianomiltd/prebid-server/blob/master/stored_requests/fetcher.go"
click node_stored_responses "https://github.com/dianomiltd/prebid-server/blob/master/stored_responses/stored_responses.go"
click node_currency "https://github.com/dianomiltd/prebid-server/blob/master/currency/rate_converter.go"
click node_cache "https://github.com/dianomiltd/prebid-server/blob/master/prebid_cache_client/client.go"
click node_analytics "https://github.com/dianomiltd/prebid-server/blob/master/analytics/core.go"
click node_metrics "https://github.com/dianomiltd/prebid-server/blob/master/metrics/go_metrics.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_router,node_auction_endpoint,node_server,node_publisher toneBlue
class node_exchange,node_request_model,node_first_party,node_hooks toneAmber
class node_adapter_framework,node_bidder_adapters toneMint
class node_privacy,node_gdpr,node_usersync,node_stored_requests,node_stored_responses,node_currency,node_cache,node_analytics,node_metrics toneRose
class node_bidders_external toneIndigo
```

## Components

### HTTP runtime

- [HTTP router](https://github.com/dianomiltd/prebid-server/blob/master/router/router.go): `router/router.go`
- [Auction endpoint](https://github.com/dianomiltd/prebid-server/blob/master/endpoints/openrtb2/auction.go): `endpoints/openrtb2/auction.go`
- [HTTP server](https://github.com/dianomiltd/prebid-server/blob/master/server/server.go): `server/server.go`

### Auction processing

- [Auction exchange](https://github.com/dianomiltd/prebid-server/blob/master/exchange/exchange.go): `exchange/exchange.go`
- [OpenRTB extensions](https://github.com/dianomiltd/prebid-server/blob/master/openrtb_ext/request.go): `openrtb_ext/request.go`
- [First-party data](https://github.com/dianomiltd/prebid-server/blob/master/firstpartydata/first_party_data.go): `firstpartydata/first_party_data.go`
- [Auction hooks](https://github.com/dianomiltd/prebid-server/blob/master/hooks/hookexecution/execution.go): `hooks/hookexecution/execution.go`

### Bidder integrations

- [Bidder framework](https://github.com/dianomiltd/prebid-server/blob/master/adapters/bidder.go): `adapters/bidder.go`
- [Bidder adapters](https://github.com/dianomiltd/prebid-server/tree/master/adapters): `adapters`

### Platform services

- [Privacy enforcement](https://github.com/dianomiltd/prebid-server/blob/master/privacy/enforcer.go): `privacy/enforcer.go`
- [GDPR support](https://github.com/dianomiltd/prebid-server/blob/master/gdpr/impl.go): `gdpr/impl.go`
- [User sync](https://github.com/dianomiltd/prebid-server/blob/master/usersync/syncer.go): `usersync/syncer.go`
- [Stored requests](https://github.com/dianomiltd/prebid-server/blob/master/stored_requests/fetcher.go): `stored_requests/fetcher.go`
- [Stored responses](https://github.com/dianomiltd/prebid-server/blob/master/stored_responses/stored_responses.go): `stored_responses/stored_responses.go`
- [Currency conversion](https://github.com/dianomiltd/prebid-server/blob/master/currency/rate_converter.go): `currency/rate_converter.go`
- [Prebid cache client](https://github.com/dianomiltd/prebid-server/blob/master/prebid_cache_client/client.go): `prebid_cache_client/client.go`
- [Analytics events](https://github.com/dianomiltd/prebid-server/blob/master/analytics/core.go): `analytics/core.go`
- [Metrics](https://github.com/dianomiltd/prebid-server/blob/master/metrics/go_metrics.go): `metrics/go_metrics.go`

### Other components

- **Publisher client**
- **Bidder services**

## Connections

- Publisher client → HTTP router: sends HTTP (evidence: `README.md`)
- HTTP router → Auction endpoint: routes auction (evidence: `router/router.go`)
- HTTP server → HTTP router: serves handler
- Auction endpoint → Auction exchange: starts auction (evidence: `endpoints/openrtb2/auction.go`)
- Auction endpoint → OpenRTB extensions: parses request
- Auction endpoint → Auction hooks: executes hooks
- Auction endpoint → Stored requests: resolves stored data
- Auction endpoint → Privacy enforcement: applies policies
- Auction endpoint → Currency conversion: uses conversion
- Auction exchange → Bidder framework: dispatches bids (evidence: `exchange/exchange.go`)
- Bidder framework → Bidder adapters: builds adapters
- Bidder adapters → Bidder services: requests bids
- Auction exchange → First-party data: uses data (evidence: `exchange/exchange.go`)
- Auction exchange → User sync: uses syncers (evidence: `exchange/exchange.go`)
- Auction exchange → GDPR support: uses permissions (evidence: `exchange/exchange.go`)
- Auction exchange → Stored responses: uses stored bids (evidence: `exchange/exchange.go`)
- Auction exchange → Prebid cache client: caches results
- Auction endpoint → Analytics events: emits events
- Auction endpoint → Metrics: records metrics
- HTTP router → User sync: builds syncers (evidence: `router/router.go`)
