rabbithole

Digs down into the nasty details of your ad units

What is rabbithole?

rabbithole is a Chrome extension developed by Jason Priebe, and its main feature is "Digs down into the nasty details of your ad units".

Extension Screenshots

screenshot

Download rabbithole Extension CRX File

Download rabbithole extension files in crx format, manually install Chrome extensions in the browser, or share the crx files with friends to easily install Chrome extensions.

Extension Usage Instructions

                        As a publisher on the web today, you may have a love-hate relationship with ad networks.  On one hand, those ad networks help to pay the bills.  But on the other hand, their questionable coding abilities, poor security, and dubious business practices expose you to all sorts of problems.

Our team has spent countless hours dissecting the DOM to try to track down offending ads.  This is tedious work, especially when an ad call gets bounced from network to network, creating an extremely complex DOM of nested IFRAMEs.

rabbithole is designed to streamline this process.  Using a CSS selector provided by you, it identifies the top-level DOM elements for your ad units.  It then recursively descends those elements, building a simpler object model for you to analyze.

* simplifies the identification and interpretation of the ad-related portion of the DOM
* "compresses" the tree by skipping past DOM elements that aren't really important and only tracking select properties
* makes off-site objects easily identifiable
* tries to identify pixel trackers
* tries to identify the DOM elements that are most likely the ad creative itself
* attempts to keep track of a "network path" so you can see the whole ad chain where ads are coming from; this is a work in progress
* computes statistics like the number of scripts and iframes loaded beneath each node in the tree

In order for rabbithole to work with your site, you need to give it a CSS selector that will capture all the top-level DOM elements of your ad units (and is specific enough to *not* capture non-ad-unit elements).

For example, if you look at the ad tags on http://slashdot.org/, you will see that they all have IDs like "div-gpt-ad-728x90_a" and "div-gpt-ad-300x250_a".  You can capture them all with a selector like

    [id*='div-gpt-ad']

Once you have your selector, use the options dialog to configure rabbithole.  You can open it either from the extensions page in chrome, or by clicking on the gear icon in the rabbithole popup window.  If you have a rabbithole window open when you change the CSS selector, you'll need to close rabbithole and reopen it to get it to rescan your page's DOM.

Source: https://github.com/jpriebe/rabbithole                    

Extension Basic Information

Name rabbithole rabbithole
ID cpffcejbmndcplijjaiflmkgoembjnig
Official URL https://chromewebstore.google.com/detail/rabbithole/cpffcejbmndcplijjaiflmkgoembjnig
Description Digs down into the nasty details of your ad units
File Size 53.23 KB
Installation Count 105
Current Version 1.0.1
Last Updated 2017-05-02
Publish Date 2017-05-02
Rating 5.00/5 Total 1 Ratings
Developer Jason Priebe
Payment Type free
Supported Languages en-US
manifest.json
{
    "update_url": "https:\/\/clients2.google.com\/service\/update2\/crx",
    "manifest_version": 2,
    "name": "rabbithole",
    "description": "Digs down into the nasty details of your ad units",
    "version": "1.0.1",
    "options_ui": {
        "page": "options.html",
        "chrome_style": true
    },
    "permissions": [
        "tabs",
        "activeTab",
        "webNavigation",
        "storage"
    ],
    "browser_action": {
        "default_title": "rabbithole: dig deep into ad units"
    },
    "icons": {
        "16": "icon16.png",
        "48": "icon48.png",
        "128": "icon128.png"
    },
    "background": {
        "scripts": [
            "background.js"
        ]
    },
    "content_scripts": [
        {
            "all_frames": true,
            "js": [
                "content.js"
            ],
            "match_about_blank": true,
            "matches": [
                ""
            ],
            "run_at": "document_idle"
        }
    ],
    "web_accessible_resources": [
        "getFrameId"
    ]
}