@lhouse/lighthouse-plugin-publisher-ads
v1.0.1-beta.2
Published
A Lighthouse plugin to improve ad speed and overall quality through a series of automated audits.
Downloads
12
Readme
Publisher Ads Lighthouse Plugin
Publisher Ads Lighthouse Plugin is a tool to improve ad speed and overall quality through a series of automated audits. At the moment, this is primarily targeted at sites using Google Ad Manager. This tool will aid in resolving discovered problems, providing a tool to be used to evaluate effectiveness of iterative changes while suggesting actionable feedback.
This tool is a plugin for Lighthouse, an open-sourced tool integrated into Chrome dev tools that is widely used by developers.
In order to help us improve please file an issue to let us know of any issues or suggestions you may have.
Web App
We currently have a web app version of Publisher Ads Lighthouse Plugin. It can be accessed at developers.google.com/publisher-ads-audits.
Lighthouse Node CLI
Publisher Ads Audits is available as a node package which can be used with the Lighthouse CLI.
Note: There is currently a bug specifically affecting global installs of of this package. Until this bug is resolved this should exclusively be used as a local install.
Setup
mkdir pub-ads-audits-wrapper && cd pub-ads-audits-wrapper && \
npm init -y && \
yarn add -D lighthouse && \
yarn add -D lighthouse-plugin-publisher-ads
Usage
From within
wrapper
directory
yarn lighthouse {url} --plugins=lighthouse-plugin-publisher-ads
See Lighthouse documentation for additional options.
Development
Setup
git clone [email protected]:googleads/publisher-ads-lighthouse-plugin.git
cd publisher-ads-lighthouse-plugin
yarn
Usage
node index.js <url>
Available options:
--view
: Open report in Chrome after execution.--full
: Run all Lighthouse categories.- Any other Lighthouse flags.
Some common options are:
--additional-trace-categories=performance
to include general web performance audits.--emulated-form-factor=desktop
to run on the desktop version of the site.--extra-headers "{\"Cookie\":\"monster=blue\"}"
to include additional cookies on all requests.
Tests
# Lint and test all files.
yarn test
Contributions
See CONTRIBUTING.md
References
- Lighthouse Docs: https://github.com/GoogleChrome/lighthouse
- DevTools Protocol: https://chromedevtools.github.io/devtools-protocol