This project implements a tiny Supply-Side Platform (SSP) conforming to the OpenRTB 2.5 spec. It simulates the process of bidding for ad placements in an automated auction with react-web-for-tiny-ssp repo.
The system comprises an SSP server, two Demand-Side Platform (DSP) servers (dsp1 and dsp2) and Log server to log impression pixel.
The SSP server carries out the following functions:
- Receive ad call from a web browser
- If the ad call is in a cache, return the cached response.
- If the cache misses, send a bid request to the DSP partners
- Receive bid responses from DSP partners
- Run an auction to determine the highest bid
- Return the winning ad to the browser
- Trigger an impression pixel upon ad display
- Store the impression data in MongoDB via a log server
Each DSP server carries out the following functions:
- Receive bid request from the SSP server
- Respond with a bid response, including the bid price and ad creatives
- Trigger an impression pixel upon ad display
The Log server carries out the following functions:
- Web browser triggers an impression pixel upon ad display
- Store the impression data(Ad ID, Timestamp) in MongoDB
Queries Per Second (QPS) is a key performance metric in digital advertising. In this project, I used goroutines to handle multiple requests concurrently. I also used cache to reduce latency for the same ad requests from web browsers. We can also leverage cloud auto-scaling capabilities to handle traffic spikes in the future.
The servers in this system (SSP, dsp1, dsp2, logserver) are designed to run independently (stateless) so they can be scaled horizontally. This architecture supports high availability and fault tolerance. If we assume to use AWS in the future, load balancers will distribute incoming ad requests across multiple SSP server instances, and the SSP server distributes bid requests across multiple DSP servers. This ensures that the system can handle high QPS while maintaining low latency.
To use this project, you can use Docker Compose to build and run the system with the following commands from the root directory of this project:
Make sure you have installed Docker in your machine.
docker-compose build --no-cache
docker-compose upEach component (ssp, dsp1, dsp2 and logserver) includes unit test cases to ensure that it functions as expected. To test all the components, run the following commands from the root directory of this project.
go test ./...Contributions to this project are welcome. Please follow the standard GitHub Pull Request process to propose changes to this repository.