Overview

The Ad Manager allows users to pay for prominent placement of their listings on your homepage, top of search results, or sidebar. They can set their desired budget and target specific categories.

Below is a step-by-step guide to setting up and managing ad campaigns.


Configuration

  1. Ad Campaign Settings
    Navigate to Listeo Core → Ad Campaigns to configure your ad prices and settings.
  2. Campaign Product
    In the “Campaign Product” option, you must select a WooCommerce product to handle payments for ad campaigns.
    If no product appears in the list, go to WordPress Dashboard → Products, create a new product, name it, and set the Product Type to “Listeo Ad Campaign.” Publish the product.
    Return to Listeo Core → Ad Campaigns, select the newly created product, and set your ad prices.
    Note: For Pay Per View campaigns, the price is set per 1,000 views.
  3. Ad Campaigns Management Page
    In Listeo Core → Pages, set the Ad Campaigns Manage Page. This page must contain the [listeo_ads] shortcode and should use the Dashboard Page template.

Submit Ad Campaign

In the front-end user dashboard, users can create new ads by clicking the “Create New Campaign” button on the Ad Campaign page. The form is divided into three sections:

  1. Campaign Details
    Select the listing you want to promote.
    Set your budget and choose a campaign type: Pay Per View or Pay Per Click.
    Optionally, set a Start Date for the campaign. If not set, the campaign will start as soon as the ad order is paid for and marked as Completed.
  2. Campaign Filters
    Select if the ad should only appear for a specific category or region.Optionally, limit the ad display by radius (you must have the Radius Search configured in Listeo Core → Map Options).Ads can also be limited to logged-in users only.
  3. Ad Placement
    Choose where the ad will appear:

    1. Home Section (in any home section)
    2. Search Results Section (on top of search results)
    3. Sidebar (you need to add Listeo Ads widget in Appearance > Widgets to the sidebar where you want to display ads)


Checkout and Activation

After submitting the form, the user is redirected to the checkout page to complete the payment. Once the order status is set to Completed, the ad will become active.


Ad Display

The promoted listing will appear in the positions configured in the ad, such as at the top of search results or in the chosen placement areas. Promoted listings will be marked with “Ad” tag.


Listeo Core → Ad Campaigns

Setting Name Option/Details
Campaign Setup & Configuration
Campaign Product advertising product, campaign WooCommerce product, ad credits product, campaign purchase product, advertising package, campaign billing product Select WooCommerce product for ad campaigns select
Options: All ad campaign products
Ad Campaigns type pricing model, billing method, campaign charging type, CPC vs CPM, pay-per-click, pay-per-impression, cost model, ad pricing structure Choose available campaign pricing models checkbox_multi
Options: Per click, Per views Default: Both selected
Placement & Visibility Options
Ad Campaigns placement ad locations, campaign positions, advertising zones, ad spots, banner placement, sponsored listing positions, ad display areas, campaign visibility zones Select where ads can be displayed checkbox_multi
Options: Home Page section, Search results, Sidebar widget Default: Home, Search, Sidebar, Location, Tag
Per-Click Pricing Configuration
Ad Campaigns price for Home Page home page CPC, homepage click cost, main page advertising rate, front page ad price, homepage campaign cost, home ad pricing Price per click for home page ads number
Ad Campaigns price for Search search results CPC, search page click cost, search advertising rate, SERP ad price, search results campaign cost Price per click for search results ads number
Ad Campaigns price for Sidebar sidebar CPC, widget area click cost, sidebar advertising rate, sidebar ad price, sidebar campaign cost Price per click for sidebar ads number
Per-View Pricing Configuration
Ad Campaigns price for Home per 1k views home page CPM, homepage impression cost, cost per thousand views, home page view rate, homepage CPM pricing, 1000 impressions cost Price per 1000 views for home page ads number
Ad Campaigns price for Search per 1k views search CPM, search impression cost, search results view rate, SERP CPM pricing, search page impression cost Price per 1000 views for search results ads number
Ad Campaigns price for Sidebar per 1k views sidebar CPM, sidebar impression cost, widget area view rate, sidebar CPM pricing, sidebar impression pricing Price per 1000 views for sidebar ads number