Adding a campaign

Note: This article is for an old version of OpenX.

The latest OpenX documentation can be found at the following URLs:

When you create an advertiser, the Add new campaign page opens. Alternatively, when adding a campaign to an existing advertiser, click the Add new campaign link in the Advertiser Properties > Campaign overview tab. All settings for a campaign are optional and can be changed at any time.

Basic information

If you do not enter a Name for the campaign, the campaign is given the name of the advertiser followed by "- Default".

Inventory details

In Inventory details, you can enter the number of ads to run, based on:

  • Impressions: The number of times an ad is displayed.
  • Clicks: The number of clicks on an ad.
  • Conversions: The number of times an ad impression or a click on an ad leads to a conversion, for example making a sale or a request for literature.
    To track when an ad view is converted, the administrator must enable conversion tracking in the My Account > Global Preferences tab.

    See also: the OpenX 2.6 Adminstrator Guide for information about global preferences.

Contract details

Under Contract details you can set start and end dates for the campaign and enter revenue information:

  • Select a (future) Activation date or tick the Activate this campaign immediately option.
  • Select an Expiration date (later than the start date) or tick the Don't expire this campaign on a specific date option.
  • Revenue information can be any of:
    • CPM is cost per thousand impressions
    • CPC is cost per click
    • CPA is the cost per acquisition (conversion)
    • Monthly tenancy is an agreed monthly fee

Priority information

Priority information influences the delivery of banners for a campaign. The options available depend on other settings for the campaign.

Priority levels can be:

  • Exclusive: these campaigns have delivery priority over all other campaigns. The only distribution option this allows is campaign weight. The greater the weight, the more likely that an impression will be delivered.
  • High priority: this is suitable for paid campaigns with set dates. OpenX attempts to deliver these impressions before delivering low priority campaigns. The priority level can be from 1 to 10. A campaign with Impressions booked and an Expiration date set can only be a high priority campaign with automatic distribution.
  • Low prioritycampaigns are for remnant inventory, and appliies only when there are no exclusive or high priority campaigns available. The only distribution option is to set the campaign weight. The greater the weight, the more likely it is that an impression will be delivered.

Distribution options are:

  • Automatic distribution delivers ads evenly over the remaining days in a campaign and is available only for campaigns with an end date and a set number of impressions, clicks or conversions.
  • You can set the number of impressions, clicks or conversions per day for high priority campaigns with no expiry date or with an unlimited number of impressions.Important: If the target number of impressions is zero, or the field is empty, the campaign is deactivated.
  • Campaign weight is the only way to influence distribution for exclusive and low priority campaigns. Weighting runs from 1 (lowest priority) to 10 (highest priority). Therefore, a campaign with a weight of 3 is three times more likely to be delivered than a campaign with a weight of 1.

The following table lists the options available for different combinations of settings.

Impressions, clicks or

conversions booked
Expiration date Priority level(s) Distribution
Set number Date set High Automatic
Set number Do not expire Exclusive, Low None
Set number Do not expire High Daily total
Unlimited Date set Exclusive, Low None
Unlimited Date set High Daily total
Unlimited Do not expire Exclusive, Low None
Unlimited Do not expire High Daily total

The Hide advertiser and websites option is useful, for example, when a publisher runs an ad at a 'blind' discount. Otherwise, the advertiser will never pay full price to advertise on that site again.

If you use iFrame tags with this setting, the advertiser cannot discover the site name from the referrer domain. See also: iFrame tags.

Tick the Companion positioning option to display only banners from the same campaign (simultaneously) on a page with multiple zones.

Delivery capping

You can place a cap (or limit) on the number of times a visitor sees a campaign. You can cap campaigns in two ways:

  • To cap the total number of times a visitor sees banners for this campaign, enter the number in the Limit zone views to: total field.
  • To cap the number of times a visitor sees banners for this campaign in a single session, enter the number in the Limit zone views to: per session field.

OpenX records the number of views with cookies, and you can reset the cookie after a specified period by setting it in the Reset view counters after: field. If a visitor has disabled cookies, banners in capped campaigns will not be delivered to that viewer. If a visitor deletes existing cookies, the cookie count is reset to zero, and the visitor will see banners in this campaign until the limits are again reached.

See also: Zone delivery capping and Banner delivery capping.

Click the Save changes button when you add or change campaign settings.