A browser extension which silently crowd-sources ad performance as you browse. Let's put an end to bad ads.
JavaScript HTML CSS
Latest commit 8f9c46c Sep 8, 2016 @FrancescoSTL committed on GitHub Update README.md
Permalink
Failed to load latest commit information.
data
icons
js Fix AMO linter error w/ window.setInterval Sep 7, 2016
styles Enhance profiler tool, styling, copy Sep 7, 2016
views Enhance profiler tool, styling, copy Sep 7, 2016
.gitignore Add gitignore update Aug 14, 2016
LICENSE Add v0.0.1 skeleton Jul 24, 2016
README.md
manifest.json
package.json
web-crawler.js

README.md

Site Sonar Header Image

Site Sonar

A project aimed at identifying ad networks with the fastest and slowest performing ad's on the internet through crowd-sourced, easy to understand, and openly accessible benchmarking data. Inspired by Lightbeam, the Site Sonar browser extension (hosted in this repository) locates and benchmarks ad content silently while you browse. It is then sent to Site-Sonar's servers, where the data is aggregated and displayed on our public dashboard (repo).

Index

Installing Site-Sonar

For Firefox

Clone the repository by running:

git clone https://github.com/FrancescoSTL/Site-Sonar.git

Download and install Node.js

Once you've cloned the repo and installed Node.js, you can start Site-Sonar by running:

  1. npm install
  2. npm run bundle
With web-ext

If you're using web-ext, you'll need to do so with a pre-release version of Firefox for now, as it is only supported in Firefox 49 or higher.

  1. Install web-ext if you haven't already
  2. web-ext run --firefox-binary=/Path/to/your/FirefoxDeveloperEdition/or/FirefoxBeta/or/FirefoxNightly.app

OR

Without web-ext

  1. Go to about:debugging
  2. Click "Load Temporary Add-on"
  3. Select any file in your locally downloaded version of Site-Sonar

For Chrome

  1. Clone the repository by running:
git clone -b Chrome-and-Opera-Version https://github.com/FrancescoSTL/Site-Sonar.git
  1. Download and install Node.js
  2. Go to chrome://extensions
  3. Click "Load Unpacked Extension"
  4. Navigate to the folder where you downloaded Site-Sonar
  5. Click "Select"

For Opera

  1. Clone the repository by running:
git clone -b Chrome-and-Opera-Version https://github.com/FrancescoSTL/Site-Sonar.git
  1. Download and install Node.js
  2. Go to extensions
  3. Click "Load Unpacked Extension"
  4. Navigate to the folder where you downloaded Site-Sonar
  5. Click "Select"

Data Site-Sonar Collects

Using Disconnect's Blacklist of ad domains, Site-Sonar will benchmark and collect the following information about each ad asset in your browser:

  1. assetCompleteTime Integer Amount of time (in milliseconds) that the network took to respond to the HTTP request for the asset. This is calculated using a time diff between onSendHeaders and onHeadersReceived.

  2. originUrl String The URL from which the HTTP request originated. In many cases, this will be the hostUrl, however, sometimes ads will trigger their own HTTP requests. For example, checkout the following example from some real world data we pulled in Site-Sonar Issue #17

  3. hostUrl String The top level host URL from which the HTTP request originated. For example, if you have 3 tabs open and one request originates from the first tab (lets say, youtube.com), the top level host would always be said tab's url (youtube.com).

  4. adNetworkUrl String The host URL of the ad asset.

  5. assetType String Can be anything recieved by webRequest.ResourceType.

  6. fileSize Integer File size in octets of bits.

  7. timeStamp Integer Time when the asset was requested (in milliseconds) since the epoch

  8. method String Either "GET" or "POST".

  9. statusCode Integer Standard HTTP status code returned by the server. Ex: 200, 404, 301, etc

  10. adNetwork String The Ad Network for which the asset belongs.

Privacy Policy

Site-Sonar Privacy Summary

Site-Sonar is a browser extension currently supported in Firefox, Chrome, and Opera, which silently collects data about how ad's are performing in your browser. After collecting that data, it will be sent to Site-Sonar's server to aggregate (unless you opt out) and keep ad networks accountable through publicly accessible performance information.

What you should know

  1. Upon installing Site-Sonar, data will be collected locally and stored in your browser. Unless you opt out, every 2 minutes, that data will be sent to Site-Sonar servers for aggregation and display on our public dashboard.
  2. By default, data collected by Site-Sonar is sent to us.
  3. You can chose to opt out of sending any data to us.
  4. If you do contributeSite-Sonar data to us, your browser will send us your data in a manner which we believe minimizes your risk of being re-identified (you can see a list of the kind of data involved here). We will post your data along with data from others in an aggregated and open database. Opening this data can help users and researchers make more informed decisions based on the collective information.
  5. Uninstalling Site-Sonar prevents collection of any further Site-Sonarm data and will delete the data stored locally in your browser.

FAQ

Will Site-Sonar track my browsing history?

Sort of. Once installed, Site-Sonar collects the host url of any website you browse that hosts ad content. Read more in our Privacy Policy or Summary of Data Collection.

How can I contribute?

Check out our installation instructions and then head to our Github Issues page for either the Site-Sonar web extension (this repo), or the Site-Sonar Dashboard.

Who are you?

A group of humans interested in making the internet a better place through a pragmatic approach to problems on the web.

Specifically:

How can we contact you?

Visit our Contact Page.