This is the Java version of Prebid Server. See the Prebid Server Feature List and FAQ entry to understand the differences between PBS-Java and PBS-Go.
Prebid Server is an open source implementation of Server-Side Header Bidding. It is managed by Prebid.org, and upholds the principles from the Prebid Code of Conduct.
This project does not support the same set of Bidders as Prebid.js, although there is overlap. The current set can be found in the adapters package. If you don't see the one you want, feel free to contribute it.
For more information, see:
Please consider registering your Prebid Server to get on the mailing list for updates, etc.
The server makes the following assumptions:
- No ranking or decisioning is performed by this server. It just proxies requests.
- No ad quality management (e.g., malware, viruses, deceptive creatives) is performed by this server.
- This server does no fraud scanning and does nothing to prevent bad traffic.
- This server logs errors but not requests.
- This server has no user profiling or user data collection capabilities.
This project is built upon Vert.x to achieve high request throughput. We use Maven and attempt to introduce minimal dependencies.
When running, the server responds to several HTTP endpoints.
Follow next steps to create JAR file which can be deployed locally.
- Download or clone a project:
git clone https://github.com/prebid/prebid-server-java.git- Move to project directory:
cd prebid-server-javaAnd from this step there are two common use cases, which can be chosen depending on your goals
- Create prebid-server JAR only
- Run below command to build project:
mvn clean package- Create prebid-server JAR with modules
- Run below command to build project:
mvn clean package --file extra/pom.xmlFor more information how to configure the server follow documentation.
The source code includes minimal required configuration file sample/prebid-config.yaml.
Also, check the account settings file sample/sample-app-settings.yaml.
For more information how to configure the server follow documentation.
Run your local server with the command:
java -jar target/prebid-server.jar --spring.config.additional-location=sample/prebid-config.yamlFor more options how to start the server, please follow documentation.
To check the server is started go to http://localhost:8080/status
and verify response status is 200 OK.
- Endpoints
- Adding new bidder
- Adding new analytics module
- Adding viewability support
- Auction result post-processing
- Cookie Syncs
- Stored Requests
- Unit Tests
- Functional Tests
- GDPR