A use case demo library for Privacy Sandbox APIs on the web.
The Privacy Sandbox initiative offers 20+ APIs to protect people’s privacy online while giving companies and developers tools to build thriving digital businesses.
Web ecosystem developers expect new approaches to typical use cases supported today by third-party cookies. These use cases often require incorporating a combination of new Privacy Sandbox APIs into their products, which requires advanced planning and a clear understanding how these APIs work.
The Privacy Sandbox Demos repository offers cookbook recipes, sample code, and demo applications, based on Privacy Sandbox APIs. These are intended to aid businesses and developers in adapting their applications and the businesses they support to a web ecosystem without third-party cookies.
All the demo code and assets are released under the Apache open-source license to allow you to extend and modify the code for your own needs.
This repository contains :
- A set of applications/services deployable as container images
- Deployment scripts
- Instructions for deploying and running the demos in your local environment with Docker
- Instructions for deploying and running the demos on Google Cloud Platform
- Development framework to contribute to the project
If you are a developer we recommend you follow the deployment instructions. If you are simply curious, we recommend you have a look at our Google-hosted instances to quickly start learning and experimenting.
The current release supports the following use cases:
| Category | Use Case | Privacy Sandbox APIs | Relevant for |
|---|---|---|---|
| Show Relevant Video Ads | Instream VAST video ad in a Protected Audience multi-seller auction | Protected Audience API | Publisher, Ad Server, SSP, Advertiser, DSP |
| Show Relevant Video Ads | Instream VAST video ad in a Protected Audience single-seller auction | Protected Audience API | Publisher, SSP, Advertiser, DSP |
| Show Relevant Content and Ads | Retargeting / Remarketing | Protected Audience API | Publisher, SSP, Advertiser, DSP |
| Measure Digital Ads | Single-touch conversion Attribution | Attribution Reporting API, Aggregation Service | Publisher, SSP, Advertiser, DSP |
These use cases are based on a set of demo apps and services that we have developed to simulate the actors in the ad tech ecosystem :
| Demo app/services | Description |
|---|---|
| E-commerce site | An advertiser shopping site |
| News site | A publisher site where ads will be displayed |
| SSP service (Supply Side Platform) | The demo SSP service will Choose ads to show based on Topics, Protected Audience auctions and other contextual or first-party signals. Show ads in iframe or fenced frame. Register view/click impressions with Attribution Reporting API. Detect ad fraud via Private State Tokens |
| DSP service (Demand Side Platform) | The demo DSP service will Add a user into an Interest Group with Protected Audience API. Register conversions with Attribution Reporting API |
We’re continuing our effort to deliver comprehensive documentation and demos, and we welcome your feedback on which use cases you would like to see in future releases. Share your ideas and feedback on our issue tracker.