Skip to content

Latest commit

 

History

History

readme.md

Screenshot Super Cool Ad Manager Plugin

Serve Google Ad Manager ads natively in WordPress. Built to make serving responsive ads easy.

Built by the Institute for Nonprofit News, Super Cool Ad Manager Plugin works with Project Largo or any standalone WordPress blog.


1. What is this thing?

This WordPress plugin serves inventory from a Google Ad Manager account on a WordPress site.

No need to copy and paste ad codes or header tags — the plugin generates all of this on its own.


2. How do I use it?

For the most basic integration, only two steps are necessary.

2.1. Define Settings

Under Settings > DoubleClick/Ad Manager update the field with your network code from Google Ad Manager, and a place to define breakpoints to serve ads to.

NOTE: Both Network Code and Breakpoints may be defined by a developer within the WordPress theme. If a developer already defined these values within the theme, a user will know based on their display in the plugin Settings page.

Screenshot

2.2 Placing Advertisements

Advertisements are placed in two ways.

1. Via Reusable Widget

Screenshot

  • The identifier field is the name of a line item in Google Ad Manager. If an line item with the same identifier in Google Ad Manager matches the identifier set in the widget, the ad will load (subject to conditional targeting set in Google Ad Manager admin). If the identifier is blank or doesn't match a line item in Google Ad Manager, the plugin attempts to load inventory from anywhere in the Google Ad Manager account.

  • Based on breakpoints defined in plugin settings or theme, an Inventory Size can be defined for each breakpoint set either in the plugin settings or via theme function.

    • For an ad the same Inventory Size at every breakpoint, use that size in each breakpoint (i.e. 300x250).
    • For an ad with multiple Inventory Sizes (and corresponding creatives), define the appropriate Inventory Size for each breakpoint (i.e. 320x50 for a mobile breakpoint, 728x90 for tablet and desktop breakpoints).

2. Via Theme Function

See Developer API documentation.

3. Is that it?

Nope! Next configure targeting and advanced users may look at the developer api.