This articles covers the Publisher side of the Epom Ad Server workflow, which consists of three interconnected entities:

  • Sites. This is the highest differentiation level for your ad serving, which will cover one of the sites where your ads are to be served.
  • Zones. This level allows you to group several ad Placements into logical sections and provide deeper targeting.
  • Placements. An ad Placement is a specific group of ad units. The ad placements tier can be as broad as all the ads placed on an entire website or as specific as a single ad unit.

Site

Please follow these steps to add a new site:

  1. Log into your Network Manager, Publisher, or Self-Serve Publisher account.
  2. Go to the Publishers tab and click the Add Site button.
  3. Fill out the Basic Information for your new site and click Save:
  • Name - a custom name that will help identify the Site.
  • On - identifies if the Site is enabled or not.
  • URL - site URL.
  • Email (optional) - contact email for this site.
  • Description (optional) - a couple words regarding this Site's details, notes, or any other information you would like to include.
  • Additional information (optional) - you can add general information that would help specify the site:
    • Monthly Impressions: how many ads are usually served on this Site per month.
    • Monthly Visitors: how many unique visitors attend this Site per month.

Once you have added a Site, the Site card will appear along with the following items:

note Permissions
Note!

The set of items on this page depends on the permissions for your account.


Revenue Share

In this pane you can set different shares for the Advertiser(s) of this Site:

note Revenue Share
Note!

If the Fixed Price payment model is set in the Pricing pane, the Revenue Share settings will be neglected.


Pricing

Here you can set the payment model for this Site:

Available pricing types are CPM (cost per mile), CPC (cost per click), or CPA (cost per action).

Sharing Settings

The Sharing Settings pane allows you to provide access to the Site to another user in your network:



Piggyback

In this pane you can insert the code for 3rd party tracking for the whole Site. Alternatively, you can enable 3rd party tracking only for certain Placements of the Site by enabling the corresponding pane on the Placement card. More information regarding the Piggyback Pixel tracking is available in the following support article.

Matched Ads

This pane displays Advertisers > Campaigns > Banners that can be linked to the Placements of the Site manually, and the ones that are linked according to Rules.

  • Advertisers, Campaigns and Banners can be filtered by Name, Label and/or Category.
  • It is possible to display the Banners that are linked manually or via Rules by selecting the corresponding checkboxes and clicking Filter.
  • Click the Advertiser/Campaign/Banner to navigate to the corresponding card.

Zone

A Zone is an interim entity that allows you to divide Placements on the same Site into groups with different settings, or designed for different areas of a multi-page website, etc.

Once the Site is created, click on the sidebar, or click the button. The following dialog will appear:

Fill in the Name, add a Description if necessary, and click Save.

Matched Ads

This pane displays Advertisers > Campaigns > Banners that can be linked to the Placements of the Zone manually, and the ones that are linked according to Rules.

  • Advertisers, Campaigns and Banners can be filtered by Name, Label and/or Category.
  • It is possible to display the Banners that are linked manually or via Rules by selecting the corresponding checkboxes and clicking Filter.
  • Click the Advertiser/Campaign/Banner to navigate to the corresponding card.

Placement

Ad Placement is a rotation pool of multiple ads which accepts all ad formats.

To add a Placement click the button and choose the Placement type you need. Alternatively, you can click the corresponding buttons on the side bar:

  • Site Placement;
  • Non-Standard Site Placement;
  • Mobile Site Placement;
  • Video Placement;
  • Application Placement.

The Create New Placement pane will be displayed. The set of parameters of the Placement depends on the Placement type. The following items might need to be specified:

  • Name: Custom name for the new Placement.
  • Description (optional): Any information regarding the Placement.
  • Default Code (optional): In case there is no Placement that would fit a certain user, the Default Code will be displayed. The Impression won't be counted towards Epom Analytics.
  • Size: Dimensions of the ad unit for the Placement.
  • Flexible Placement Size: This checkbox identifies if the Ad Units (Banners) that are smaller than the Placement size can be linked to the Placement.
  • Refresh after (seconds) (optional): Recalls the Placement after a given period of time. In this way multiple Banners can be shown (only for the iframe Invocation Codes).
  • 3rd Party Network Lookup Limit: This value identifies the maximum number of mobile ad serving networks that will be contacted to serve an ad.
  • Video Ad Formats: This value identifies when a Video Placement will be displayed: Pre-roll (before the video); Mid-roll (during the video at a specified time), Post-roll (after the video); Overlay (over the video).
  • Ova/Vast 3.0 Config: settings for the Skip Ad button behaviour.
  • Ad Category: Defines the type of ad unit for Application Placement.
  • Application OS: target platform of the application - iOS or Android.

Once you fill out the Placement details, click Save. You will be redirected to the Placement card, which contains the following panes:


Invocation codes | Direct URL | API

Depending on the Placement type you are using, there might be several ways to request the ad display from Epom:

  • Invocation codes (Iframe Sync, Iframe Async, Simple Iframe, JS Sync, JS Async).
  • Direct Ad Serving URL request.
  • API request.

The Settings area of this pane allows you to save the Channel or Custom Parameter values. This will allow you to apply the frequently used Channels and/or Parameters to the Invocation Codes of any Placement in your network in a matter of seconds instead of manually inserting those for each and every Placement.


Banners Probability


This pane displays the priority of the Banners' display with regard to the users' preferences such as Country, Browser, Operating System, or Priority.

Also, it is possible to block certain Advertisers, Campaigns, or Banners. To do so, select the entry from the list and choose the blocking method:

  • Block Advertiser for the Placement.
  • Block Advertiser for the current Site: Add a Pre-targeting on Site level, that blocks the Advertiser.
  • Block Advertiser for all Sites: Add a Pre-targeting on all Sites in your network, where the Advertiser was linked, that blocks the Advertiser completely.
  • Block Campaign for the Placement.
  • Block Campaign for the current Site: Add a Pre-targeting on Site level, that blocks the Campaign.
  • Block Campaign for all Sites: Add a Pre-targeting on all Sites in your network, where the Campaign was linked, that blocks the Campaign completely.
  • Block Banner for the Placement.
  • Block Banner for the current Site: Add a Pre-targeting on Site level, that blocks the Banner.
  • Block Banner for all Sites: Add a Pre-targeting on all Sites in your network, where the Banner was linked, that blocks the Banner completely.
note Block
Note!

Please be cautious when blocking Advertisers, Campaigns, or Banners on All Sites. This will block the Advertiser, Campaign, or Banner on each and every Site in your network where the Advertiser was linked, thus prohibiting any ad serving activity.



Banners

Includes all the Banners connected to the Placement in question.


Daisy Chaining

In this pane you can set the Daisy Chaining or Waterfall Chaining of the banners connected to this Placement.


Placement Capping

Placement Capping pane allows setting a limit for the number of Actions, Clicks, and/or Impressions during a certain period of time. Flat option defines whether the Impressions, Clicks, or Actions should be evenly distributed during the defined timeframe.


Matched Ads

This pane displays Advertisers > Campaigns > Banners that can be linked to the Placement manually, and the ones that are linked according to Rules.

  • Advertisers, Campaigns and Banners can be filtered by Name, Label and/or Category.
  • It is possible to display the Banners that are linked manually or via Rules by selecting the corresponding checkboxes and clicking Filter.
  • Click the Advertiser/Campaign/Banner to navigate to the corresponding card.


Pricing

In this pane you can set the Pricing for the Placement in question.

note Revenue Share
Note!

Placement level Pricing will override the Site level Pricing in case both are set.



Revenue Share

In this pane you can set different shares for the Advertiser(s) for this Placement:

note Revenue Share
Note!

If the Fixed Price payment model is set in the Pricing pane, the Revenue Share settings will be neglected.



Piggyback

In this pane you can insert the code for 3rd party tracking for the Placement. More information regarding the Piggyback Pixel tracking is available in the following article.


Vast Events (Video Placements)

VAST Events pane includes available video events: just select the items you need for the current Placement and click Save:

  • AD START - Video ad or overlay display started.
  • AD FIRST QUARTILE - 25% of the Video ad was viewed.
  • AD MID POINT - 50% of the Video ad was viewed.
  • AD THIRD QUARTILE - 75% of the Video ad was viewed.
  • AD COMPLETE - Video ad or overlay display completed.
  • AD PAUSE - Video ad display paused.
  • AD RESUME - Video ad display resumed after a pause.
  • AD CREATIVE VIEW - a creative element was displayed.
  • AD MUTE - Video ad was muted.
  • AD UNMUTE - Video ad was unmuted.
  • AD FULLSCREEN - Video ad full-screen mode was toggled.
  • AD EXIT FULLSCREEN - Video ad full screen was exited.
  • AD EXPAND - Video ad was switched to the expanded view mode.
  • AD COLLAPSE - User exited the expanded view mode.
  • AD SKIP TRACKING - User skipped the Video Ad.

Selected events will be tracked in Epom Analytics if they are selected either for the Placement, or for the linked Video Banner.


3rd Party Vast Tracking (Video Placements)

To track Impressions, Actions, and/or Events with third-party ad servers, fill in the Tracking URL, choose Tracking Type and click :


Tips and tricks

  1. You can filter your network's Sites by Share Type and Category using the corresponding drop-down lists:
  2. You can copy existing Zones to other Sites in a simple way: just drag-n-drop the corresponding item from one Site to another. A confirmation dialog will appear:
  3. Selecting the 'Keep placement(s) linked' checkbox will also clone all the Placements of the Zone along with the linked Banners. Click Copy and enter the number of copies you'd like to make. You will receive a confirmation once all the items are copied.

  4. Every Site, Zone and Placement has it's own ID. In case if you need to know the IDs of certain entities, just go to the Preferences tab, select the corresponding checkboxes and click Submit:
  5. A re-login might be needed for the changes to take effect.



Need more help?

Should you require any additional help with our solutions, do not hesitate to contact Epom technical support at support@epom.com. Our support managers are dedicated to resolving any issues and providing you with solutions and support if you face difficulties or have questions.