CM Ad-Changer (CMAC) - Campaigns - Displaying a Campaign
Displaying a Campaign
After installing the CM Ad-Changer client plugin on your client website, you’ll need to define the server from which ads are served.
Then, you’ll be able to display all campaigns and campaign groups by using a simple shortcode that can be placed on any page or post.
Alternatively, you can use the ad changer client widget for cases when you want to display ads on one of your widget areas.
While the instructions on this page apply to both the client and server sides of ad-changer, bare in mind to never install the client and server plugins on the same website.
Using and Customizing the Ad-changer Client Shortcodes
To add banners to a post or page simply insert the shortcode, along with the relevant parameters. Here is list of parameters that can be used to display custom features and ad styles:
- – ID number of the advertising campaign (required).
- – Banner can be a linked image or just an image. This value can be 1 or 0 (default: 1).
- – Settings to show the debug info. Can be set as 1 or 0 (default: 0).
- – Image Wrapper On or Off. Can be 1 or 0 (default: 0).
- – Banner (wrapper) class name.
- – Banner is not responsive. Can be set as 1 or 0 (default: 0). Adding the no_responsive attribute cancels the usage of banner variations, instead only banners with original dimensions are requested by the client.
Displaying Ads Using the Ad-changer Client Widgets
Ad-Changer campaigns and campaign groups can also be displayed on widget areas such as your sidebars, headers and footers on both client and server sites. By adding the CM Ad-Changer widget to those areas under Appearance → Widgets.
- Title – Title that will appear above the widget
- Campaign ID – ID of an existing campaign from to be displayed on the ad-server widget (required)
- Linked Banner – Define whether or not your banner should link to campaign URL or not.
- Class – Banner (wrapper) class name CSS Class of wrapper. If wrapper is turned off then the class is added to widget wrapper.
- Title Class – Widget Title class name
- Custom CSS – The CSS code to be displayed with the banner
- Allow Inject JS – Choose if the JS sent from the CM Ad Changer Server should be injected.
- Allow Inject HTML – Choose if the HTML sent from CM Ad Changer Server should be injected.
- Banner Width/Height – Set banner dimensions.
- Wrapper – Decide if banner should have been wrapped with div element (works only if class is set).
- Not Responsive – If banners are not responsive, shut this setting off. Can be a value of 1 or 0 (default: 0)
Not using responsive settings cancels the option of banner variations, in this instance only banners with original dimensions will be provided when requested
Below: This is where you’ll enter your campaign group details to display multiple campaigns on the same ad spot. Additional fields works just like in Ad-Changer widget.
Once you’ve entered a campaign’s parameters, they will permanently be displayed on that specific widget area.
Below: Ad-Changer campaign displaying in the sidebar.