ad-audit

CLI tool utilizing puppeteer that performs various performance and monitoring audits on ads for Dow Jones publications.

Motivation

The goal of this tool is to help speed up the overall testing, monitoring, and auditing of ads. Instead of manually navigating to pages, hitting refresh, clearing cache, using the GPT publisher console, and sifting through the DOM in the inspector in dev tools, boil down those operations into a CLI. Provides insights into:

• creative wrappers set through DFP
• targeting sent to DFP per ad unit
• ad sizes per unit
• ad units rendered on page

Technology Used

Built with:

• puppeteer - API for Google's Chrome
• inquirer - CLI npm package
• React - dashboard for reports (in progress)

Features

There are currently 4 operations one can perform:

• monitor any requests for ads, and display the URLs parameters per request
• scan a specified ad unit's iframe and return all the scripts within it
• scan the page and return all ad units that have been rendered
• scan all ad units on page, parse out DFP ad request parameters from IAS wrappers

These operations now work with lazy loaded ads!

Installation

Install globally with npm i ad-audit -g.

Usage

Run with check-ads. Follow prompts.
Currently, you will have to exit the app and run again if you want to run more than one operation in sequence.

Upcoming Features

• choose a viewport to load the browser in
• choose a device to load the browser in
• drop cookies on chromium to simulate certain users/impressions for ads
• use users chrome profile to navigate to the site
• provide some sort of dashboard / GUI for results
• integrate with lighthouse
• better control flow, run operations in sequence, pipe results into other operations