hestiaAI / ad-radar

Ad Radar - a browser extension that shows information about the ads you see online - developed by Hestia for The Eyeballs.
https://eyeballs.hestialabs.org/
GNU Affero General Public License v3.0
9 stars 1 forks source link
browser-extension chrome-extension

Ad Radar

About

Ad Radar is a browser extension that allows you to better understand how advertisers target you and how much they are willing to pay for you to see their ad.

How does Ad Radar work?

Ad Radar relies on an Ad Tech technology known as Header Bidding, or Pre-Bidding.

Usually, when you go to a webpage that displays ads, the ads that are shown to you are determined almost instantaneously through a real time auction, and your personal data is used by the advertisers to determine how much they are willing to pay for a particular ad impression. This is often called Real-Time Bidding. Most of the time, this auction for your attention takes place outside the browser, in a network of complicated Ad Tech entities such as Supply Side Platforms, Ad Exchanges, and Demand Side Platforms. The only thing that the browser sees are the ads that won the auction, and we can't really know how much a particular ad impression cost.

With Header Bidding, an auction for the different ad spaces of the webpage also takes place in real time, but all the bids coming from the advertisers are gathered in the browser. In this case, Ad Radar can observe the (pre)bids that were received for each ad space, and display the value of these bids.

Ad Radar checks if the visited webpage uses some library that implements Header Bidding (for instance Prebid.js, often imported as pbjs), and thus only works on webpages that do.

Installation

There are two ways to install Ad Radar on your browser:

a) Through the extension stores

Mozilla Firefox

https://addons.mozilla.org/firefox/addon/ad-radar/

Google Chrome (and other Chromium-based browsers)

https://chrome.google.com/webstore/detail/ad-radar/glckjmlmkoofofclahanidfhaoihodjc

b) Manually

Select the latest release of Ad Radar on the right panel of the main GitHub page (or just click here). Then, download the release file corresponding to your browser.

The next steps depend on your web browser:

Mozilla Firefox

Go to Settings > Extensions & Themes > Tools for all add-ons > Debug Add-ons > Load Temporary Add-on and choose the file firefox.xpi. Note that Ad Radar will be uninstalled whenever you close the browser.

Google Chrome

First of all, unzip the file chrome.zip into a folder called Ad Radar. Then, go to Settings > Extensions. Activate developer mode by clicking on Developer mode. Click on Load unpacked and select the Ad Radar/src folder.

To uninstall Ad Radar, on the installation screen, click Remove under Ad Radar.

How to use Ad Radar

First, if you have an ad blocker, consider deactivating it temporarily. Also, make sure that you can see the icon of the extension on the top bar of your browser (on Chrome, you have to pin the icon). Then:

  1. Go to one of the webpages in our list of compatible webpages
  2. Wait for the page and its ads to finish loading
  3. Ad Radar shows:
    1. a red banner next to the ads that it detected and show the prices that were paid for them
    2. the number of detected ads on the icon of the extension

Understanding the banners

Ad Radar shows a red banner next to the ads that it detected, showing the cost of the ad in CPM (cost per mille, e.g. the price paid for a thousand impressions).

There are 3 possibilities when Ad Radar detects an ad:

  1. Ad Radar couldn't find any information about the ad cost. The banner shows No information found for this ad.
  2. Ad Radar observed the prebid that won the auction for this ad space and knows exactly how much was paid, and through which advertiser network. The banner shows CPM of {price} paid via {network}.
  3. Ad Radar observed prebids but the auction was won through another ad channel, so it retrieves the prebid with the highest cost. The banner shows CPM of at least {price}.

List of compatible webpages

Our browser extension is likely to work on the following webpages:

country webpage
๐ŸŒ International https://accuweather.com
International https://www.businessinsider.com
International https://cnn.com
International https://context.reverso.net
International https://espn.com
International https://www.eurogamer.net
International https://futurism.com
International https://www.gamespot.com
International https://www.linguee.com
International https://www.metacritic.com
International https://www.researchgate.net
International https://www.reverso.net
International https://theguardian.com
International https://www.independent.co.uk
International https://usatoday.com
International https://vice.com
------- ----------------------
๐Ÿ‡ง๐Ÿ‡ช Belgium https://www.dhnet.be
Belgium https://www.gva.be
Belgium https://www.hbvl.be
Belgium https://fr.metrotime.be
Belgium https://nl.metrotime.be
Belgium https://lacapitale.sudinfo.be
Belgium https://lanouvellegazette.sudinfo.be
Belgium https://lameuse.sudinfo.be
Belgium https://laprovince.sudinfo.be
Belgium https://levif.be
Belgium https://www.moustique.be
Belgium https://www.nieuwsblad.be
Belgium https://nordeclair.sudinfo.be
Belgium https://plusmagazine.knack.be
Belgium https://standaard.be
------- ----------------------
๐Ÿ‡จ๐Ÿ‡ฆ Canada https://www.lapresse.ca
Canada https://whoacanada.ca
------- ----------------------
๐Ÿ‡ซ๐Ÿ‡ท France https://www.20minutes.fr
France https://www.750g.com
France https://actu.fr
France https://www.actuabd.com
France https://www.aisnenouvelle.fr
France https://www.allocine.fr
France https://www.aufeminin.com
France https://www.autohebdo.fr
France https://www.bienpublic.com
France https://www.capital.fr
France https://www.centre-presse.fr
France https://www.charentelibre.fr
France https://www.clubic.com
France https://www.courrierinternational.com
France https://www.courrier-picard.fr
France https://www.definitions-marketing.com
France https://www.dna.fr
France https://www.estrepublicain.fr
France https://fr.euronews.com
France https://www.futura-sciences.com
France https://www.gala.fr
France https://www.gamekult.com
France https://www.hbrfrance.fr
France https://www.iphon.fr
France https://www.jeuxvideo.com
France https://www.lalsace.fr
France https://www.ladepeche.fr
France https://www.lamontagne.fr
France https://www.larepubliquedespyrenees.fr
France https://latribune.fr
France https://www.lavoixdunord.fr
France https://www.leberry.fr
France https://ledauphine.com
France https://www.lest-eclair.fr
France https://www.leveil.fr
France https://www.lejdc.fr
France https://www.lejournaleconomique.com
France https://www.lejsl.com
France https://lemonde.fr
France https://www.leparisien.fr
France https://www.lepopulaire.fr
France https://www.leprogres.fr
France https://www.lesnumeriques.com
France https://www.lessorsavoyard.fr
France https://www.letelegramme.fr
France https://www.linguee.fr
France https://www.lunion.fr
France https://www.lyonmag.com
France https://www.lyonne.fr
France https://maligue2.fr
France https://www.midilibre.fr
France https://moto-station.com
France https://www.nordeclair.fr
France https://www.nordlittoral.fr
France https://www.numerama.com
France https://www.orange.fr
France https://www.paris-normandie.fr
France https://www.pcastuces.com/
France https://www.programme-tv.net
France https://www.psychologies.com
France https://www.purepeople.com
France https://www.republicain-lorrain.fr
France http://www.slate.fr
France https://www.sudouest.fr
France https://telestar.fr
France https://www.telerama.fr
France https://www.timeout.fr
France https://www.tripadvisor.fr
France https://www.varmatin.com
France https://www.vinted.fr
France https://www.vosgesmatin.fr
------- ----------------------
๐Ÿ‡ซ๐Ÿ‡ฎ Finland https://aamuposti.fi
Finland https://www.deitti.net
Finland https://esaimaa.fi
Finland https://forssanlehti.fi
Finland https://hs.fi
Finland https://hameensanomat.fi
Finland https://iltalehti.fi
Finland https://www.inferno.fi
Finland https://ita-savo.fi
Finland https://is.fi
Finland https://kouvolansanomat.fi
Finland https://kraatti.fi
Finland https://loviisansanomat.fi
Finland https://lansi-savo.fi
Finland https://maaseuduntulevaisuus.fi
Finland https://savonsanomat.fi
Finland https://www.sijoitustieto.fi
Finland https://www.suomi24.fi
Finland https://uusisuomi.fi
Finland https://uusimaa.fi
------- ----------------------
๐Ÿ‡ฉ๐Ÿ‡ช Germany https://www.auto-motor-und-sport.de
Germany https://www.bildderfrau.de
Germany https://www.abendblatt.de
Germany https://www.bunte.de
Germany https://www.express.de
Germany https://fnp.de
Germany https://ga.de
Germany https://www.heise.de
Germany https://www.hna.de
Germany https://www.mz.de
Germany https://www.nordbayern.de
Germany https://www.onmeda.de
Germany https://rp-online.de
Germany https://www.schwarzwaelder-bote.de
Germany https://www.stuttgarter-zeitung.de
Germany https://www.swp.de
Germany https://www.tv14.de
Germany https://www.tvdigital.de
Germany https://www.tvdirekt.de
Germany https://www.tz.de
Germany https://www.wa.de
Germany https://www.weser-kurier.de
Germany https://www.westfalen-blatt.de
Germany https://www.wn.de
Germany https://www.wp.de
Germany https://www.zeit.de
------- ----------------------
๐Ÿ‡ฒ๐Ÿ‡จ Monaco https://www.monacomatin.mc
------- ----------------------
๐Ÿ‡ช๐Ÿ‡ธ Spain https://www.20minutos.es
Spain https://www.abc.es
Spain https://as.com
Spain https://www.atlantico.net
Spain https://cadenaser.com
Spain https://www.canarias7.es
Spain https://www.deia.eus
Spain http://www.diarioya.es
Spain https://www.diariodealmeria.es
Spain https://www.diariodeibiza.es
Spain https://www.diariodecadiz.es
Spain https://www.diariodesevilla.es
Spain https://www.eldiario.es
Spain https://www.elcorreo.com
Spain https://www.eldia.es
Spain https://www.elidealgallego.com
Spain https://www.elnortedecastilla.es
Spain https://www.elperiodicodearagon.com
Spain https://www.elperiodicomediterraneo.com
Spain https://www.europasur.es
Spain https://www.elmundo.es
Spain https://elpais.com
Spain https://www.larazon.es
Spain https://www.lavanguardia.com
Spain https://www.marca.com
Spain https://www.niusdiario.es
Spain https://www.superdeporte.es
Spain https://www.farodevigo.es
Spain https://www.granadahoy.com
Spain https://www.laopiniondemurcia.es
Spain https://www.lasprovincias.es
Spain https://www.lne.es
Spain https://www.mundodeportivo.com
Spain https://www.segre.com
Spain https://www.sport.es
Spain https://www.ultimahora.es
------- ----------------------
๐Ÿ‡จ๐Ÿ‡ญ Switzerland https://20min.ch
Switzerland https://ricardo.ch
------- ----------------------
๐Ÿ‡ฌ๐Ÿ‡ง UK https://www.standard.co.uk/
Conspiracy websites (from https://archive.is/vvpf9 ) Languages webpage
๐Ÿ‡ซ๐Ÿ‡ท France https://wikistrike.com
๐Ÿ‡บ๐Ÿ‡ธ USA https://bongino.com/

Political blog | | webpage | |UK Right-wing | Guido Rawkes https://order-order.com |

Satirical websites Languages webpage
FR https://www.legorafi.fr
EN https://www.theonion.com

Developers

Ad Radar was built using the framework https://github.com/abhijithvijayan/web-extension-starter. See their README for instructions on how to build the release files.

To make sure that everything works, we recommend developping with the versions npm 8.1.2, node v16.13.2 and yarn 1.22.15.

License

Ad Radar is under the GNU Affero General Public License. See https://github.com/hestiaAI/ad-radar/blob/main/LICENCE for more details.

Partners

Ad Radar was built under the banner of The Eyeballs, a project that is part of the HestiaLabs project. We can anticipate multiple opportunities for further collaboration with groups of people who want to use technology to better understand the ways attention is monetized online. Please email eyeballs@hestialabs.org.