Adverts

Banners > Adverts

In this section of the plugin, you will be able to manage, edit, and add new banner ads, known as adverts, ads, banner ads, and banner adverts throughout our documentation.

 

Manage Adverts

click to enlarge

1. Add New

Clicking this button will take you to ‘Save a Banner Ad’ where you can create a new banner. New adverts added will show up on this ‘Manage Ads’ screen at the top after they are added (or edited).

2. Bulk Actions

These bulk actions allow you to select multiple ads from the table using the checkboxes and then apply a specific bulk action on the selected records.

3. Search Ads

Quickly search the database for Ads by typing a word or phrase and then clicking the ‘Search Ads’ button.

4. Ad Sections/Columns

This section and table includes columns that display lots of information about the created adverts, allowing you to quickly glance at their data. Columns like Locations and Schedule include the word “View” when data is found. Hover over the word “View” to display a tooltip.

5. Ad Actions

For each of the actions like Edit | Copy | View | Delete | Preview, select one of these actions to edit, copy, view, delete, or preview the ad. Note that ad types Code and Pushdown cannot be previewed.

6. Export Stats

Export advert statistics to a CSV file by clicking the “Export Stats” link. Hover over CTR% column to see this option. You’ll be redirected to the Export Stats page, where you can click on the Download CSV button to download the stats to your device. In any case, exporting the stats creates a file in your server. To learn how to delete those files, follow our short Delete Exported Stat Files section on the Settings documentation page.

7. Activate/Deactivate

Hover over Status column to activate/deactivate every ad separately by clicking on the Activate or Deactivate link accordingly. This serves as a quick way to do so. Otherwise, you can edit an ad to accomplish that.

8. Shortcode

Use the ad shortcode on any page/post/widget to display that ad. You can click to copy it. Shortcodes are not available for pushdown ads since those appear only at the top or bottom of the website. Click once to copy a shortcode.

9. Date

This column shows the date on which this banner ad was created. Hover to see a tooltip with the full date and time.

10. Screen Options

Click Screen Options to enable/disable the columns and to choose the number of Adverts visible per page.

 

Save a Banner Ad

This is the page where you can add and edit banner adverts. Go through each section carefully to not miss any details. We’ll start with the top area that includes both Title and Ad Type, then we’ll explain each Ad Type, and finally the extra data and configuration.

 

Top Area

1. Ad Title

Insert the title of the ad in this field.

2. Ad Type

Select the type of banner ad you are adding, using the radio buttons. These are the following available ad types:

• Image
• Pushdown
• Video
• Flash – Deprecated
• Code

We’ll describe the functions of Ad Types below, after the statistics & configuration sections.

 

Statistics

Most of these appear for most saved ad types and allow you to view and export the statistics of each advert.

3. Export Stats

Export advert statistics to a CSV file by clicking the “Export Stats” link. You’ll be redirected to the Export Stats page, where you can click on the Download CSV button to download the stats to your device. In any case, exporting the stats creates a file in your server. To learn how to delete those files, follow our short Delete Exported Stat Files section on the Settings documentation page.

4. Current Views

This is the amount of views that this banner has received.

5. Clicks

This is the amount of clicks that this banner has received for its Location/URL. The Ad Types > Video and Code do not display this information.

6. Click-Through Rate (CTR%)

This is the Click-Through Rate (CTR%) for this banner, calculated as clicks divided by views, and then multiplied by 100. The Ad Types > Video and Code do not display this information.

 

Configuration

Most of these appear for most ad types and allow you to customize certain aspects of each advert.

7. Max Impressions

Set the max amount of impressions for this banner. After this amount of impressions, the banner will no longer show on the front-end. If you need unlimited impressions, leave this field blank.

Note: An impression is counted when a user loads a page that has a banner. It then sends an Ajax request and it may take from a few milliseconds to a few seconds to count it, depending on the server speed.

8. Start Date

Select a date and time on which this banner should start displaying on the site.

9. Expires

If you need this banner to stop displaying at some stage, select yes. You will then be able to select the expiry date and time under End Date.

10. End Date

Related to Expires. Select a date and time on which this banner should stop displaying on the site.

11. Banner Size

Select the size of the banner in the dropdown. You can manage sizes for banners under Banners > Sizes. The Ad Type > Pushdown does not display this information.

12. Zones

Select the zone(s) that you need this banner to display on your site. You can manage Zones under Banners > Zones. The Ad Type > Pushdown does not display this information as it cannot be part of a zone due to Pushdown banners appearing either at the top and/or bottom of a page.

13. Geotargeting – Locations

Select the location(s) where you would like this to appear. Leave empty to target every location. You can manage locations under Banners > Geotargeting.

14. Show on Posts/Pages

Search and select posts and pages where you would like to only display this banner ad. Leave empty to display everywhere.

15. Text Box

If you need a text box on your banner, select Yes on this setting. You will then get a text box where you can enter some text to display and you will be able to set alignment.

16. Text Alignment

Related to Text Box. Choose between Left, Center, and Right text alignment.

17. Override Text Box Presentation

Related to Text Box. Tick the box to override and set the colors, border, and padding for this advert. A preview also appears, dynamically displaying all changes done to the Text Box. If this is not ticked, it will use the default options set in Settings.

18. Status

Select the status of this banner. Choose between “Active” and “Inactive”.

 

Ad Types

These are the different banner ad types that we support.

 

Image

click to enlarge

Image File: As in the image above, you will get an upload button to select an image to upload. Choose a media or enter the URL of your choice (e.g.: https://example.com/wp-content/uploads/wp-banners/example.jpg).

Location/URL: In this field, you can add a URL that will make the banner clickable. When clicked, users will be redirected to the entered URL.

– Target Window: This only appears if text is entered in Location/URL. Choose if you want this link to be opened in the same or new window/tab in your browser.

Alternate Banner: Only works with the Image Ad Type. This enables the option for you to choose an alternate banner image either when hovering or clicking on the current banner. This disables Location/URL unless Redirect After Click is enabled. Enabling this option adds new extra options below.

– Alternate Image: Related to Alternate Banner. Select the alternate image. Choose a media or enter the URL of your choice (e.g.: https://example.com/wp-content/uploads/wp-banners/example.jpg).

– Trigger Method: Related to Alternate Banner. You can set the Trigger Method. On Click means it requires a mouse click to view it and On Hover means that hovering a mouse cursor over the image would display the alternate image.

– Redirect After Click: Related to Alternate Banner. If this is ticked, once the alternate image is displayed, clicking on it would redirect you to the URL chosen under Location/URL.

 

Pushdown

Display an image banner at the top or bottom of the website. That banner takes the full width of the website and pushes the rest of the website’s content down or up, depending on the banner location.

Only one top and/or one bottom pushdown banner can be active at a time. To clarify, both top and bottom banners can be active simultaneously but you cannot display more than 1 top and/or more than 1 bottom at the same time (one top and one bottom on a page are allowed but not two of each). You can have more than one top or bottom pushdown banners active on different pages.

 

Banner Location: Choose where to display the pushdown banner, whether at the top or bottom of the website.

 

Pushdown Mode: Choose between Standard and Expandable. Standard displays a static banner image, unless Alternate Banner is used. It can basically be used as a type of hero image, if desired. Expandable allows users to expand the image to show a larger or different one either by clicking or hovering their mouse, depending on your configuration. Although many settings overlap, each has its own configurations, which we’ll explain below.

 

Pushdown Standard

click to enlarge

Pushdown Image: Select the pushdown image that will be shown when the page is loaded. Select a media or enter the URL of your choice (e.g.: https://example.com/wp-content/uploads/wp-banners/example.jpg).

Location/URL: In this field, you can add a URL that will make the banner clickable. When clicked, users will be redirected to the entered URL.

– Target Window: This only appears if text is entered in Location/URL. Choose if you want this link to be opened in the same or new window/tab in your browser.

Alternate Banner: Only for Pushdown Mode > Standard. This enables the option for you to choose an alternate banner image either when hovering or clicking on the current banner. This disables Location/URL unless Redirect After Click is enabled. Enabling this option adds new extra options below.

– Alternate Image: Related to Alternate Banner. Select the alternate image. Choose a media or enter the URL of your choice (e.g.: https://example.com/wp-content/uploads/wp-banners/example.jpg).

– Trigger Method: Related to Alternate Banner. You can set the Trigger Method. On Click means it requires a mouse click to view it and On Hover means that hovering a mouse cursor over the image would display the alternate image.

– Redirect After Click: Related to Alternate Banner. If this is ticked, once the alternate pushdown image is displayed, clicking on it would redirect you to the URL chosen under Location/URL.

Fit to Screen (Height): This ensures that your image does not extend past a browser’s viewport, if it is longer.

Max Height: Only for Pushdown Mode > Standard. Select the maximum height for the pushdown banner. Choose Auto to make it responsive.

– Custom Max Height: Appears when Custom is selected under Max Height. Enter max height value without adding “px”. E.g.: 350

Collapsible: Allows visitors to collapse and expand the pushdown banner to hide it from their view.

– Expand/Collapse Trigger: Choose what to show as the expand/collapse trigger, whether text or an icon (arrow).

— Collapse Text: Only appears if Expand/Collapse Trigger is set to Text. This is the button’s text used for collapsing the banner.

— Expand Text: Only appears if Expand/Collapse Trigger is set to Text. This is the button’s text used for expanding the banner.

– Expand/Collapse Trigger Location: Display the expand/collapse trigger on the left or right.

Closable: Allows visitors to completely close and not see the pushdown banner anymore.

– Cookie Expiry: This enables you to forcefully restore the pushdown banner to those users that closed it. Choose the number of days until cookies expire and the pushdown banner reappears. Note that if users clear their browser cookies, the banner will reappear. 0 or empty means unlimited, with no expiry of cookies.

– Close Trigger: Choose what to show as the close trigger, whether text or an icon (X).

— Close Text: Only appears if Close Trigger is set to Text. This is the button’s text used for closing the banner.

– Close Trigger Location: Display the close trigger on the left or right.

 

Pushdown Expandable

click to enlarge

Pushdown Image: Select the pushdown image that will be shown when the page is loaded. Select a media or enter the URL of your choice (e.g.: https://example.com/wp-content/uploads/wp-banners/example.jpg).

Pushdown Expanded Image: Only for Pushdown Mode > Expandable. Select the pushdown expanded image that will be shown when expanded. Select a media or enter the URL of your choice (e.g.: https://example.com/wp-content/uploads/wp-banners/example.jpg).

Location/URL: In this field, you can add a URL that will make the banner clickable. When clicked, users will be redirected to the entered URL.

– Target Window: This only appears if text is entered in Location/URL. Choose if you want this link to be opened in the same or new window/tab in your browser.

Fit to Screen (Height): This ensures that your image does not extend past a browser’s viewport, if it is longer.

Trigger Method: Only for Pushdown Mode > Expandable. You can set the Trigger Method. On Click means it requires a mouse click to expand it and On Hover means that hovering the mouse cursor over the image would display the expanded image.

Expand/Collapse Trigger: Choose what to show as the expand/collapse trigger, whether text or an icon (arrow). Pushdown Mode > Expandable must always be allowed to expand and collapse, unlike Pushdown Mode > Standard.

– Collapse Text: Only appears if Expand/Collapse Trigger is set to Text. This is the button’s text used for collapsing the banner.

– Expand Text: Only appears if Expand/Collapse Trigger is set to Text. This is the button’s text used for expanding the banner.

– Expand/Collapse Trigger Location: Display the expand/collapse trigger on the left or right.

Closable: Allows visitors to completely close and not see the pushdown banner anymore.

– Cookie Expiry: This enables you to forcefully restore the pushdown banner to those users that closed it. Choose the number of days until cookies expire and the pushdown banner reappears. Note that if users clear their browser cookies, the banner will reappear. 0 or empty means unlimited, with no expiry of cookies.

– Close Trigger: Choose what to show as the close trigger, whether text or an icon (X).

— Close Text: Only appears if Close Trigger is set to Text. This is the button’s text used for closing the banner.

– Close Trigger Location: Display the close trigger on the left or right.

 

Video

Video URL: You can paste the URL of videos from many services, such as YouTube, Blip, Vimeo, DailyMotion, and others, and the embed code will be automatically created. Simply copy and paste the URL from the browser address bar on the page while watching the video.

 

Flash

We don’t suggest using Flash since it is no longer supported.

Select the flash file with the “Select Flash File” button.

Alternative Content: Insert some alternative content which you’d like to display if the user doesn’t have a flash player installed.

Enable Click Tag: The plugin can also track clicks on these Flash ads/banners using the Flash clickTAG mechanism. Set this setting to Yes to allow this plugin to track the clicks per flash banner. Documentation on Click Tag

– Click Tag URL: When someone clicks on this banner, they will be redirected to that URL.

 

Code

HTML Code: Insert any HTML, CSS or JavaScript code according to your needs. No PHP allowed. Use the available tags (“formatting options”).