Ad

What is an ad?

An ad a combination of a placement and template. This is where the bulk of configuration is done. For example, parting, capping, geotargeting, custom targeting and more.

Creating an ad

Select an advertiser

Select a placement

Overriding of pricing can be done here.

Select a template

Only templates that have been linked to the selected placement will be available at this stage.

Select styles

Select the styles this ad should be served in. The list of styles to chose from depend on the selected template in the previous step.

Locales

Choose the locales this ad can be offered in. Ads will always have a default locale. When creating creatives, the corresponding locales will be available to populate.

Scheduling

Start time, end time and pacing

Pacing options are asap or evenly. When evenly is selected, a start and end time must be present

Capping (optional)

Event Capping: Cap clicks or impressions per day or over the lifetime of the ad.
Budget Capping: Cap spending based on a daily or lifetime limit.
Frequency Capping: Cap how often an ad will be shown to the same user. Eg: Show the ad 3 times per day.

For frequency capping to work, it is required that your application sends a unique identifier per user. This identifier does not need to include personal information, but it must be a stable reference.

Priority

Apply a prioity to the ad (Standard, Sponsorship or House).
Apply a weight to the ad (Higher meaning more weight).

This can be used to prioritize one ad over another ad. If there are two possible candidates when requesting an ad, the ad with a higher priority will be shown.

Parting (optional)

Select the days and times the ad should be available to serve. Eg: All weekend, weekdays in the mornings etc.

By default, the timezone used will be the timezone of the end user. However you may want to set a specific timezone for your ads to be shown in. For example: A worldwide event like the Superbowl

Geotargeting (optional)

Select cities or countries you want to serve this ad in. In order for this function to work the ad request must contain one of the following:

User's IP address, which will be used to determine the approximate location.

Geoname ID, if the approximate location is already known by the publisher, the geoname ID can be sent directly, omitting the IP address. Eg: For targeting in Germany, 2921044 could be sent.

Must satisfy ANY of the geonames ids. Ads without geo targeting are always eligibles.

Location Targeting (optional)

For more granular location targeting, radii can be created via latitude, longitude and a radius values. When an ad request contains targeting.location that falls within one of the radii, the ad will be eligible to be served.

Must satisfy ANY of the coordinates. Ads without location targeting are always eligible.

Custom Targeting (optional)

Create custom targeting parameters. When targeting.custom contains values matching the custom targeting, the ad will be eligible to be served.

Must satisfy ALL of the key values. Ads without custom targeting are always eligible.

Ad

What is an ad?#

Creating an ad#

What is an ad?

Creating an ad