Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gmodena/bazaar
A webextension that collects Prebid.js requests
https://github.com/gmodena/bazaar
auction experimental prebid privacy-tools
Last synced: about 2 months ago
JSON representation
A webextension that collects Prebid.js requests
- Host: GitHub
- URL: https://github.com/gmodena/bazaar
- Owner: gmodena
- License: mit
- Created: 2020-01-18T20:29:11.000Z (almost 5 years ago)
- Default Branch: development
- Last Pushed: 2021-03-21T21:22:51.000Z (almost 4 years ago)
- Last Synced: 2023-03-10T22:03:22.633Z (almost 2 years ago)
- Topics: auction, experimental, prebid, privacy-tools
- Language: JavaScript
- Homepage:
- Size: 43 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Bazaar
Bazaar is a webextension (Firefox, Chrome) that collects [Prebid.js](http://prebidjs.com) bid requests. A devtool panel allows collecting an advertiser raw bid response (by parsing the XHR log).
# Header bidding
Header Bidding is a client side technology for auctionining online advertising. It allows publishers to offer inventory
to advertisers and exchanges simultaneously, before calling into an adserver. Wait what?
Every time a client visits a webpage (let's say [www.theguardian.com](https://www.theguardian.com/international)), a piece of javascript
is downloaded which executes an auction for properties the site would like to monetize (banners, video).
Under the hood the auction javascript sends out a bid request (`GET`) to a pool of advertisers the publisher partners with, broadcasting
information about the inventory (`size`, `url`) and the client (`useragent`, `ip`). The advertiser responds to the request with
either a valid bid, or with a "pass". Once all bids are collected, an auction is ran on the client and the winning bid (if any passes eligibility criteria) is sent out to the publisher adserver.
This extension is born from an itch I had to scratch after over half a decade spent in a large European supply-side adtech company. From 2012 to 2019 I had a chance to build a decent grasp of bid dynamics and server side machinery, but I never
got much of chance to get my hands dirty on the client.
This extension logs [Prebid.js](https://prebid.org/) traffic (a popular header bidding solution). The goal is to collect a dataset and, over time, be able to answer the following questions:
1. How much are advertiser willing to pay for my attention?
2. Who's bidding for me and where?
3. Can any bidding pattern be identified?
Being online advertisement a high numbers game, I don't expect to extrapolate anything from a single datapoint, but if this gets
any interest and traction it could be interesting to carry out a coordinated effort (following the example of the folks at [https://tracking.exposed/](https://tracking.exposed/)).
# Build and install
Bazaar is currently under development and not yet available on Mozilla and Google repositories.
Install dependencies with
```
$ npm install
```
Build the extension with:
```
$ npm run build
```
The resulting `estension-dist` can be manually installed on [Firefox]() and [Chrome/Chromium]().
Alternatively, the extension can be tested using the [web-ext](https://github.com/mozilla/web-ext) tool with
```
$ web-ext run --target=firefox-desktop
```
or target Chromium with
```
$ web-ext run --target=chromium --chromium-binary $CHROME_BIN
```
# Data collection and analysis
Bazaar uses [pouchdb](https://pouchdb.com/) to locally store Predib requests and responses. The database attempts to sync to a couchdb instance (expected to run at `http://localhost:5984`) for offline data analysis.