Neologistic Paraphasic Mumbling
    Have ideas to improve npm?Join in the discussion! »

    lighthouse-plugin-publisher-ads

    1.5.0 • Public • Published

    Publisher Ads Lighthouse Plugin

    Linux Build Status NPM lighthouse package

    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.

    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 git@github.com: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.

    Continuous Integration

    This plugin can be integrated with your existing CI using Lighthouse CI to ensure that ad performance hasn't regressed. Learn More.

    Tests

    # Lint and test all files.
    yarn test

    Contributions

    See CONTRIBUTING.md

    References

    Install

    npm i lighthouse-plugin-publisher-ads

    DownloadsWeekly Downloads

    1,217

    Version

    1.5.0

    License

    Apache-2.0

    Unpacked Size

    442 kB

    Total Files

    105

    Last publish

    Collaborators

    • avatar