iOne Ad Plugin Documentation

This image lists out all of the available pos values inherently supported by the plugin:

ione ad units

Features

  • Incontent Ad: Added to posts with more than 300 words. Initial insertion at 75 words, repeated 4 times every 250 words.
  • Anchor ad.
  • Index Exchange.
  • DFP Specific: async rendering, single request, collapse empty divs.
  • Targeting for postID, category, tag, kw ( via ?ads_add_testing_keyword ), pg=home.
  • Can add additional targeting to ad units via config.

How to use

This is already on the plugin’s Settings page.

There are 2 ways of adding advertisement to your site: Widgets and Copy+Paste code.

Widgets

If your site supports widgets, and the you are planning on using ads on those sidebars, you can use the IOne Advertisement Widget by dragging and dropping onto the sidebar, just like you would with any other widgets. Once dropped, just select the position you would like to use.

Copy and Paste Code

If you have access and would like to add the ads manually, you can use HTML code and replace the pos value to the ad you would like to use and then paste it in your site:

<div class="ione-ad" data-pos="top"></div>

The plugin will find this code and make an ad out of it. In this example the ad with pos=top will be used.

Download

From S3: https://ione-adstxt.s3.amazonaws.com/ione-min-ads.zip

From Github: https://github.com/interactive-one/ione-ads-basics/releases

Installation

This is the standard WordPress installation:

  • Navigate to Plugins > Add New.
  • Click the Upload Plugin button at the top of the screen.
  • Select the zip file from your local computer.
  • Click the Install Now button.
  • When installation is complete, you’ll see Plugin installed successfully. Click the Activate Plugin button at the bottom of the page.

JSON config

After installation, go to yoursite.com/wp-admin -> Settings -> Advertising in WordPress. That’s where the configuration lives.

The plugin pulls ad definitions from a JSON string we send to partners and they use it as a hands-off copy+paste config. See ad-config.json.

  • desktopBreakPoint: define the size after which the plugin uses the adConfig.sizes.desktop size definitions.
  • baseDesktopAdUnit, baseMobileAdUnit: this is the DFP ad unit
  • targeting: Leave empty as these are overwritten by the postID, categories etc WordPress values as key-value pairs.
  • adConfig.targeting: Each ad looks for a pos value to find its definition. pos value MUST BE KEPT, but you can add other key-value pairs if needed.
  • adConfig.sizes.desktop / adConfig.sizes.mobile: array of array sizes for the definition.
  • You can have as many definitions as you want, but ads will look for pos values, therefore, duplicates are not allowed.
{
	"desktopBreakPoint": [770, 500],
	"baseDesktopAdUnit": "/4052/bossip/desktop",
	"baseMobileAdUnit": "/4052/bossip/mobile",
	"targeting": {},	
	"adConfig": [
		{
			"sizes": {
				"desktop": [[728,90], [970,250], [970,90]],
				"mobile": [[320,50], [320,100], [300,250]]
			},
			"targeting": {
				"pos": "top"
			}
		},
		....
	]
}

Will not do

  • Lazy load
  • AMP ads