The Adzerk Developer Hub

Welcome to the Adzerk developer hub. You'll find comprehensive guides and documentation to help you start working with Adzerk as quickly as possible, as well as support if you get stuck. Let's jump right in!

Overview

A Zone is a placement that can include or exclude certain flights/creatives. This gives you the ability to specifically target some flights to a certain zone, but not to other spots.

Zones are not required. They are also not exclusive, and Zones placements can serve flights that are not targeted to zones.

Zones can alsobe used with multiple ad sizes. For example, you may create an "Above the Fold" zone that serves both 728x90 and 300x250 ad types

For a full list of Zone API endpoints, click here.

By default, flights/ads target all sites/zones

Using Zones

There are many ways to use zones. Below are just two examples:

  1. By spot on page: Create zones "Above the Fold" and "Below the Fold". Charge advertisers more for the "Above the Fold", higher-value spots.
  2. By content/audience of sub-pages: Create zones "Apple Product Reviews" and "Samsung Product Reviews". Make sure to exclude ads for Samsung products to the "Apple Product Review" zone.

Many API clients prefer using Keyword Targeting instead of Zone targeting, as you could pass, say, "Above_Fold" as a keyword to be targeted on.

Reporting on Zones

Adzerk records one impression per zone per placement. If a flight without zone targeting is served by a placement with multiple zones, we will only record the impression and click etc. for the first zone listed in the placement.

Creating a Zone with API

Please refer to our Create Zone endpoint.

Creating a Zone with UI

  1. Go to Inventory --> Sites
  2. Click on the three dots to the far right of a site
  3. Click 'Zones'
  4. Click 'Add a Zone to this Site'
  5. Add a Friendly Name
  6. Save

Adding Site/Zone Targeting - API

At the Flight level, use the SiteZoneTargeting object in Create Flight or Update Flight endpoint to specify targeting.

At the Ad level, use the siteID and zoneID parameters in the Create Ad or Update Ad endpoints.

Adding Site/Zone Targeting - UI

Refer to our Flight and Ad set-up instructions.

Network Zones

Network Zones can be created only through Campaign Management API, not the UI

Network zones are zones that can used across multiple sites.

This enables you to target a placement on multiple sites (such as a common above-the-fold placement) using the same zoneID.

To create, use the Create Zone endpoint, but do not specify a Siteid

To add to a flight:

  1. API - Use the Create Flight or Update Flights endpoints
  2. UI - Choose the network zone from the Site/Zone targeting dropdown. Network zones will be listed separately from site-specific zones.

The targeting will then become visible on the campaigns page underneath the name of the flight, listed after "NetworkZone".